This section includes various troubleshooting tips and tricks for Redis Enterprise Software (RS).

Topics:

    Creating a Support Package

    If you encounter any issues that you are not able to resolve yourself and need to contact Redis Labs support for assistance, you can create a support package that gathers all essential information to help us debug your issues. Creating a support package To create a support package: Click Support at the top right of the management UI. Click Create Support Package at the bottom of the page, and confirm the action.

    Database Metrics Not Collected During Resharding

    Because data is being moved around across shards during the resharding process, it is impossible to report the values of some of the metrics in an accurate manner. Therefore, several database metrics are not collected, and as a result, the graph is blank when you view the database or shard metrics. Examples of metrics that are not collected during the resharding process are: Used memory Memory usage Total keys Write misses/sec Read misses/sec Expired objects/sec Evicted objects/sec Incoming traffic Outgoing traffic

    Nodes on Different VLANs

    Nodes in the same cluster must reside on the same VLAN. If you cannot host the nodes on the same VLAN then you must configure all ports between them to be open. For additional details, refer to network port configuration.

    Recovering a Failed Cluster

    When a cluster fails, you must use the cluster configuration file and database data to recover the cluster. Note - For cluster recovery in a Kubernetes Operator deployment, go to: Redis Enterprise Cluster Recovery for Kubernetes. Cluster failure can be caused by: A hardware or software failure that causes the cluster to be unresponsive to client requests or administrative actions. More than half of the cluster nodes lose connection with the cluster, resulting in quorum loss.

    Recovering a Failed Database

    When a cluster fails or a database is corrupted, you must recover the databases with their previous configuration and data. The configuration of the databases is recovered during cluster recovery. To restore the data that was in the databases to databases in the new cluster you must restore the database persistence files (backup, AOF, or snapshot files) to the databases. These files are stored in the persistence storage location.

    ReplicaOf Repeatedly Fails

    There might be instances in which the Replica of process repeatedly fails and restarts itself on Redis Enterprise Software (RS). This can result from the Redis "client-output-buffer-limit" setting on the source database being configured to a relatively small value, which causes the connection to be dropped. To identify this issue you can review the Redis log of the source database and find an entry in the log describing this issue.

    Testing Client Connectivity

    In various scenarios, such as after creating a new cluster or upgrading the cluster, it is highly advisable to verify client connectivity to the database. To test client connectivity: Create a Redis database and get the database's endpoint, which contains the cluster name (FQDN). For additional details, refer to Creating a new database. Try to connect to the database endpoint from your client of choice, and execute commands against the database.