From c2000ba4acae0f26f384d1442f0d67d1b81e7f85 Mon Sep 17 00:00:00 2001 From: Carla Schroder Date: Tue, 2 Jun 2015 14:53:08 -0700 Subject: [PATCH] add note re using redis with file locking app --- .../files_locking_enabling.rst | 29 +++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/admin_manual/configuration_files/files_locking_enabling.rst b/admin_manual/configuration_files/files_locking_enabling.rst index 3a353b6f9..195c20a0b 100644 --- a/admin_manual/configuration_files/files_locking_enabling.rst +++ b/admin_manual/configuration_files/files_locking_enabling.rst @@ -1,5 +1,6 @@ +=========================== Using the Files Locking App ---------------------------- +=========================== The Files Locking application enables ownCloud to lock files while reading or writing to and from backend storage. The purpose of the app is to avoid file @@ -16,4 +17,28 @@ underlying filesystem. The Files Locking app has no configuration options; all you need to do is enable or disable it on your Apps page. -.. figure:: ../images/files_locking_app.png \ No newline at end of file +.. figure:: ../images/files_locking_app.png + +We recommend using `Redis `_ as your ownCloud memcache when +you enable the Files Locking app. Memcached, the popular distributed memory +caching system, is not suitable for a file locking app because it is designed +to improve dynamic Web site performance. It is not designed to store locks, and +data can disappear from the cache at any time. Redis is more than an object +cache like Memcached; it is also a key-value store, so it guarantees that +cached objects are available for as long as they are needed. Redis is available +on most Linux distributions, and requires a simple configuration in your +``config.php`` file, like this example:: + + 'memcache.local' => '\OC\Memcache\redis', + 'redis' => array( + 'host' => 'localhost', + // can also be a unix domain socket: + '/tmp/redis.sock' + 'port' => 6379, + 'timeout' => 0.0, + // Optional, if undefined SELECT will not run and will use Redis + // Server's default DB Index. + 'dbindex' => 0, + ), + +See ``config.sample.php`` to see configuration examples for all memcaches.