From 2214d473e4a5690d88965846c5f4543ab6d8645b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Fri, 15 Jul 2022 14:04:54 +0200 Subject: [PATCH 1/7] Improve readability and completedness for Redis MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - give more complete examples for Redis config - use separate sections for the different connection types (TCP, TLS, socket) Signed-off-by: Martin Rüegg --- .../caching_configuration.rst | 155 +++++++++++++----- 1 file changed, 117 insertions(+), 38 deletions(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index f71703c0b..858e945fd 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -87,32 +87,120 @@ You can verify that the Redis daemon is running with ``ps ax``:: 22203 ? Ssl 0:00 /usr/bin/redis-server 127.0.0.1:6379 Restart your Web server, add the appropriate entries to your ``config.php``, and -refresh your Nextcloud admin page. This example ``config.php`` configuration uses -Redis for the distributed server cache:: +refresh your Nextcloud admin page. - 'memcache.distributed' => '\OC\Memcache\Redis', - 'redis' => [ - 'host' => 'redis-host.example.com', - 'port' => 6379, - ], +Redis configuration in Nextcloud (config.php) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ For best performance, use Redis for file locking by adding this:: 'memcache.locking' => '\OC\Memcache\Redis', +Further more, you can use Redis for the distributed server cache:: + + 'memcache.distributed' => '\OC\Memcache\Redis', + +Additionally, you can use Redis for the local cache like so:: + + 'memcache.local' => '\OC\Memcache\Redis', + +When using Redis for any of the above cache settings, you also need to +specify either the ``redis`` or ``redis.cluster`` configuration in ``config.php``. + +The following options are available to configure when using a single redis server (all but ``host`` and ``port`` are optional. For the latter two see next sections):: + + 'memcache.locking' => '\OC\Memcache\Redis', + 'memcache.distributed' => '\OC\Memcache\Redis', + 'memcache.local' =>'\OC\Memcache\Redis' , + 'redis' => [ + // 'host' => see connection parameters below + // 'port' => see connection parameters below + 'user' => 'nextcloud', + 'password' => 'password', + 'dbindex' => 0, + 'timeout' => 1.5, + 'read_timeout' => 1.5, + ] + +The following options are available to configure when using a redis cluster (all but ``seeds`` are optional):: + + 'memcache.locking' => '\OC\Memcache\Redis', + 'memcache.distributed' => '\OC\Memcache\Redis', + 'memcache.local' =>'\OC\Memcache\Redis' , + 'redis.cluster' => [ + 'seeds' => [ // provide some/all of the cluster servers to bootstrap discovery, port required + 'cache-cluster:7000', + 'cache-cluster:7001', + 'cache-cluster:7002', + 'cache-cluster:7003', + 'cache-cluster:7004', + 'cache-cluster:7005' + ], + 'failover_mode' => \RedisCluster::FAILOVER_ERROR + 'timeout' => 0.0, + 'read_timeout' => 0.0, + 'user' => 'nextcloud', + 'password' => 'password', + 'dbindex' => 0, + ] + + +Connecting to Single Redis Server over TCP +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To connect to a remote or local Redis server over TCP use:: + + 'redis' => [ + 'host' => 'redis-host.example.com', + 'port' => 6379, + ], + + +Connecting to single Redis server over TLS +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +To connect via TCP over TLS, add the following configuration:: + + 'redis' => [ + 'host' => 'tls://127.0.0.1', + 'port' => 6379, + 'ssl_context' => [ + 'local_cert' => '/certs/redis.crt', + 'local_pk' => '/certs/redis.key', + 'cafile' => '/certs/ca.crt', + 'verify_peer_name' => false + ] + ] + + +Connecting to Redis cluster over TLS +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +To connect via TCP over TLS, add the following configuration:: + + 'redis.cluster' => [ + 'seeds' => [ // provide some/all of the cluster servers to bootstrap discovery, port required + 'cache-cluster:7000', + 'cache-cluster:7001', + ], + 'ssl_context' => [ + 'local_cert' => '/certs/redis.crt', + 'local_pk' => '/certs/redis.key', + 'cafile' => '/certs/ca.crt', + 'verify_peer_name' => false + ] + ] + + +Connecting to single Redis server over UNIX socket +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + If you want to connect to Redis configured to listen on an Unix socket (which is recommended if Redis is running on the same system as Nextcloud) use this example ``config.php`` configuration:: - 'memcache.local' => '\OC\Memcache\APCu', - 'memcache.distributed' => '\OC\Memcache\Redis', - 'redis' => [ - 'host' => '/run/redis/redis-server.sock', - 'port' => 0, - 'dbindex' => 0, - 'password' => 'secret', - 'timeout' => 1.5, - ], + 'redis' => [ + 'host' => '/run/redis/redis-server.sock', + 'port' => 0, + ], Only "host" and "port" variables are required, the other ones are optional. @@ -131,7 +219,11 @@ You might need to restart apache for the changes to take effect:: Redis is very configurable; consult `the Redis documentation `_ to learn more. -**Using the Redis session handler:** If you are using Redis for locking and/or caching, + +Using the Redis session handler +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If you are using Redis for locking and/or caching, you may also wish to use Redis for session management. Redis can be used for centralized session management across multiple Nextcloud application servers, unlike the standard `files` handler. If you use the Redis handler, though, you *MUST* ensure that session @@ -139,7 +231,7 @@ locking is enabled. As of this writing, the Redis session handler does *NOT* ena session locking by default, which can lead to session corruption in some Nextcloud apps that make heavy use of session writes such as Talk. In addition, even when session locking is enabled, if the application fails to acquire a lock, the Redis session handler does not -currently return an error. Adding the following settings in your `php.ini` file will +currently return an error. Adding the following settings in your ``php.ini`` file will prevent session corruption when using Redis as your session handler: :: redis.session.locking_enabled=1 @@ -149,23 +241,6 @@ prevent session corruption when using Redis as your session handler: :: More information on configuration of phpredis session handler can be found on the `PhpRedis GitHub page `_ -**Connecting to Redis over TLS:** :: - - 'memcache.locking' => '\OC\Memcache\Redis', - 'memcache.distributed' => '\OC\Memcache\Redis', - 'memcache.local' =>'\OC\Memcache\Redis' , - 'redis' => [ - 'host' => 'tls://127.0.0.1', - 'port' => 6379, - 'user' => 'nextcloud', - 'password' => 'password', - 'ssl_context' => [ - 'local_cert' => '/certs/redis.crt', - 'local_pk' => '/certs/redis.key', - 'cafile' => '/certs/ca.crt', - 'verify_peer_name' => false - ] - ] Memcached --------- @@ -196,9 +271,13 @@ You can verify that the Memcached daemon is running with ``ps ax``:: 127.0.0.1 Restart your Web server, add the appropriate entries to your -``config.php``, and refresh your Nextcloud admin page. This example uses APCu -for the local cache, Memcached as the distributed memcache, and lists all the -servers in the shared cache pool with their port numbers:: +``config.php``, and refresh your Nextcloud admin page. + +Memcached configuration in Nextcloud (config.php) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This example uses APCu for the local cache, Memcached as the distributed memcache, +and lists all the servers in the shared cache pool with their port numbers:: 'memcache.local' => '\OC\Memcache\APCu', 'memcache.distributed' => '\OC\Memcache\Memcached', From b502cc7f27b8cc332401500b42655cc0f377faa9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Fri, 29 Jul 2022 11:35:02 +0200 Subject: [PATCH 2/7] Note on Redis for local cache MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Explain that using Redis for local cache is possible, but not recommended Signed-off-by: Martin Rüegg --- admin_manual/configuration_server/caching_configuration.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index 858e945fd..3df652d20 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -100,10 +100,12 @@ Further more, you can use Redis for the distributed server cache:: 'memcache.distributed' => '\OC\Memcache\Redis', -Additionally, you can use Redis for the local cache like so:: +Additionally, you can use Redis for the local cache like so (see note below):: 'memcache.local' => '\OC\Memcache\Redis', +.. note:: Using Redis for local cache on a multi-server setup can cause issues. Also, even on a single-server setup, APCu (see section above) should be faster. + When using Redis for any of the above cache settings, you also need to specify either the ``redis`` or ``redis.cluster`` configuration in ``config.php``. From 27c42ea100ebd1cd4186c71fc7d1dacbe12b0112 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Fri, 2 Sep 2022 23:05:57 +0200 Subject: [PATCH 3/7] Update admin_manual/configuration_server/caching_configuration.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Joas Schilling <213943+nickvergessen@users.noreply.github.com> Signed-off-by: Martin Rüegg --- admin_manual/configuration_server/caching_configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index 3df652d20..cec598da0 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -147,7 +147,7 @@ The following options are available to configure when using a redis cluster (all ] -Connecting to Single Redis Server over TCP +Connecting to single Redis server over TCP ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To connect to a remote or local Redis server over TCP use:: From d038bab09045fdcb17ba249e9cfeec5673a8ea3c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Fri, 2 Sep 2022 23:50:36 +0200 Subject: [PATCH 4/7] Update admin_manual/configuration_server/caching_configuration.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Carl Schwan Signed-off-by: Martin Rüegg --- admin_manual/configuration_server/caching_configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index cec598da0..19e9f1623 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -96,7 +96,7 @@ For best performance, use Redis for file locking by adding this:: 'memcache.locking' => '\OC\Memcache\Redis', -Further more, you can use Redis for the distributed server cache:: +Additionally, you should use Redis for the distributed server cache:: 'memcache.distributed' => '\OC\Memcache\Redis', From 5372491ecb05d732d64a1ccd94efa405e039d35c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Sat, 3 Sep 2022 00:06:51 +0200 Subject: [PATCH 5/7] Incorporating review feedback MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - replace "memcache" with "data cache" in the introduction to avoid confusion with "memcached" - moving the "Recommendations" section to the top of the page (between intro and cache configuration) - re-organize and expand the "Recommendations* section Signed-off-by: Martin Rüegg --- .../caching_configuration.rst | 183 ++++++++++-------- 1 file changed, 105 insertions(+), 78 deletions(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index 19e9f1623..9bf1b5a7e 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -5,23 +5,22 @@ Memory caching You can significantly improve your Nextcloud server performance with memory caching, where frequently-requested objects are stored in memory for faster retrieval. There are two types of caches to use: a PHP opcode cache, which is -commonly called *opcache*, and data caching for your Web server. If you do not -install and enable a local memcache you will see a warning on your Nextcloud -admin page. **A memcache is not required and you may safely ignore the warning -if you prefer.** +commonly called *opcache*, and data cache for your web server, commonly called +"memcache". -.. note:: If you enable only a distributed cache in - your ``config.php`` (``memcache.distributed``) and not a - local cache (``memcache.local``) you will still see the cache warning. +.. note:: If you do not install and enable a local memcache you will see a + warning on your Nextcloud admin page. **A memcache is not required and you + may safely ignore the warning if you prefer.** If you enable only a + distributed cache (``memcache.distributed``) in your ``config.php`` and not + a local cache (``memcache.local``) you will still see the cache warning. -A PHP opcache stores compiled PHP scripts so they don't need to be re-compiled +A **PHP opcache** stores compiled PHP scripts so they don't need to be re-compiled every time they are called. PHP bundles the Zend OPcache in core since version 5.5, so you don't need to install an opcache manually. -Data caching is supplied by the user (APCu), Memcached or Redis. - -Nextcloud supports multiple memory caching backends, so you can choose the type -of memcache that best fits your needs. The supported caching backends are: +**Data caching** is supplied by the user. Nextcloud supports multiple memory +caching backends, so you can choose the type of memcache that best fits your +needs. The supported caching backends are: * `APCu `_, APCu 4.0.6 and up required. A local cache for systems. @@ -30,19 +29,79 @@ of memcache that best fits your needs. The supported caching backends are: * `Memcached `_ For distributed caching. -Memcaches must be explicitly configured in Nextcloud by installing +Data caches, or memcaches, must be explicitly configured in Nextcloud by installing and enabling your desired cache, and then adding the appropriate entry to ``config.php`` (See :doc:`config_sample_php_parameters` for an overview of all possible config parameters). + +Recommendations based on type of deployment +------------------------------------------- + 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 -active by running :ref:`label-phpinfo`. +and Redis. After installing and enabling your chosen memcache (data cache), +verify that it is active by running :ref:`label-phpinfo`. + +.. note:: See specific cache configuration options under the appropriate section further down. + +Small/Private home server +^^^^^^^^^^^^^^^^^^^^^^^^^ + +Only use APCu:: + + 'memcache.local' => '\OC\Memcache\APCu', + +Organizations with single-server +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Use Redis for everything except local memcache:: + + 'memcache.local' => '\OC\Memcache\APCu', + 'memcache.distributed' => '\OC\Memcache\Redis', + 'memcache.locking' => '\OC\Memcache\Redis', + 'redis' => [ + 'host' => 'localhost', + 'port' => 6379, + ], + +Organizations with clustered setups +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Use APCu for local cache and either Redis cluster ...:: + + 'memcache.local' => '\OC\Memcache\APCu', + 'memcache.distributed' => '\OC\Memcache\Redis', + 'memcache.locking' => '\OC\Memcache\Redis', + 'redis.cluster' => [ + 'seeds' => [ // provide some/all of the cluster servers to bootstrap discovery, port required + 'cache-cluster:7000', + 'cache-cluster:7001', + ], + ] + +... or Memcached cluster ...:: + + 'memcache.local' => '\OC\Memcache\APCu', + 'memcache.distributed' => '\OC\Memcache\Memcached', + 'memcache.locking' => '\OC\Memcache\Memcached', + 'memcached_servers' => [ + [ 'server1.example.com', 11211 ], + [ 'server2.example.com', 11211 ], + ], + +... for distrebuted and locking caches. .. note:: If you run multiple web servers and enable a distributed cache in your ``config.php`` (``memcache.distributed``) or a file locking provider (``memcache.locking``) you need to make sure that they are referring to the - very same memcache server and not to ``localhost`` or a unix socket. + very same memcache server/cluster and not to ``localhost`` or a unix socket. + +Additional notes for Redis vs. APCu on memory caching +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +APCu is faster at local caching than Redis. If you have enough memory, use APCu for Memory Caching +and Redis for File Locking. If you are low on memory, use Redis for both. + APCu ---- @@ -61,6 +120,7 @@ Refresh your Nextcloud admin page, and the cache warning should disappear. cron jobs. Please make sure you set the ``apc.enable_cli`` to ``1`` on your ``php.ini`` config file or append ``--define apc.enable_cli=1`` to the cron job call. + Redis ----- @@ -100,11 +160,11 @@ Additionally, you should use Redis for the distributed server cache:: 'memcache.distributed' => '\OC\Memcache\Redis', -Additionally, you can use Redis for the local cache like so (see note below):: +Further more, you could use Redis for the local cache like so, but it's not recommended (see warning below):: 'memcache.local' => '\OC\Memcache\Redis', -.. note:: Using Redis for local cache on a multi-server setup can cause issues. Also, even on a single-server setup, APCu (see section above) should be faster. +.. warning:: Using Redis for local cache on a multi-server setup can cause issues. Also, even on a single-server setup, APCu (see section above) should be faster. When using Redis for any of the above cache settings, you also need to specify either the ``redis`` or ``redis.cluster`` configuration in ``config.php``. @@ -146,7 +206,6 @@ The following options are available to configure when using a redis cluster (all 'dbindex' => 0, ] - Connecting to single Redis server over TCP ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -157,7 +216,6 @@ To connect to a remote or local Redis server over TCP use:: 'port' => 6379, ], - Connecting to single Redis server over TLS ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To connect via TCP over TLS, add the following configuration:: @@ -173,7 +231,6 @@ To connect via TCP over TLS, add the following configuration:: ] ] - Connecting to Redis cluster over TLS ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To connect via TCP over TLS, add the following configuration:: @@ -191,7 +248,6 @@ To connect via TCP over TLS, add the following configuration:: ] ] - Connecting to single Redis server over UNIX socket ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -221,7 +277,6 @@ You might need to restart apache for the changes to take effect:: Redis is very configurable; consult `the Redis documentation `_ to learn more. - Using the Redis session handler ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -243,6 +298,31 @@ prevent session corruption when using Redis as your session handler: :: More information on configuration of phpredis session handler can be found on the `PhpRedis GitHub page `_ +Additional Redis installation help +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If your version of **Mint** or **Ubuntu** does not package the required version of +``php-redis``, then try `this Redis guide on Tech and Me +`_ +for a complete Redis installation on Ubuntu 14.04 using PECL. +These instructions are adaptable for **any distro** that does not package the +supported version, or that does not package Redis at all, such as **SUSE Linux +Enterprise Server** and **Red Hat Enterprise Linux**. + +For PHP 7.0 and PHP 7.1 use Redis PHP module 3.1.x or later. + +See ``_ + +On Debian/Mint/Ubuntu, use ``apt-cache`` to see the available +``php-redis`` version, or the version of your installed package:: + + apt-cache policy php-redis + +On CentOS and Fedora, the ``yum`` command shows available and installed version +information:: + + yum search php-pecl-redis + Memcached --------- @@ -283,70 +363,17 @@ and lists all the servers in the shared cache pool with their port numbers:: 'memcache.local' => '\OC\Memcache\APCu', 'memcache.distributed' => '\OC\Memcache\Memcached', + 'memcache.locking' => '\OC\Memcache\Memcached', 'memcached_servers' => [ [ 'server0.example.com', 11211 ], [ 'server1.example.com', 11211 ], [ 'server2.example.com', 11211 ], ], + 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`` (See :doc:`config_sample_php_parameters`) to select a different location. - -Recommendations based on type of deployment -------------------------------------------- - -Small/Private home server -^^^^^^^^^^^^^^^^^^^^^^^^^ - -Only use APCu:: - - 'memcache.local' => '\OC\Memcache\APCu', - -Organizations with single-server and clustered setups -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Use Redis for everything except local memcache:: - - 'memcache.local' => '\OC\Memcache\APCu', - 'memcache.distributed' => '\OC\Memcache\Redis', - 'memcache.locking' => '\OC\Memcache\Redis', - 'redis' => [ - 'host' => 'redis-host.example.com', - 'port' => 6379, - ], - -Additional notes for Redis vs. APCu on memory caching -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -APCu is faster at local caching than Redis. If you have enough memory, use APCu for Memory Caching -and Redis for File Locking. If you are low on memory, use Redis for both. - -.. _install_redis_label: - -Additional Redis installation help ----------------------------------- - -If your version of Mint or Ubuntu does not package the required version of -``php-redis``, then try `this Redis guide on Tech and Me -`_ for a complete Redis installation on Ubuntu 14.04 using PECL. -These instructions are adaptable for any distro that does not package the -supported version, or that does not package Redis at all, such as SUSE Linux -Enterprise Server and Red Hat Enterprise Linux. - -For PHP 7.0 and PHP 7.1 use Redis PHP module 3.1.x or later. - -See ``_ - -On Debian/Mint/Ubuntu, use ``apt-cache`` to see the available -``php-redis`` version, or the version of your installed package:: - - apt-cache policy php-redis - -On CentOS and Fedora, the ``yum`` command shows available and installed version -information:: - - yum search php-pecl-redis From 11d84a4fa7c09345c2e7dde922240b289bf7e86f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Sat, 3 Sep 2022 00:14:46 +0200 Subject: [PATCH 6/7] Incorporating note from #9125 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Credits: @2fst4u in #9125 Signed-off-by: Martin Rüegg --- admin_manual/configuration_server/caching_configuration.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index 9bf1b5a7e..0649e7cfb 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -205,6 +205,9 @@ The following options are available to configure when using a redis cluster (all 'password' => 'password', 'dbindex' => 0, ] + + +.. note:: The port is required as part of the server URL. However, it is not necesarry to list all servers: for example, if all servers are load balanced via the same DNS name, only that server name is required. Connecting to single Redis server over TCP ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ From be1014ce28e11086993c8b20e686c6de9e761c8d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20R=C3=BCegg?= Date: Sat, 3 Sep 2022 00:17:16 +0200 Subject: [PATCH 7/7] Remove extra line MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Martin Rüegg --- admin_manual/configuration_server/caching_configuration.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index 0649e7cfb..934a3684d 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -205,7 +205,6 @@ The following options are available to configure when using a redis cluster (all 'password' => 'password', 'dbindex' => 0, ] - .. note:: The port is required as part of the server URL. However, it is not necesarry to list all servers: for example, if all servers are load balanced via the same DNS name, only that server name is required.