Upgrade a Seafile cluster

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. Upgrade the database
  2. Update symbolic link at frontend and backend nodes to point to the newest version
  3. Update configuration files at each node
  4. Update search index in the backend node

In general, to upgrade a cluster, you need:

  1. Run the upgrade script (for example, ./upgrade/upgrade_4_0_4_1.sh) in one frontend node
  2. Run the minor upgrade script (./upgrade/minor_upgrade.sh) in all other nodes to update symbolic link
  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

Doing maintanence upgrading is simple, you only need to run the script ./upgrade/minor_upgrade.sh at each node to update the symbolic link.

Specific instructions for each version

From 6.2 to 6.3

In version 6.2.11, the included Django was upgraded. The memcached configuration needed to be upgraded if you were using a cluster. If you upgrade from a version below 6.1.11, don't forget to change your memcache configuration. If the configuration in your seahub_settings.py is:

    'default': {
        'BACKEND': 'django_pylibmc.memcached.PyLibMCCache',
        'LOCATION': '<MEMCACHED SERVER IP>:11211',

COMPRESS_CACHE_BACKEND = 'django.core.cache.backends.locmem.LocMemCache'

Now you need to change to:

    'default': {
        'BACKEND': 'django_pylibmc.memcached.PyLibMCCache',
        'LOCATION': '<MEMCACHED SERVER IP>:11211',
    'locmem': {
        'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',

From 6.1 to 6.2

No special upgrade operations.

From 6.0 to 6.1

In version 6.1, we upgraded the included ElasticSearch server. The old server listen on port 9500, new server listen on port 9200. Please change your firewall settings.

From 5.1 to 6.0

In version 6.0, the folder download mechanism has been updated. This requires that, in a cluster deployment, seafile-data/httptemp folder must be in an NFS share. You can make this folder a symlink to the NFS share.

cd /data/haiwen/
ln -s /nfs-share/seafile-httptemp seafile-data/httptemp

The httptemp folder only contains temp files for downloading/uploading file on web UI. So there is no reliability requirement for the NFS share. You can export it from any node in the cluster.

From v5.0 to v5.1

Because Django is upgraded to 1.8, the COMPRESS_CACHE_BACKEND should be changed

   -    COMPRESS_CACHE_BACKEND = 'locmem://'
   +    COMPRESS_CACHE_BACKEND = 'django.core.cache.backends.locmem.LocMemCache'

From v4.4 to v5.0

v5.0 introduces some database schema change, and all configuration files (ccnet.conf, seafile.conf, seafevents.conf, seahub_settings.py) are moved to a central config directory.

Perform the following steps to upgrade:

  • Run the upgrade script at one fronend node to upgrade the database.
  • Then, on all other frontend nodes and the background node, run the upgrade script with SEAFILE_SKIP_DB_UPGRADE environmental variable turned on:
    SEAFILE_SKIP_DB_UPGRADE=1 ./upgrade/upgrade_4.4_5.0.sh

After the upgrade, you should see the configuration files has been moved to the conf/ folder.

  |__ ccnet.conf
  |__ seafile.conf
  |__ seafevent.conf
  |__ seafdav.conf
  |__ seahub_settings.conf

From v4.3 to v4.4

There are no database and search index upgrade from v4.3 to v4.4. Perform the following steps to upgrade:

  1. Run the minor upgrade script at frontend and backend nodes

From v4.2 to v4.3

v4.3 contains no database table change from v4.2. But the old search index will be deleted and regenerated.

A new option COMPRESS_CACHE_BACKEND = 'django.core.cache.backends.locmem.LocMemCache' should be added to seahub_settings.py

The secret key in seahub_settings.py need to be regenerated, the old secret key lack enough randomness.

Perform the following steps to upgrade:

  1. Run the upgrade script at one fronend node to modify the seahub_settings.py
  2. Modify seahub_settings.py at each node, replacing the old secret key with the new one and add option COMPRESS_CACHE_BACKEND
  3. Run the minor upgrade script at frontend and backend nodes
  4. Delete the old search index (the folder pro-data/search) at the backend node
  5. Delete the old office preview output folder (/tmp/seafile-office-output) at the backend node

results matching ""

    No results matching ""