Redis Cluster Encountering an Unusual Error

Today, our Redis cluster, which has been running smoothly for several weeks, suddenly ceased to function. In the logs, I found that it’s unable to reach one of the Redis servers. I’ve checked thoroughly and confirmed that there are no issues accessing this server.

I’m seeking assistance in understanding whether the Redis settings need adjustment. Since it’s a cluster, shouldn’t it attempt to connect to another part of the Redis cluster if it can’t reach the IP on port 7000?

The error logged in nextcloud.log is as follows:

“Could not boot workflowengine: read error on connection to”,“exception”:{},“CustomMessage”:“Could not boot workflowengine: read error on connection to”}}

My Redis configuration in nextcloud:

‘memcache.local’ => ‘\OC\Memcache\APCu’,
‘memcache.distributed’ => ‘\OC\Memcache\redis’,
‘memcache.locking’ => ‘\OC\Memcache\redis’,

‘redis.cluster’ =>
array (
‘seeds’ =>
array (
0 => ‘’,
1 => ‘’,
2 => ‘’,
3 => ‘’,
4 => ‘’,
5 => ‘’,
6 => ‘’,
7 => ‘’,
8 => ‘’,
‘failover_mode’ => 0,
‘timeout’ => 0,
‘read_timeout’ => 0,
‘password’ => ‘xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx’,
‘dbindex’ => 0,

I did try to switch the master over to one of the slaves, but the issue is still there. Cluster status in Redis:


Let me know if you need any further information.

Based on the information provided, it seems that your Redis cluster is configured correctly, and the cluster itself is reporting a healthy state. The error message “Could not boot workflowengine: read error on connection to” suggests that there is a problem with the connection to the specified Redis node, but you’ve confirmed that the server is accessible.

Here are a few steps you can take to troubleshoot the issue further:

Check Redis Logs: Look at the logs of the Redis server that is failing to connect ( on port 7000). There might be more detailed error messages that can give you a clue about what’s going wrong.

Test Connectivity: Use redis-cli or telnet to manually connect to the Redis server on the problematic port from the Nextcloud server to ensure that there are no network issues or firewalls blocking the connection.

redis-cli -h -p 7000 -a yourpassword
# or
telnet 7000
  • Check Redis Configuration: Ensure that the redis.conf file on the problematic Redis server is correctly configured for cluster mode and that it’s not in a fail state.
  • Examine Nextcloud Configuration: Double-check the config.php file for Nextcloud to ensure that the Redis configuration parameters are correct. Pay special attention to the seeds array to make sure all IP addresses and ports are correct.
  • Failover Handling: If a node goes down, Redis Cluster should automatically failover to a replica. However, this depends on the failover_mode setting. The failover_mode parameter in your configuration is set to 0, which is not a standard Redis option. For Redis Cluster, there is no failover_mode setting; failover is automatic. You might want to remove this line if it’s not serving any purpose.
  • Cluster Configuration: Ensure that the Redis Cluster configuration is correct on all nodes. You can use the redis-cli --cluster check command to validate the cluster’s configuration.
  • Restart Services: Sometimes, simply restarting the Redis service on the problematic server can resolve transient issues.
  • Nextcloud Cache Clear: Clear the Nextcloud cache using the OCC command, which might help if there’s a caching issue:
sudo -u www-data php occ cache:clear

Consult Documentation: Review the Nextcloud documentation for any specific Redis cluster settings or recommendations.