From e0464ec4e74a548aa7f97e9e3170e69267f6f146 Mon Sep 17 00:00:00 2001 From: Rachel Elledge Date: Tue, 6 May 2025 17:16:10 -0500 Subject: [PATCH] DOC-5205 RS: Emphasize upgrade prerequisites --- content/operate/rs/installing-upgrading/upgrading/_index.md | 4 ++-- .../rs/installing-upgrading/upgrading/upgrade-cluster.md | 6 ++++++ .../rs/installing-upgrading/upgrading/upgrade-database.md | 2 ++ .../operate/rs/installing-upgrading/upgrading/upgrade-os.md | 4 ++++ 4 files changed, 14 insertions(+), 2 deletions(-) diff --git a/content/operate/rs/installing-upgrading/upgrading/_index.md b/content/operate/rs/installing-upgrading/upgrading/_index.md index 18f42098b..65de27a1b 100644 --- a/content/operate/rs/installing-upgrading/upgrading/_index.md +++ b/content/operate/rs/installing-upgrading/upgrading/_index.md @@ -17,7 +17,7 @@ To upgrade Redis Software: 1. Verify appropriate [network ports]({{< relref "/operate/rs/networking/port-configurations.md" >}}) are either open or used by Redis Software. -1. Review the [prerequisites]({{}}). +1. Complete all [prerequisites]({{}}) before starting the upgrade. 1. Upgrade the software on all nodes of the cluster using one of the following methods: @@ -33,7 +33,7 @@ To upgrade Redis Software: To upgrade the cluster's operating system: -1. Review the [prerequisites]({{}}). +1. Complete all [prerequisites]({{}}) before starting the upgrade. 2. Use one of the following rolling upgrade methods: diff --git a/content/operate/rs/installing-upgrading/upgrading/upgrade-cluster.md b/content/operate/rs/installing-upgrading/upgrading/upgrade-cluster.md index 14576fa77..51b83c813 100644 --- a/content/operate/rs/installing-upgrading/upgrading/upgrade-cluster.md +++ b/content/operate/rs/installing-upgrading/upgrading/upgrade-cluster.md @@ -52,6 +52,8 @@ Before upgrading a cluster: Starting with the primary node, follow these steps for every node in the cluster. To ensure cluster availability, upgrade each node separately. +1. Complete all [prerequisites](#upgrade-prerequisites) before starting the upgrade. + 1. Verify node operation with the following commands: ``` shell @@ -106,6 +108,8 @@ To perform a rolling upgrade of the cluster, use one of the following methods: ### Extra node upgrade method {#extra-node-upgrade} +1. Complete all [prerequisites](#upgrade-prerequisites) before starting the rolling upgrade. + 1. [Install a later version of Redis Software]({{< relref "/operate/rs/installing-upgrading/install/install-on-linux" >}}) on a new node. 1. [Add the new node]({{< relref "/operate/rs/clusters/add-node" >}}) to the cluster. @@ -118,6 +122,8 @@ To perform a rolling upgrade of the cluster, use one of the following methods: ### Replace node upgrade method {#replace-node-upgrade} +1. Complete all [prerequisites](#upgrade-prerequisites) before starting the rolling upgrade. + 1. [Remove a node]({{< relref "/operate/rs/clusters/remove-node#remove-a-node" >}}) with the earlier Redis Software version from the cluster. 1. Uninstall Redis Enterprise Software from the removed node: diff --git a/content/operate/rs/installing-upgrading/upgrading/upgrade-database.md b/content/operate/rs/installing-upgrading/upgrading/upgrade-database.md index 5f4db7ca8..dd31e7c59 100644 --- a/content/operate/rs/installing-upgrading/upgrading/upgrade-database.md +++ b/content/operate/rs/installing-upgrading/upgrading/upgrade-database.md @@ -79,6 +79,8 @@ Before upgrading a database: To upgrade a database: +1. Complete all [prerequisites](#upgrade-prerequisites) before starting the upgrade. + 1. _(Optional)_ Back up the database to minimize the risk of data loss. 1. Use [`rladmin`]({{< relref "/operate/rs/references/cli-utilities/rladmin/upgrade" >}}) to upgrade the database. During the upgrade process, the database will restart without losing any data. diff --git a/content/operate/rs/installing-upgrading/upgrading/upgrade-os.md b/content/operate/rs/installing-upgrading/upgrading/upgrade-os.md index 16772b8f1..503175cb7 100644 --- a/content/operate/rs/installing-upgrading/upgrading/upgrade-os.md +++ b/content/operate/rs/installing-upgrading/upgrading/upgrade-os.md @@ -72,6 +72,8 @@ To upgrade the cluster's operating system, use one of the following rolling upgr ### Extra node upgrade method {#extra-node-upgrade} +1. Complete all [prerequisites](#prerequisites) before starting the rolling upgrade. + 1. Create a node with the OS upgrade version. 1. [Install the cluster's current Redis Enterprise Software version]({{< relref "/operate/rs/installing-upgrading/install/install-on-linux" >}}) on the new node using the installation package for the OS upgrade version. @@ -84,6 +86,8 @@ To upgrade the cluster's operating system, use one of the following rolling upgr ### Replace node upgrade method {#replace-node-upgrade} +1. Complete all [prerequisites](#prerequisites) before starting the rolling upgrade. + 1. [Remove a node]({{< relref "/operate/rs/clusters/remove-node#remove-a-node" >}}) with the earlier OS version from the cluster. 1. Uninstall Redis Enterprise Software from the removed node: