diff --git a/doc/admin/en/Redis.mc b/doc/admin/en/Redis.mc index 998fba8df..f85bcf025 100644 --- a/doc/admin/en/Redis.mc +++ b/doc/admin/en/Redis.mc @@ -1,45 +1,57 @@ -# Streams Redis configuration +# Redis configuration Redis can be used for faster session data storage and retrieval. Here is how to set it up. ** Prerequisites:** -* Redis must be running and available by IP address. You need to know your Redis authentication string before continuing. -* Be able to edit the Streams .htconfig.php file +* Redis must be running and available by IP address. +* Authenticated access is assumed. You will need to know your Redis authentication string before continuing. +* Be able to edit the webserver .htconfig.php file ## Step 1: Edit the .htconfig.php file -Streams is configured using a _.htconfig.php_ file in the root folder of the installation. Navigate to your Streams installation folder and open the .htconfig.php file with your preferred editor. +The webserver app is configured using a _.htconfig.php_ file in the root folder of the installation. Navigate to your installation folder and open the .htconfig.php file with your preferred editor. Append the following code to the bottom of the file. -
// Session storage over Redis
-App::$config['system']['session_custom'] = true;
-App::$config['system']['session_save_handler'] = "redis";
-App::$config['system']['session_save_path'] = "tcp://IP ADDRESS:6379?auth=LONG PASSWORD";
Update the default values to reflect the correct Redis information. +``` +// "Redis" must be capitalised here. +App::$config['system']['session_save_handler'] = "Redis"; +App::$config['system']['session_save_path'] = "redis://IP-ADDRESS:6379?auth=PASSWORD"; +``` -**IP ADDRESS** = The IP address Redis is listening on. -**LONG PASSWORD** = The authentication string used to access Redis. +Replace **IP-ADDRESS** with the IP address Redis is listening on, and **PASSWORD** with the authentication string used to access Redis. ## Step 2: Verify that Redis is receiving the sessions. This assumes that Redis is listening on IP 127.0.0.1. Update to reflect the correct IP of your Redis service. ``` -redis-cli -h IP ADDRESS +redis-cli -h IP-ADDRESS ``` The command will look something like this, and your command prompt will change. -redis-cli -h 127.0.0.1 -127.0.0.1:6379> + +``` +redis-cli -h 127.0.0.1 +127.0.0.1:6379> +``` + In order to access the session keys, Redis will require password authorization to be submitted beforehand. -Replace "LONG PASSWORD" in the command below with the Redis password. +Replace "PASSWORD" in the command below with the Redis password. ``` -auth LONG PASSWORD +auth PASSWORD ``` + It will look something like this, with a small "OK" message at the end to confirm. -127.0.0.1:6379> auth dkdiidlsdifnlsvniefwnciwncl3j92h3vchlcnal3ijcli439d3gflvn: -ok +``` +127.0.0.1:6379> auth dkdiidlsdifnlsvniefwnciwncl3j92h3vchlcnal3ijcli439d3gflvn: +ok +``` + Now, you can view the session keys with this command: ``` keys * ``` + It will show you all the session identifiers currently stored in Redis: -127.0.0.1:6379> keys * - 1) "PHPREDIS_SESSION:e9310b5ee224b70f8df649f6938c15d9" - 2) "PHPREDIS_SESSION:d2abb4549333b81c9a119dbb639c0357" - 3) "PHPREDIS_SESSION:8cc64f59b80fc95e4ed43078048dcabb" -127.0.0.1:6379> +``` +127.0.0.1:6379> keys * + 1) "e9310b5ee224b70f8df649f6938c15d9" + 2) "d2abb4549333b81c9a119dbb639c0357" + 3) "8cc64f59b80fc95e4ed43078048dcabb" +127.0.0.1:6379> +```