From 7f659b71e0cad0ef26361febe5943c28299bcfe2 Mon Sep 17 00:00:00 2001 From: RealRancor Date: Fri, 2 Oct 2015 13:14:45 +0200 Subject: [PATCH] Some additions to caching docs. --- .../caching_configuration.rst | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index 154c49718..a0f3d9ce6 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -32,7 +32,7 @@ of memcache that best fits your needs. The supported caching backends are: A local cache for systems running PHP 5.5 and up, APCu 4.06 or better required. * `Memcached `_ Distributed cache for multi-server ownCloud installations. -* `Redis `_ +* `Redis `_, PHP module 2.2.5 or better required. For distributed caching, and required for Transactional File Locking. These are supported but not recommended: @@ -42,7 +42,8 @@ These are supported but not recommended: Memcaches must be explicitly configured in ownCloud 8.1 and up by installing and enabling your desired cache, and then adding the appropriate entry to -``config.php``. +``config.php`` (See :doc:`config_sample_php_parameters` for an overview of +all possible config parameters). You may use both a local and a distributed cache. Recommended caches are APCu and Redis. After installing and enabling your chosen memcache, verify that it is @@ -76,6 +77,8 @@ Linux distributions. On Red Hat/CentOS/Fedora systems running PHP 5.5 and up install ``php-pecl-apcu``. On Debian/Ubuntu/Mint systems install ``php5-apcu``. Then restart your Web server. +The version of APCu must be 4.0.6 or better. + After restarting your Web server, add this line to your ``config.php`` file:: 'memcache.local' => '\OC\Memcache\APCu', @@ -103,9 +106,9 @@ Memcached Memcached is a reliable oldtimer for shared caching on distributed servers, and performs well with ownCloud with one exception: it is not suitable to use -with :doc:`Transactional File Locking <../configuration_files/files_locking_transactional>` because it does not -store locks, and data can disappear from the cache at any time (Redis is -the best for this). +with :doc:`Transactional File Locking <../configuration_files/files_locking_transactional>` +because it does not store locks, and data can disappear from the cache at any time +(Redis is the best for this). Setting up Memcached is easy. On Debian/Ubuntu/Mint install ``memcached`` and ``php5-memcached``. The installer will automatically start ``memcached`` and @@ -176,5 +179,5 @@ Cache Directory Location ------------------------ The cache directory defaults to ``data/$user/cache`` where ``$user`` is the -current user. You may use the ``'cache_path'`` directive in ``config.php`` to -select a different location. +current user. You may use the ``'cache_path'`` directive in ``config.php`` +(See :doc:`config_sample_php_parameters`) to select a different location.