From 8b2099ef2dee042b2cd9dbe59e9233b37739f082 Mon Sep 17 00:00:00 2001
From: skywalker <dzmbbs@qq.com>
Date: Wed, 6 Sep 2023 18:31:11 +0800
Subject: [PATCH] upgrade_a_cluster_docker

---
 manual/upgrade/upgrade_a_cluster_docker.md | 35 ++++++++++++++++++++++
 mkdocs.yml                                 |  1 +
 2 files changed, 36 insertions(+)
 create mode 100644 manual/upgrade/upgrade_a_cluster_docker.md

diff --git a/manual/upgrade/upgrade_a_cluster_docker.md b/manual/upgrade/upgrade_a_cluster_docker.md
new file mode 100644
index 00000000..51a00432
--- /dev/null
+++ b/manual/upgrade/upgrade_a_cluster_docker.md
@@ -0,0 +1,35 @@
+# Upgrade a Seafile cluster (Docker)
+
+## Major and minor version upgrade
+
+Seafile adds new features in major and minor versions. It is likely that some database tables need to be modified or the search index need to be updated. In general, upgrading a cluster contains the following steps:
+
+1. Update Seafile image
+2. Upgrade the database
+3. Update configuration files at each node
+4. Update search index in the backend node
+
+In general, to upgrade a cluster, you need:
+
+1. Download the new image, stop the old docker container, modify the Seafile image version in docker-compose.yml to the new version. Start with docker-compose up.
+2. Run the upgrade script in container (for example, /opt/seafile/seafile-server-latest/upgrade/upgrade_10_0_11_0.sh) in one frontend node
+3. Update configuration files at each node according to the documentation for each version
+4. Delete old search index in the backend node if needed
+
+## Maintanence upgrade
+
+Maintanence upgrade only needs to download the new image, stop the old docker container, modify the Seafile image version in docker-compose.yml to the new version. Start with docker-compose up.
+
+## Upgrade from 10.0 to 11.0
+
+Migrate your configuration for LDAP and OAuth according to <https://manual.seafile.com/upgrade/upgrade_notes_for_11.0.x>
+
+## Upgrade from 9.0 to 10.0
+
+If you are using with ElasticSearch, SAML SSO and storage backend features, follow the upgrading manual on how to update the configuration for these features: <https://manual.seafile.com/upgrade/upgrade_notes_for_10.0.x>
+
+If you want to use the new notification server and rate control (pro edition only), please refer to the upgrading manual: <https://manual.seafile.com/upgrade/upgrade_notes_for_10.0.x>
+
+## Upgrade from 8.0 to 9.0
+
+If you are using with ElasticSearch, follow the upgrading manual on how to update the configuration: <https://manual.seafile.com/upgrade/upgrade_notes_for_9.0.x>
diff --git a/mkdocs.yml b/mkdocs.yml
index 134c0200..11e1cc3a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -155,6 +155,7 @@ nav:
     - Outline: upgrade/upgrade.md
     - Upgrade Seafile Docker: upgrade/upgrade_docker.md
     - Upgrade Seafile Cluster: upgrade/upgrade_a_cluster.md
+    - Upgrade Seafile Cluster (Docker): upgrade/upgrade_a_cluster_docker.md
     - Upgrade notes for 7.0.x: upgrade/upgrade_notes_for_7.0.x.md
     - Upgrade notes for 7.1.x: upgrade/upgrade_notes_for_7.1.x.md
     - Upgrade notes for 8.0.x: upgrade/upgrade_notes_for_8.0.x.md