{
  "schema_version": 2,
  "id": "operate/rs/installing-upgrading/upgrading/upgrade-cluster",
  "title": "Upgrade a Redis Enterprise Software cluster",
  "url": "https://redis.io/docs/latest/operate/rs/7.4/installing-upgrading/upgrading/upgrade-cluster/",
  "summary": "Upgrade a Redis Enterprise Software cluster.",
  "content": "\n## Supported upgrade paths\n\n\u003cspan title=\"Check mark icon\"\u003e\u0026#x2705;\u003c/span\u003e Supported – You can upgrade directly from the current Redis Software cluster version.\n\n\u003cspan title=\"X icon\"\u003e:x:\u003c/span\u003e Not supported – You cannot upgrade directly from the current Redis Software cluster version. You must first upgrade to a supported intermediate version.\n\n| Current Redis Software cluster version | Upgrade to Redis Software 7.2.x | Upgrade to Redis Software 7.4.x |  Upgrade to Redis Software 7.8.x | Upgrade to Redis Software 7.22.x | Upgrade to Redis Software 8.0.2-8.0.10 | Upgrade to Redis Software 8.0.16-8.0.20 | Upgrade to Redis Software 8.2.x |\n|:-----------------------:|:----------------:|:----------------:|:----------------:|:----------------:|:----------------:|:----------------:|:----------------:|\n| 6.0.x | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e |\n| 6.2.4\u003cbr /\u003e6.2.8 | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e |\n| 6.2.10\u003cbr /\u003e6.2.12\u003cbr /\u003e6.2.18 | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e |\n| 6.4.x | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |  \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e | \u003cspan title=\"Not supported\"\u003e:x:\u003c/span\u003e |\n| 7.2.x | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n| 7.4.x | – | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n| 7.8.x | – | – | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n| 7.22.x | – | – | – | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n| 8.0.2\u003cbr /\u003e8.0.6\u003cbr /\u003e8.0.10 | – | – | – | – | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n| 8.0.16\u003cbr /\u003e8.0.18\u003cbr /\u003e8.0.20 | – | – | – | – | - | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n| 8.2.x | – | – | – | – | – | – | \u003cspan title=\"Supported\"\u003e\u0026#x2705;\u003c/span\u003e |\n\n\nSee the [Redis Enterprise Software product lifecycle](https://redis.io/docs/latest/operate/rs/installing-upgrading/product-lifecycle) for more information about release numbers and the end-of-life schedule.\n\n## Upgrade prerequisites\n\nBefore upgrading a cluster:\n\n- Verify access to [rlcheck](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rlcheck) and [rladmin](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin#use-the-rladmin-shell) commands.\n\n- Run [rlcheck](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rlcheck) on each node and verify there are no issues:\n\n    ```sh\n    rlcheck\n    ```\n\n- Verify [maintenance mode](https://redis.io/docs/latest/operate/rs/clusters/maintenance-mode) is not enabled:\n\n    1. On a node in the cluster, run [`rladmin status`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status):\n\n        ```sh\n        rladmin status\n        ```\n\n    1. Review each node's `SHARDS` field. If the value is yellow, the node is in maintenance mode.\n\n        ![](https://redis.io/docs/latest/images/rs/maintenance_mode.png)\n\n    1. To deactivate maintenance mode on a node, run the following [`rladmin node maintenance_mode off`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/node/maintenance-mode#node-maintenance_mode-off) command. See [Deactivate maintenance mode](https://redis.io/docs/latest/operate/rs/clusters/maintenance-mode#deactivate-maintenance-mode) for additional details.\n\n        ```sh\n        rladmin node \u003cnode_id\u003e maintenance_mode off\n        ```\n\n- Verify that you meet the upgrade path requirements for your desired cluster version and review the relevant [release notes](https://redis.io/docs/latest/operate/rs/release-notes/) for any preparation instructions.\n\n- Avoid changing the database configuration or performing other cluster management operations during the upgrade process, as this might cause unexpected results.\n\n- Upgrade the cluster's primary (master) node first. To identify the primary node, use one of the following methods:\n\n    - **Nodes** screen in the new Cluster Manager UI (only available for Redis Enterprise versions 7.2 and later)\n\n    - [`rladmin status nodes`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-nodes) command\n    \n    - [`GET /nodes/status`](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/nodes/status#get-all-nodes-status) REST API request\n\n## Upgrade cluster\n\nStarting with the primary (master) node, follow these steps for every node in the cluster. To ensure cluster availability, upgrade each node separately.\n\n1.  Verify node operation with the following commands:\n\n    ``` shell\n    $ rlcheck\n    $ rladmin status extra all\n    ```\n\n2.  Download the Redis Enterprise Software installation package to the machine running the node from the Download Center on [https://cloud.redis.io](https://cloud.redis.io).  \n\n3.  Extract the installation package:\n\n    ```sh\n    tar vxf \u003ctarfile name\u003e\n    ```\n\n    \u003e [!NOTE]\n    \u003e You cannot change the installation path or the user during the upgrade.\n    \u003e\n\n1.  Run the install command. See [installation script options](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/install-script) for a list of command-line options you can add to the following command:\n\n    ``` shell\n    sudo ./install.sh\n    ```\n\n    The installation script automatically recognizes the upgrade and responds accordingly.\n\n    The upgrade replaces all node processes, which might briefly interrupt any active connections.\n\n2.  Verify the node was upgraded to the new version and is still operational:\n\n    ``` shell\n    $ rlcheck\n    $ rladmin status extra all\n    ```\n\n3.  Visit the Cluster Manager UI.\n\n    If the Cluster Manager UI was open in a web browser during the upgrade, refresh the browser to reload the console.\n\nAfter all nodes are upgraded, the cluster is fully upgraded. Certain features introduced in the new version of Redis Enterprise Software only become available after upgrading the entire cluster.\n\nAfter upgrading from version 6.0.x to 6.2.x, restart `cnm_exec` on each cluster node to enable more advanced state machine handling capabilities:\n\n```sh\nsupervisorctl restart cnm_exec\n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-10-22T06:20:54-07:00"
}