Setup With Ceph

Note: Since Seafile Server 5.0.0, all config files are moved to the central conf folder. Read More.

Ceph is a scalable distributed storage system. Seafile can use Ceph’s RADOS object storage layer for storage backend.

Copy ceph conf file and client keyring

Seafile acts as a client to Ceph/RADOS, so it needs to access ceph cluster’s conf file and keyring. You have to copy these files from a ceph admin node’s /etc/ceph directory to the seafile machine.

  1. seafile-machine# sudo scp user@ceph-admin-node:/etc/ceph/ /etc

Install and enable memcached

For best performance, Seafile requires install memcached and enable memcache for objects.

We recommend to allocate 128MB memory for memcached. Edit /etc/memcached.conf

  1. # Start with a cap of 64 megs of memory. It's reasonable, and the daemon default
  2. # Note that the daemon will grow to this size, but does not start out holding this much
  3. # memory
  4. # -m 64
  5. -m 128

Install Python Ceph Library

File search and WebDAV functions rely on Python Ceph library installed in the system.

On Debian/Ubuntu:

  1. sudo apt-get install python-ceph

On RedHat/CentOS:

  1. sudo yum install python-rados

Edit seafile configuration

Edit seafile.conf, add the following lines:

  1. [block_backend]
  2. name = ceph
  3. ceph_config = /etc/ceph/ceph.conf
  4. pool = seafile-blocks
  5. memcached_options = --SERVER=localhost --POOL-MIN=10 --POOL-MAX=100
  7. [commit_object_backend]
  8. name = ceph
  9. ceph_config = /etc/ceph/ceph.conf
  10. pool = seafile-commits
  11. memcached_options = --SERVER=localhost --POOL-MIN=10 --POOL-MAX=100
  13. [fs_object_backend]
  14. name = ceph
  15. ceph_config = /etc/ceph/ceph.conf
  16. pool = seafile-fs
  17. memcached_options = --SERVER=localhost --POOL-MIN=10 --POOL-MAX=100

It’s recommended to create separate pools for commit, fs, and block objects.

  1. ceph-admin-node# rados mkpool seafile-blocks
  2. ceph-admin-node# rados mkpool seafile-commits
  3. ceph-admin-node# rados mkpool seafile-fs

Using memcached cluster

In a cluster environment, you may want to use a memcached cluster. In the above configuration, you have to specify all the memcached server node addresses in seafile.conf

  1. memcached_options = --SERVER=192.168.1.134 --SERVER=192.168.1.135 --SERVER=192.168.1.136 --POOL-MIN=10 --POOL-MAX=100 --RETRY-TIMEOUT=3600

Notice that there is a --RETRY-TIMEOUT=3600 option in the above config. This option is important for dealing with memcached server failures. After a memcached server in the cluster fails, Seafile server will stop trying to use it for “RETRY-TIMEOUT” (in seconds). You should set this timeout to relatively long time, to prevent Seafile from retrying the failed server frequently, which may lead to frequent request errors for the clients.

Notes for Ubuntu 16.04

Since version 5.1.0 version, we upgraded the bundled Ceph rados library to 0.94.6. On Ubuntu 16.04, this causes some incompatibility. To work around this issue, you have to install librados 0.94.6 in the Ubuntu system (from Ceph’s official repositories) and let Seafile use the library from system. To do this, you have to remove a few bundled libraries:

  1. cd seafile-server-latest/seafile/lib
  2. rm librados.so.2 libstdc++.so.6 libnspr4.so

Use arbitary Ceph user

The above configuration will use the default (client.admin) user to connect to Ceph.
You may want to use some other Ceph user to connect. This is supported in Seafile.
To specify the Ceph user, you have to add a ceph_client_id option to seafile.conf, as the following:

  1. [block_backend]
  2. name = ceph
  3. ceph_config = /etc/ceph/ceph.conf
  4. # Sepcify Ceph user for Seafile here
  5. ceph_client_id = seafile
  6. pool = seafile-blocks
  7. memcached_options = --SERVER=localhost --POOL-MIN=10 --POOL-MAX=100
  9. [commit_object_backend]
  10. name = ceph
  11. ceph_config = /etc/ceph/ceph.conf
  12. # Sepcify Ceph user for Seafile here
  13. ceph_client_id = seafile
  14. pool = seafile-commits
  15. memcached_options = --SERVER=localhost --POOL-MIN=10 --POOL-MAX=100
  17. [fs_object_backend]
  18. name = ceph
  19. ceph_config = /etc/ceph/ceph.conf
  20. # Sepcify Ceph user for Seafile here
  21. ceph_client_id = seafile
  22. pool = seafile-fs
  23. memcached_options = --SERVER=localhost --POOL-MIN=10 --POOL-MAX=100

You can create a ceph user for seafile on your ceph cluster like this:

  1. ceph auth add client.seafile \
  2.   mds 'allow' \
  3.   mon 'allow r' \
  4.   osd 'allow rwx pool=seafile-blocks, allow rwx pool=seafile-commits, allow rwx pool=seafile-fs'

You also have to add this user’s keyring path to /etc/ceph/ceph.conf:

  1. [client.seafile]
  2. keyring = <path to user's keyring file>