This section covers everything you need to know to run your Redis Enterprise Software deployment.


In addition to using the RS admin console to manage the cluster, you can also do cluster operations with the cluster REST API.

To access the cluster REST API documentation, either:

  • Open the HTML files in the RS software package:
    1. Download the RS software package.
    2. Unarchive the package.
    3. Unarchive the rlec_docs.tar.gz package.
    4. Open the rlec_docs\html\index.html file in a web browser.
  • Open the HTML files in an installed RS node:
    1. Connect to the terminal of an RS node.
    2. Change directory to the Redis Enterprise Software installation directory, for example /opt.
    3. Copy the rlec_rest_api.tar.gz package to a host with a web browser and unarchive it.
    4. Open the rlec_docs\html\index.html file in a web browser.

    Planning your Cluster Deployment

    The information in the section discusses important topics you need to know about when planning your Redis Enterprise Software cluster for a production deployment. Cluster environment optimization Redis Enterprise Software employs various algorithms to optimize performance. As part of this process, Redis Enterprise Software examines usage characteristics and load to adjust its run-time configuration accordingly. Depending on your specific usage characteristics and load, it might take Redis Enterprise Software some time to adjust itself to optimal performance.

    Setting up a New Cluster

    A Redis Enterprise Software cluster typically consists of several nodes. For production deployments, we recommend an uneven number of nodes, with a minimum of three. Note: In a cluster that consists of only one node, some features and capabilities are not enabled, such as database replication that provides high availability. To set up a new cluster, you must first install the Redis Enterprise Software package and then set up the cluster as described below.

    Adding a Cluster Node

    When you install Redis Enterprise Software (RS) on the first node of a cluster, you create the new cluster. After you install the first node, you can add more nodes to the cluster. Note: Before you add a node to the cluster: The clocks on all nodes must always be synchronized. If the clock in the node you are trying to join to the cluster is not synchronized with the nodes already in the cluster, the action fails and an error message is shown indicating that you must synchronize the clocks first.

    Benchmarking Redis Enterprise

    Use the memtier_benchmark tool to perform a performance benchmark of Redis Enterprise Software. Prerequisites: Redis Enterprise Software installed A cluster configured A database created For help with the prerequisites,see Get started with Redis Enterprise Software. It is recommended to run memtier_benchmark on a separate node that is not part of the cluster being tested. If you run it on a node of the cluster, be mindful that it affects the performance of both the cluster and memtier_benchmark.

    Cluster Maintenance

    This section has all you need to know to maintain a Redis Enterprise Software (RS) cluster. Cluster Name, Email Service, Time Zone, and License You can view and set various cluster settings in the Settings > General page. Entering a cluster key After purchasing a cluster key and if your account has the “Admin” role, you can enter the key in the Cluster Key field, either during initial cluster creation or at any time afterward.

    Database Maintenance

    This section helps you maintain your Redis Enterprise Software databases. Database Security Your data is critical to your business and securing it is one of your top priorities. Here's where to learn how to secure access to your data and secure your data in transit. Causal Consistency in an Active-Active Database When you enable Causal Consistency in Active-Active databases, the order of operations on a specific key are maintained across all Active-Active database instances.

    Monitoring with Metrics and Alerts

    You can use the metrics that measure the performance of your Redis Enterprise Software (RS) clusters, nodes, databases and shards to keep an eye on the performance of your databases. In the RS admin console, you can see the real-time metrics and you can configure alerts that send notifications based on alert parameters. You can also access the metrics and configure alerts through the REST API so that you can integrate the RS metrics into your monitoring environment, for example using Prometheus and Grafana.

    Logging and Audit Events

    Management actions performed with Redis Enterprise are audited in order to fulfill two major objectives: To make sure that system management tasks are appropriately performed and/or monitored by the Administrators To facilitate compliance with regulatory standards In order to fulfill both objectives, the audit records contain the following information: Who performed the action? What exactly was the performed action? When was the action performed? Did the action succeed or not?


    This section includes various troubleshooting tips and tricks for Redis Enterprise Software. Topics: Creating a Support Package If you encounter any issues that you are not able to resolve yourself and need to contact Redis support for assistance, you can create a support package that gathers all essential information to help us debug your issues. Note: The process of creating the support package can take several minutes and generates load on the system.

    Redis Enterprise Software product lifecycle

    Redis Enterprise Software product lifecycle fully reflects our subscription agreement. However, for any discrepancy between the two policies, the subscription agreement prevails. Redis Enterprise modules follow the modules lifecycle. Release numbers Redis uses a four-place numbering scheme to designate released versions of its products. The format is “Major1.Major2.Minor-Build”. Major sections of the version number represents fundamental changes and additions in capabilities to Redis Enterprise Software. The Major1 and Major2 part of the version number are incremented based on the size and scale of the changes in each release.

    User password rotation

    Redis Enterprise Software lets you implement password rotation policies using its API. You can add a new password for a database user without immediately invalidating the old one (which might cause authentication errors in production). Note: Password rotation does not work for the default user. Add additional users to enable password rotation. For user access to the Redis Enterprise Software admin console, you can set a password expiration policy to prompt the user to change their password.