diff options
| author | Morris Jobke <hey@morrisjobke.de> | 2017-05-11 17:59:09 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-05-11 17:59:09 -0500 |
| commit | f0790bfad76c9fbae0fdfa4c0cfd566604e5d57d (patch) | |
| tree | 45a614913dce189abdc5eb7c35dd08f2cca0f368 | |
| parent | d83f1d96d4541e8e5a686be94b9c03ebb31f5f76 (diff) | |
| parent | 8a05d22be796ff646df3f74196cc13bb422e66e4 (diff) | |
| download | nextcloud-server-f0790bfad76c9fbae0fdfa4c0cfd566604e5d57d.tar.gz nextcloud-server-f0790bfad76c9fbae0fdfa4c0cfd566604e5d57d.zip | |
Merge pull request #4821 from nextcloud/update-redis-cluster-documentation
Update redis cluster documentation
| -rw-r--r-- | config/config.sample.php | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/config/config.sample.php b/config/config.sample.php index 002f47649bc..2bafbd411c9 100644 --- a/config/config.sample.php +++ b/config/config.sample.php @@ -1062,8 +1062,16 @@ $CONFIG = array( * * Available failover modes: * - \RedisCluster::FAILOVER_NONE - only send commands to master nodes (default) - * - \RedisCluster::FAILOVER_ERROR - failover to slaves for read commands if master is unavailable + * - \RedisCluster::FAILOVER_ERROR - failover to slaves for read commands if master is unavailable (recommended) * - \RedisCluster::FAILOVER_DISTRIBUTE - randomly distribute read commands across master and slaves + * + * WARNING: FAILOVER_DISTRIBUTE is a not recommended setting and we strongly + * suggest to not use it if you use Redis for file locking. Due to the way Redis + * is synchronised it could happen, that the read for an existing lock is + * scheduled to a slave that is not fully synchronised with the connected master + * which then causes a FileLocked exception. + * + * See https://redis.io/topics/cluster-spec for details about the Redis cluster */ 'redis.cluster' => [ 'seeds' => [ // provide some/all of the cluster servers to bootstrap discovery, port required @@ -1072,7 +1080,7 @@ $CONFIG = array( ], 'timeout' => 0.0, 'read_timeout' => 0.0, - 'failover_mode' => \RedisCluster::FAILOVER_DISTRIBUTE + 'failover_mode' => \RedisCluster::FAILOVER_ERROR ], |