Upgrade a Seafile cluster from 12.0 to 13.0¶

Step 1) Stop the services¶

Before upgrading, please shutdown you Seafile server

docker compose down

Step 2) Download the newest `seafile-server.yml` file¶

Before downloading the newest seafile-server.yml, please backup your original one:

mv seafile-server.yml seafile-server.yml.bak

Then download the new seafile-server.yml according to the following commands:

wget https://manual.seafile.com/13.0/repo/docker/cluster/seafile-server.yml

Step 3) Modify `.env`, update image version and some configurations¶

Step 3.1) Update image version to Seafile 13¶

SEAFILE_IMAGE=seafileltd/seafile-pro-mc:13.0-latest

Step 3.2) Add configurations for cache¶

From Seafile 13, the configurations of cache can be set via environment variables directly (you can define it in the .env). What's more, the Redis will be recommended as the primary cache server for supporting some new features (please refer the upgrade notes, you can also refer to more details about Redis in Seafile Docker here).

RedisMemcached

## Cache
CACHE_PROVIDER=redis

### Redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=

## Cache
CACHE_PROVIDER=memcached

### Memcached
MEMCACHED_HOST=memcached
MEMCACHED_PORT=11211

Step 3.3) Add configurations for database¶

SEAFILE_MYSQL_DB_HOST=db
SEAFILE_MYSQL_DB_USER=seafile
SEAFILE_MYSQL_DB_PASSWORD=PASSWORD
SEAFILE_MYSQL_DB_CCNET_DB_NAME=ccnet_db
SEAFILE_MYSQL_DB_SEAFILE_DB_NAME=seafile_db
SEAFILE_MYSQL_DB_SEAHUB_DB_NAME=seahub_db

Step 3.4) Add configurations for storage backend¶

Seafile 13.0 add a new environment SEAF_SERVER_STORAGE_TYPE to determine the storage backend of seaf-server component. You can delete the variable or set it to empty (SEAF_SERVER_STORAGE_TYPE=) to use the old way, i.e., determining the storage backend from seafile.conf.

Local disk (default)S3 backendMultiple storage backendsUse the configuration in seafile.conf

Set SEAF_SERVER_STORAGE_TYPE to disk (default value):

SEAF_SERVER_STORAGE_TYPE=disk

Set SEAF_SERVER_STORAGE_TYPE to s3, and add your s3 configurations:

SEAF_SERVER_STORAGE_TYPE=s3

S3_COMMIT_BUCKET=<your commit bucket name>
S3_FS_BUCKET=<your fs bucket name>
S3_BLOCK_BUCKET=<your block bucket name>
S3_KEY_ID=<your-key-id>
S3_SECRET_KEY=<your-secret-key>
S3_USE_V4_SIGNATURE=true
S3_PATH_STYLE_REQUEST=false
S3_AWS_REGION=us-east-1
S3_HOST=
S3_USE_HTTPS=true
S3_SSE_C_KEY=

Set SEAF_SERVER_STORAGE_TYPE to multiple. In this case, you don't need to change the storage configuration in seafile.conf.

SEAF_SERVER_STORAGE_TYPE=multiple

If you would like to use the storage configuration in seafile.conf, please remove default value of SEAF_SERVER_STORAGE_TYPE in .env:

SEAF_SERVER_STORAGE_TYPE=

Step 4) Remove obsolete configurations¶

Although the configurations in environment (i.e., .env) have higher priority than the configurations in config files, we recommend that you remove or modify the cache configuration in the following files to avoid ambiguity:

Backup the old configuration files:

cp /opt/seafile/shared/seafile/conf/seafile.conf /opt/seafile/shared/seafile/conf/seafile.conf.bak
cp /opt/seafile/shared/seafile/conf/seahub_settings.py /opt/seafile/shared/seafile/conf/seahub_settings.py.bak

Clean up redundant configuration items in the configuration files:
- Open /opt/seafile/shared/seafile/conf/seafile.conf and remove the entire [memcached], [database], [commit_object_backend], [fs_object_backend], [notification] and [block_backend] if above sections have correctly specified in .env.
- Open /opt/seafile/shared/seafile/conf/seahub_settings.py and remove the entire blocks for DATABASES = {...} and CAHCES = {...}
In the most cases, the seafile.conf only include the listen port 8082 of Seafile file server.

Step 5) Start the Seafile in a node¶

Note

According to this upgrade document, a frontend service will be started here. If you plan to use this node as a backend node, you need to modify this item in .env and set it to backend:

CLUSTER_MODE=backend

docker compose up -d

Step 6) Upgrade Seafile¶

docker exec -it seafile bash
# enter the container `seafile`

# stop servers
cd /opt/seafile/seafile-server-latest
./seafile.sh stop
./seahub.sh stop

# upgrade seafile
cd upgrade
./upgrade_12.0_13.0.sh

Success

After upgrading the Seafile, you can see the following messages in your console:

Updating seafile/seahub database ...

[INFO] You are using MySQL
[INFO] updating seafile database...
[INFO] updating seahub database...
[INFO] updating seafevents database...
Done

migrating avatars ...

Done

updating /opt/seafile/seafile-server-latest symbolic link to /opt/seafile/seafile-pro-server-13.0.11 ...



-----------------------------------------------------------------
Upgraded your seafile server successfully.
-----------------------------------------------------------------

Then you can exit the container by exit

Step 7) Restart current node¶

docker compose down
docker compose up -d

Tip

You can use docker logs -f seafile to check whether the current node service is running normally

Step 8) Operations for other nodes¶

Download the newest seafile-sever.yml file and modify .env similar to the first node (for backend node, you should set CLUSTER_MODE=backend)
Start the Seafile server:
```
docker compose up -d
```