Skip to content

Commit 3daa731

Browse files
copy edits
1 parent fac46a6 commit 3daa731

File tree

3 files changed

+74
-19
lines changed

3 files changed

+74
-19
lines changed

content/operate/kubernetes/upgrade/_index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
Title: Upgrade Redis Enterprise for Kubernetes 7.8.2-6
2+
Title: Upgrade Redis Enterprise for Kubernetes
33
alwaysopen: false
44
categories:
55
- docs
@@ -27,11 +27,11 @@ For all other Kubernetes distributions, see [Upgrade Redis Enterprise for Kubern
2727

2828
When upgrading, both your Kubernetes version and Redis operator version need to be supported at all times.
2929

30-
{{<warning>}}If your current Kubernetes distribution is not [supported by 7.8.2-6]({{<relref "/operate/kubernetes/release-notes/7-8-2-releases/7-8-2-6-nov24#supported-distributions">}}), upgrade to a supported distribution before upgrading. {{</warning>}}
30+
{{<warning>}}If your current Kubernetes distribution is not [supported]({{<relref "/operate/kubernetes/reference/supported_k8s_distributions.md">}}), upgrade to a supported distribution before upgrading. {{</warning>}}
3131

3232
## RHEL9-based image
3333

34-
Redis Enterprise images are now based on Red Hat Enterprise Linux 9 (RHEL9). This means upgrades to 7.8.2-6 require:
34+
Redis Enterprise images are now based on Red Hat Enterprise Linux 9 (RHEL9). This means upgrades require:
3535

3636
- [Cluster version of 7.4.2-2 or later](https://redis.io/docs/latest/operate/kubernetes/7.4.6/upgrade/).
3737
- Database version 7.2 or later.

content/operate/kubernetes/upgrade/openshift-cli.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
Title: Upgrade Redis Enterprise 7.8.2-6 with OpenShift CLI
2+
Title: Upgrade Redis Enterprise with OpenShift CLI
33
alwaysopen: false
44
categories:
55
- docs
@@ -19,25 +19,25 @@ Redis implements rolling updates for software upgrades in Kubernetes deployments
1919

2020
## Prerequisites
2121

22-
The following steps ensure you have the minimum versions of all components necessary to upgrade to 7.8.2-6. **Without these minimum versions, the upgrade will freeze and require manual recovery.**
22+
The following steps ensure you have the minimum versions of all components necessary to upgrade to 7.8.2-6 or later. **Without these minimum versions, the upgrade will freeze and require manual recovery.**
2323

2424
See the [troubleshooting](#troubleshooting) section for details on recovering a failed upgrade.
2525

2626
### Kubernetes version
2727

28-
Check [Supported Kubernetes distributions]({{<relref "/operate/kubernetes/reference/supported_k8s_distributions" >}}) to make sure your Kubernetes distribution is supported by 7.8.2-6. If not, upgrade your Kubernetes distribution before upgrading the Redis operator.
28+
Check [Supported Kubernetes distributions]({{<relref "/operate/kubernetes/reference/supported_k8s_distributions" >}}) to make sure your Kubernetes distribution is supported. If not, upgrade your Kubernetes distribution before upgrading the Redis operator.
2929

3030
### Redis operator version
3131

32-
Your Redis Enterprise clusters must be running version 7.4.2-2 or later before upgrading to 7.8.2-6. See the [7.4 upgrade](https://redis.io/docs/latest/operate/kubernetes/7.4.6/upgrade/openshift-cli/) for detailed steps.
32+
Your Redis Enterprise clusters must be running version 7.4.2-2 or later before upgrading to 7.8.2-6 or later. See the [7.4 upgrade](https://redis.io/docs/latest/operate/kubernetes/7.4.6/upgrade/openshift-cli/) for detailed steps.
3333

3434
### Redis database version
3535

36-
Your Redis databases must be running version 7.2 or later before upgrading your cluster version to 7.8.2-6. See [upgrade databases](#upgrade-databases) for detailed steps. You can find your database version in the [REDB `spec.redisVersion` field]({{<relref "/operate/kubernetes/reference/redis_enterprise_database_api#redisversion" >}}).
36+
Your Redis databases must be running version 7.2 or later before upgrading your cluster version. See [upgrade databases](#upgrade-databases) for detailed steps. You can find your database version in the [REDB `spec.redisVersion` field]({{<relref "/operate/kubernetes/reference/redis_enterprise_database_api#redisversion" >}}).
3737

3838
### RHEL9-compatible modules
3939

40-
Upgrading to Redis operator version 7.8.2-6 involves migrating your Redis Enterprise nodes to RHEL9 from either Ubuntu 18 or RHEL8. If your databases use modules, you need to manually install modules compatible with RHEL9.
40+
Upgrading to Redis operator versions 7.8.2-6 and later involves migrating your Redis Enterprise nodes to RHEL9 from either Ubuntu 18 or RHEL8. If your databases use modules, you need to manually install modules compatible with RHEL9.
4141

4242
To see which modules you have installed, run:
4343

@@ -204,7 +204,7 @@ oc rollout status sts <REC_name>
204204
205205
### Upgrade databases
206206
207-
After the cluster is upgraded, you can upgrade your databases. Specify your new database version in the `spec.redisVersion` field for your REDB and REAADB custom resources. Supported database versions for operator version 7.8.2-6 include `"7.2"` and `"7.4"` (note this value is a string).
207+
After the cluster is upgraded, you can upgrade your databases. Specify your new database version in the `spec.redisVersion` field for your REDB and REAADB custom resources. Supported database versions include `"7.2"` and `"7.4"` (note this value is a string).
208208
209209
Note that if your cluster [`redisUpgradePolicy`]({{<relref "/operate/kubernetes/reference/redis_enterprise_cluster_api#redisupgradepolicy" >}}) or your database [`redisVersion`]({{< relref "/operate/kubernetes/reference/redis_enterprise_database_api#redisversion" >}}) are set to `major`, you won't be able to upgrade those databases to minor versions. See [Redis upgrade policy]({{< relref "/operate/rs/installing-upgrading/upgrading#redis-upgrade-policy" >}}) for more details.
210210

content/operate/kubernetes/upgrade/upgrade-olm.md

Lines changed: 64 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
Title: Upgrade Redis Enterprise 7.8.2-6 with OpenShift OperatorHub
2+
Title: Upgrade Redis Enterprise with OpenShift OperatorHub
33
alwaysopen: false
44
categories:
55
- docs
@@ -13,19 +13,19 @@ weight: 40
1313

1414
Redis implements rolling updates for software upgrades in Kubernetes deployments. The upgrade process includes updating three components:
1515

16-
1. [Upgrade the Redis Enterprise operator](#upgrade-the-operator)
16+
1. [Upgrade the Redis Enterprise operator](#upgrade-the-redis-enterprise-operator)
1717
1. [Upgrade the Redis Enterprise cluster (REC)](#upgrade-the-redis-enterprise-cluster-rec)
1818
1. [Upgrade Redis Enterprise databases (REDB)](#upgrade-databases)
1919

2020
## Prerequisites
2121

22-
The following steps ensure you have the minimum versions of all components necessary to upgrade to 7.8.2-6. **Without these minimum versions, the upgrade will freeze and require manual recovery.**
22+
The following steps ensure you have the minimum versions of all components necessary to upgrade. **Without these minimum versions, the upgrade will freeze and require manual recovery.**
2323

2424
See the [troubleshooting](#troubleshooting) section for details on recovering a failed upgrade.
2525

2626
### Kubernetes version
2727

28-
Check [Supported Kubernetes distributions]({{<relref "/operate/kubernetes/reference/supported_k8s_distributions" >}}) to make sure your Kubernetes distribution is supported by 7.8.2-6. If not, upgrade your Kubernetes distribution before upgrading the Redis operator.
28+
Check [Supported Kubernetes distributions]({{<relref "/operate/kubernetes/reference/supported_k8s_distributions" >}}) to make sure your Kubernetes distribution is supported. If not, upgrade your Kubernetes distribution before upgrading the Redis operator.
2929

3030
### Redis operator version
3131

@@ -37,7 +37,7 @@ Your Redis databases must be running version 7.2 or later before upgrading your
3737

3838
### RHEL9-compatible modules
3939

40-
Upgrading to Redis operator version 7.8.2-6 involves migrating your Redis Enterprise nodes to RHEL9 from either Ubuntu 18 or RHEL8. If your databases use modules, you need to manually install modules compatibile with RHEL9.
40+
Upgrading to Redis operator version 7.8.2-6 or later involves migrating your Redis Enterprise nodes to RHEL9 from either Ubuntu 18 or RHEL8. If your databases use modules, you need to manually install modules compatible with RHEL9.
4141

4242
To see which modules you have installed, run:
4343

@@ -65,17 +65,17 @@ Use `kubectl get rec` and verify the `LICENSE STATE` is valid on your REC before
6565

6666
3. Verify your **Update approval** is set to "Manual".
6767

68-
4. If you wish to upgrade to the most recent version, set your **Update channel** to "production". If you wish to upgrade to an older version, select it for your Update channel.
68+
4. To upgrade to the latest version, set your **Update Channel** to production’. To upgrade to an older version, specify the desired version for your **Update Channel**.
6969

7070
5. Select **Upgrade available** shown under **Upgrade status**.
7171

7272
6. When the "Review manual InstallPlan" section appears, select **Preview installPlan** and then **Approve** after reviewing the details. This will start the operator upgrade.
7373

74-
You can monitor the upgrade from the **Installed Operators** page. A new Redis Enterprise Operator will appear in the list, with the status "Installing". The OpenShift will delete the old operator, showing the "Cannot update" status during deletion.
74+
You can monitor the upgrade from the **Installed Operators** page. A new Redis Enterprise Operator will appear in the list, with the status "Installing". OpenShift will delete the old operator, showing the "Cannot update" status during deletion.
7575

7676
## Reapply the SCC
7777

78-
If you are using OpenShift, you will also need to manually reapply the [security context constraints](https://docs.openshift.com/container-platform/4.8/authentication/managing-security-context-constraints.html) file ([`scc.yaml`]({{< relref "/operate/kubernetes/deployment/openshift/openshift-cli#deploy-the-operator" >}})) and bind it to your service account.
78+
If you are using OpenShift, you must manually reappply the [security context constraints (SCC)](https://docs.openshift.com/container-platform/4.8/authentication/managing-security-context-constraints.html) file ([`scc.yaml`]({{< relref "/operate/kubernetes/deployment/openshift/openshift-cli#deploy-the-operator" >}})) and bind it to your service account.
7979

8080
```sh
8181
oc apply -f openshift/scc.yaml
@@ -88,9 +88,64 @@ oc adm policy add-scc-to-user redis-enterprise-scc-v2 \
8888

8989
### Upgrade databases
9090

91-
After the cluster is upgraded, you can upgrade your databases. Specify your new database version in the `spec.redisVersion` field for your REDB and REAADB custom resources. Supported database versions for operator version 7.8.2-6 include `"7.2"` and `"7.4"` (note this value is a string).
91+
After the cluster is upgraded, you can upgrade your databases. Specify your new database version in the `spec.redisVersion` field for your REDB and REAADB custom resources. Supported database versions for this operator version include `"7.2"` and `"7.4"` (note this value is a string).
9292

9393
Note that if your cluster [`redisUpgradePolicy`]({{<relref "/operate/kubernetes/reference/redis_enterprise_cluster_api#redisupgradepolicy" >}}) or your database [`redisVersion`]({{< relref "/operate/kubernetes/reference/redis_enterprise_database_api#redisversion" >}}) are set to `major`, you won't be able to upgrade those databases to minor versions. See [Redis upgrade policy]({{< relref "/operate/rs/installing-upgrading/upgrading#redis-upgrade-policy" >}}) for more details.
94+
The Redis Enterprise cluster (REC) can be updated automatically or manually. To trigger automatic upgrade of the REC after the operator upgrade completes, specify `autoUpgradeRedisEnterprise: true` in your REC spec. If you don't have automatic upgrade enabled, follow the below steps for the manual upgrade.
95+
96+
Before beginning the upgrade of the Redis Enterprise cluster, check the [Redis Enterprise for Kubernetes release notes]({{<relref "/operate/kubernetes/release-notes/7-8-2-releases">}}) to find the Redis Enterprise image tag.
97+
98+
After the operator upgrade is complete, you can upgrade Redis Enterprise cluster (REC).
99+
100+
### Upgrade an REC with an Active-Active database
101+
102+
We recommend upgrading all participating clusters to the same operator version.
103+
104+
If you are upgrading from a preview version of the Active-Active controller, you can remove the following environment variables: `ACTIVE_ACTIVE_DATABASE_CONTROLLER_ENABLED`, `REMOTE_CLUSTER_CONTROLLER_ENABLED`, and `ENABLE_ALPHA_FEATURES`.
105+
106+
### Edit `redisEnterpriseImageSpec` in the REC spec
107+
108+
1. Edit the REC custom resource YAML file.
109+
110+
```sh
111+
kubectl edit rec <your-rec.yaml>
112+
```
113+
114+
1. Replace the `versionTag:` declaration under `redisEnterpriseImageSpec` with the new version tag.
115+
116+
```YAML
117+
spec:
118+
redisEnterpriseImageSpec:
119+
imagePullPolicy: IfNotPresent
120+
repository: redislabs/redis
121+
versionTag: <new-version-tag>
122+
```
123+
124+
1. Save the changes to apply.
125+
126+
### Reapply roles and role bindings
127+
128+
If your operator is monitoring multiple namespaces, you'll need to [reapply your role and role bindings]({{< relref "/operate/kubernetes/re-clusters/multi-namespace#create-role-and-role-binding-for-managed-namespaces" >}}) for each managed namespace. See [Manage databases in multiple namespaces]({{< relref "/operate/kubernetes/re-clusters/multi-namespace" >}}) for more details.
129+
130+
### Monitor the upgrade
131+
132+
You can view the state of the REC with `kubectl get rec`.
133+
134+
During the upgrade, the state should be `Upgrade`.
135+
When the upgrade is complete and the cluster is ready to use, the state will change to `Running`.
136+
If the state is `InvalidUpgrade`, there is an error (usually relating to configuration) in the upgrade.
137+
138+
```sh
139+
$ kubectl get rec
140+
NAME NODES VERSION STATE SPEC STATUS LICENSE STATE SHARDS LIMIT LICENSE EXPIRATION DATE AGE
141+
rec 3 6.2.10-107 Upgrade Valid Valid 4 2022-07-16T13:59:00Z 92m
142+
```
143+
144+
To see the status of the current rolling upgrade, run:
145+
146+
```sh
147+
kubectl rollout status sts <REC_name>
148+
```
94149
95150
## Troubleshooting
96151

0 commit comments

Comments
 (0)