Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

RS: Upgrade paths & bundled DB versions #2669

Merged
merged 9 commits into from
Jul 31, 2023
Merged
5 changes: 3 additions & 2 deletions content/rs/installing-upgrading/upgrading/upgrade-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,9 @@ The following upgrade paths are supported:

| Current<br/>cluster version | Upgrade to<br/>cluster version |
|:-----:|:-----:|
| 6.2.x | 6.4.2 |
| 6.0.x | 6.4.2<br />6.2.x |
| 6.4.x | 7.2 |
| 6.2.x | 7.2<br />6.4.x |
| 6.0.x | 7.2<br />6.4.x<br />6.2.x |
| 5.6 | 6.0.x |

## Upgrade prerequisites
Expand Down
45 changes: 30 additions & 15 deletions content/rs/installing-upgrading/upgrading/upgrade-database.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,21 @@ aliases:

When you upgrade an existing database or create a new one, it uses the default Redis version (`default_redis_version`) unless you specify the database version explicitly with `redis_version` in the [REST API]({{<relref "/rs/references/rest-api/requests/bdbs">}}) or [`rladmin upgrade db`]({{<relref "/rs/references/cli-utilities/rladmin/upgrade#upgrade-db">}}).

Redis Enterprise Software v6.x includes two Redis database versions: 6.0 and 6.2. The default Redis database version differs between Redis Enterprise releases as follows:
Redis Enterprise Software v6.x includes two Redis database versions: 6.0 and 6.2. As of version 7.2, Redis Enterprise Software includes three Redis database versions.

To view available Redis database versions:

- In the admin console, see **Redis database versions** on the **Cluster > Configuration** screen.

- Send a [`GET /nodes` REST API request]({{<relref "/rs/references/rest-api/requests/nodes">}}) and see `supported_database_versions` in the response.

The default Redis database version differs between Redis Enterprise releases as follows:

| Redis<br />Enterprise | Bundled Redis<br />DB versions | Default DB version<br />(upgraded/new databases) |
|-------|----------|-----|
| 6.2.x | 6.0, 6.2 | 6.0 |
| 6.4.2 | 6.0, 6.2 | 6.2 |
| 7.2 | 6.0, 6.2, 7.2 | 7.2 |

- v6.2.x: `default_redis_version` is 6.0.

Expand All @@ -29,11 +38,11 @@ Redis Enterprise Software v6.x includes two Redis database versions: 6.0 and 6.2

Both `major` and `latest` upgrade policies use this new default.

You can override the default version with [`rladmin tune cluster`]({{<relref "/rs/references/cli-utilities/rladmin/tune#tune-cluster">}}); however, this might limit future upgrade options:
```sh
rladmin tune cluster default_redis_version 6.0
```
You can override the default version with [`rladmin tune cluster default_redis_version <version>`]({{<relref "/rs/references/cli-utilities/rladmin/tune#tune-cluster">}}); however, this might limit future upgrade options.

- v7.2: `default_redis_version` is 7.2.

Both `major` and `latest` upgrade policies use this new default.

## Upgrade prerequisites

Expand All @@ -45,9 +54,9 @@ Before upgrading a database:

To determine the database version:

- Use the admin console to open the **Configuration** tab for the database.
- Use the admin console to open the **Configuration** tab for the database and select <img src="/images/rs/icons/info-icon.png#no-click" alt="The About database button" width="18px"> **About**.

- Use the [`rladmin status extra all`]({{<relref "/rs/references/cli-utilities/rladmin/status">}}) command to display configuration details:
- _(Optional)_ Use the [`rladmin status extra all`]({{<relref "/rs/references/cli-utilities/rladmin/status">}}) command to display configuration details:

```sh
rladmin status extra all
Expand All @@ -73,17 +82,23 @@ Before upgrading a database:

To upgrade a database:

1. Verify that the `redis_upgrade_policy` is set according to your preferences.

1. _(Optional)_ Back up the database to minimize data loss.

1. Use [`rladmin`]({{<relref "/rs/references/cli-utilities/rladmin/upgrade">}}) to upgrade the database:
1. Use [`rladmin`]({{<relref "/rs/references/cli-utilities/rladmin/upgrade">}}) to upgrade the database. During the upgrade process, the database will restart without losing any data.

- To upgrade a database without modules:

``` shell
rladmin upgrade db <database name | database ID>
```

``` shell
rladmin upgrade db <database name | database ID>
```
- If the database has modules enabled and new module versions are available in the cluster, run `rladmin upgrade db` with additional parameters to upgrade the module versions when you upgrade the database. See [Upgrade modules]({{<relref "/stack/install/upgrade-module">}}) for more details.

This restarts the database. No data is lost.
- To upgrade the database to a version other than the default version, use the `redis_version` parameter:

```sh
rladmin upgrade db <database name | database ID> redis_version <version>
```

1. Check the Redis database compatibility version for the database to confirm the upgrade.

Expand Down
Binary file added static/images/rs/icons/info-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.