Redis Cache By Xon

Redis Cache By Xon 2.18.0

No permission to download
Q: There are a lot of the errors; "CredisException: read error on connection" or "CredisException: protocol error, got 'xxx' as reply type byte" being logged
A: Please be aware that Redis is very sensitive to latency in a virtual environment. If repeated connection failures or protocol errors are experienced disable any Redis Persistence options. Additionally, check CPU steal as this can also cause latency issues.

Additionally, check the redis log file ( /var/log/redis/redis.log ) for any warnings. Key things to look for:
  • WARNING you have Transparent Huge Pages (THP) support enabled in your kernel
    Run:
    Code:
    echo never > /sys/kernel/mm/transparent_hugepage/enabled
    Add to /etc/rc.local
    Code:
    echo never > /sys/kernel/mm/transparent_hugepage/enabled
  • WARNING /proc/sys/net/core/somaxconn is set to the lower value of 128
    Run:
    Code:
    sysctl -w net.core.somaxconn=512
    Add to /etc/sysctl.d/redis.conf (or /etc/sysctl.conf)
    Code:
    net.core.somaxconn=512
    You may require to adjust "net.ipv4.tcp_max_syn_backlog" to be larger!
  • WARNING overcommit_memory is set to 0! Background save may fail under low memory condition
    Run:
    Code:
    sysctl -w vm.overcommit_memory =1
    Add to /etc/sysctl.d/redis.conf (or /etc/sysctl.conf)
    Code:
    vm.overcommit_memory =1
(All 'fixes' require restarting redis to apply).

You may need to increase tcp-backlog from the stock 511, please ensure net.core.somaxconn is adjusted as well!

This server configuration advise is best effort, and not guarantied as it is well outside the scope of this add-on.

Q. CPU Steal is mentioned as causing latency issue, how do I check this.
A. On Linux, run:
Code:
screen
iostat -c -t 30 > /tmp/cpu_stats.log

Then after a day or so; check your max CPU steal:

Code:
cat /tmp/cpu_stats.log | grep -v iowait | awk '{print $5;}'  | sort -rn | more


Q: Support for earlier versions of XenForo
A: See Zend Redis cache add-on for XenForo 1.4+ support

Q: Redis Configuration
A: Please see the Redis Documenatation.

Alternatively, you can use @eva2000's How to install Redis server on Centmin Mod LEMP stack Guide.

Q:Make Redis behave like Memcache
A: See Using Redis as an LRU cache, and make sure to set maxmemory!

Code:
maxmemory 256mb
maxmemory-policy allkeys-lru

You may wish to disable the periodic 'save' directives which can cause latency on high-usage websites in virtual environments.

Q: Sample XenForo Configuration using TCP
A: Please see https://xenforo.com/docs/xf2/cache/ for details on setting up the general XenForo Cache.

The minimum configuration is:
PHP:
$config['cache']['enabled'] = true;
$config['cache']['provider'] = 'SV\RedisCache\Redis';
$config['cache']['config'] = [
    'server' => '127.0.0.1',
    'port' => 6379,
];

Q: Sample XenForo Configuration using a socket
A: Please see https://xenforo.com/docs/xf2/cache/ for details on setting up the general XenForo Cache.

The minimum configuration is:
PHP:
$config['cache']['enabled'] = true;
$config['cache']['provider'] = 'SV\RedisCache\Redis';
$config['cache']['config']  = [
        'server' => 'unix:///tmp/redis.sock',
];

Q: Sample XenForo Configuration using username/password
Redis supports username/password authentication.
This is most common in cloud environments which use redis 6 (ie with a username), while older redis only supports just a password
PHP:
$config['cache']['config']['username'] = 'myUsername'; // requires redis 6+, or for cloud redis installations
$config['cache']['config']['password'] = '....';

Q. Sample XenForo Configuration using SSL/TLS support
PHP:
$config['cache']['config']['server'] = 'ssl://127.0.0.1';
// See https://www.php.net/manual/en/context.ssl.php for details
$config['cache']['config']['tlsOptions'] = [
   'SNI_enabled' => true,
];

Q. When trying to use a socket, an exception with "No such file or directory" is thrown
A. There are a few reasons this could happen;

After confirming that the socket path is correct, try the following suggestions:
  • selinux is preventing php from accessing the socket.
  • open_basedir is preventing php from accessing the socket.
  • chroot is preventing php from accessing the socket.
  • permissions are preventing php from reading/writing to the socket.
Q: Sample Single Redis Replica Configuration
A:

The minimum configuration is:
PHP:
$config['cache']['enabled'] = true;
$config['cache']['provider'] = 'SV\RedisCache\Redis';
$config['cache']['config'] = [
        'server' => '127.0.0.1',
        'port' => 6379,
];
$config['cache']['config']['load_from_replica'] = [
        'server' => '127.0.0.1',
        'port' => 6378,
];

Q: Sample Redis Sentinel Configuration
A:

Redis Sentinel support for high-availability. See http://redis.io/topics/sentinel for more information.
Enable with:
PHP:
$config['cache']['config']['sentinel_master'] = 'mymaster';
$config['cache']['config']['server'] = 'tcp://127.0.0.1:26379';
'server' now points to a comma delimited list of sentinel servers to find the master. Note; the port must be explicitly listed

To load data from replicas use;
PHP:
$config['cache']['config']['load_from_replicas'] = true;

By default, a local replica is preferred, this can be changed by setting:
PHP:
$config['cache']['config']['replica_select_callable'] = function (array $replicas) {
        $replicaKey = array_rand($slaves, 1);
        return $replicas[$replicaKey];
};
Setting to false (or some non-callable) will fall back to a random replica.


Q: Performance - Redis
A: See:
Q: phpredis supports persistent connection, are these recommended?
A: I do not recommend using persistent connections, as they appear to be quite buggy.
Back
Top Bottom