Skip to content

RC: Version managment phase B #1374

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

Open
wants to merge 22 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/operate/rc/changelog/april-2025.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,4 +25,4 @@ The new user interface and dark mode are currently available for selected accoun

### Map multiple Redis Cloud accounts to marketplace account

You can now map multiple Redis Cloud accounts to a single [Google Cloud Marketplace]({{< relref "/operate/rc/cloud-integrations/gcp-marketplace/" >}}) or [AWS Marketplace]({{< relref "/operate/rc/cloud-integrations/aws-marketplace/" >}}) account.
You can now map multiple Redis Cloud accounts to a single [Google Cloud Marketplace]({{< relref "/operate/rc/cloud-integrations/gcp-marketplace/" >}}) or [AWS Marketplace]({{< relref "/operate/rc/cloud-integrations/aws-marketplace/" >}}) account.
23 changes: 23 additions & 0 deletions content/operate/rc/changelog/may-2025.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
Title: Redis Cloud changelog (May 2025)
alwaysopen: false
categories:
- docs
- operate
- rc
description: New features, enhancements, and other changes added to Redis Cloud during
April 2025.
highlights: Upgrade database version for a single Pro database
linktitle: May 2025
weight: 30
---

## New features

### Upgrade database version for a single Pro database

Selected accounts can now upgrade a single Pro database to a later version. From the database page or database list, select **More actions > Version upgrade** to upgrade your database.

{{<image filename="images/rc/databases-more-actions-menu.png" alt="The More Actions menu on the Database page." width=40% >}}

See [Upgrade database version]({{< relref "/operate/rc/databases/upgrade-version" >}}) for more information.
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,6 @@ The **Setup** tab specifies general settings for your Redis deployment.
There are three sections on this tab:

- [General settings](#general-settings) include the cloud provider details and specific configuration options.
- [Version](#version) lets you choose the Redis version of your databases.
- [Advanced options](#advanced-options) define settings for high availability and security. Configurable settings vary according to cloud provider.

#### General settings {#general-settings}
Expand All @@ -77,12 +76,6 @@ You can use a region's Remove button to remove it from the list.

{{<image filename="images/rc/icon-region-delete.png" width="30px" alt="Select the Delete button to remove a region from the list." >}}

#### Version {#version}

{{<image filename="images/rc/subscription-new-flexible-version-section.png" width="75%" alt="Version selection between Redis 6.2 and 7.2" >}}

The **Version** section lets you choose the Redis version of your databases. Choose **Redis 7.4** if you want to use the latest advanced features of Redis.

#### Advanced options {#advanced-options}

{{<image filename="images/rc/create-sub-active-active-cidr.png" width="75%" alt="Each region needs a unique CIDR address block to communicate securely with other instances." >}}
Expand Down Expand Up @@ -124,6 +117,7 @@ This opens the **New Active-Active Redis Database** dialog, which lets you defin
By default, you're shown basic settings, which include:

- **Name**: A custom name for your database.
- **Version**: The Redis version for your database. We recommend you choose the latest available version.
- **Advanced Capabilities**: Advanced data types or features used by the database. Active-Active databases support the [JSON]({{< relref "/operate/oss_and_stack/stack-with-enterprise/json" >}}) data type and [Search and query]({{< relref "/operate/oss_and_stack/stack-with-enterprise/search" >}}) features.

{{<image filename="images/rc/active-active-json-detail.png" width="75%" alt="When you create an Active-Active database, you can select the JSON and Search and query advanced capabilities." >}}
Expand All @@ -136,6 +130,8 @@ By default, you're shown basic settings, which include:

For Search and query databases, use the [Sizing calculator](https://redis.io/redisearch-sizing-calculator/) to estimate your index size and throughput requirements. When you're entering the dataset size for your database, add the estimated index size from the Sizing calculator to your expected dataset size.

- **Hashing policy**: Determines how data is distributed across multiple Redis processes of a database. Available options depend on your account creation date. See [Clustering]({{< relref "/operate/rc/databases/configuration/clustering#manage-the-hashing-policy" >}}) for more information.

- **Throughput**: When you create an Active-Active database, you define the throughput for each instance. The total operations per second combines the total read ops/sec and applies the write ops/sec for each region across every region.

{{<image filename="images/rc/active-active-throughput-detail.png" width="75%" alt="When you create an Active-Active database, you define throughput for each region." >}}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ The available settings vary according to your subscription plan:
| **Auto Tiering** | Checked when the subscription supports Auto Tiering |
| **Database name** | A name for your database (_required_) |
| **Database port** | Automatically or manually assigns a database port (range: 10000-19999). You cannot assign a port that is reserved or already in use. |
| **Database version** | The Redis version of your database. We recommend you choose the latest available version. |
| **Type** | Controls advanced database capabilities and protocol. Supported values include _Redis_ and _Memcached_ |
| **Advanced capabilities** | Advanced data types used by the database. Choose from [Search and query]({{< relref "/operate/oss_and_stack/stack-with-enterprise/search" >}}), [JSON]({{< relref "/operate/oss_and_stack/stack-with-enterprise/json" >}}), [Time series]({{< relref "/operate/oss_and_stack/stack-with-enterprise/timeseries" >}}), or [Probabilistic]({{< relref "/operate/oss_and_stack/stack-with-enterprise/bloom" >}}). <br/> Databases with Search and query have specific sizing requirements, see [Search and query sizing]({{< relref "/operate/rc/databases/configuration/advanced-capabilities#search-and-query-sizing" >}}) for more information. |
| **Query performance factor** | *(Search and query databases on Redis 7.2 or later only)* Adds additional compute power to process your query and vector search workloads and boost your queries per second. See [Search and query sizing]({{< relref "/operate/rc/databases/configuration/advanced-capabilities#search-and-query-sizing" >}}) for more information. |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -93,10 +93,9 @@ The **Setup** tab specifies general settings for your Redis deployment.

{{<image filename="images/rc/subscription-new-flexible-tabs-setup.png" width="75%" alt="The Setup tab of the new Pro Database process." >}}

There are three sections on this tab:
There are two sections on this tab:

- [General settings](#general-settings) include the cloud provider details and specific configuration options.
- [Version](#version) lets you choose the Redis version of your databases.
- [Advanced options](#advanced-options) define settings for high availability and security. Configurable settings vary according to cloud provider.

#### General settings {#general-settings}
Expand All @@ -113,12 +112,6 @@ In the **General settings** of the **Setup** tab, you need to:
This guide is for single region database deployment. If you want to create a multi-region Active-Active database, see [Create an Active-Active database]({{< relref "/operate/rc/databases/create-database/create-active-active-database" >}}) for specific steps and configuration options exclusive to Active-Active.
{{< /note >}}

#### Version {#version}

{{<image filename="images/rc/subscription-new-flexible-version-section.png" width="75%" alt="Version selection between Redis 6.2, 7.2, and 7.4." >}}

The **Version** section lets you choose the Redis version of your databases. Choose **Redis 7.4** if you want to use the latest stable version of Redis.

#### Advanced options {#advanced-options}

{{<image filename="images/rc/subscription-new-flexible-setup-advanced.png" width="75%" alt="The Advanced settings of the Setup tab." >}}
Expand Down Expand Up @@ -158,6 +151,7 @@ By default, you're shown basic settings, which include:
| Database&nbsp;setting | Description |
|:---------|:-----------|
| **Name** | A custom name for your database (_required_) |
| **Version** | The Redis version for your database. We recommend you choose the latest available version. |
| **Dataset size (GB)** | The amount of data for your dataset. Specify small sizes as decimals of 1.0&nbsp;GB; example: `0.1` GB (minimum). We calculate the total memory limit for you based on the other settings you choose for your database. <br/> Databases with Search and query have specific sizing requirements, see [Search and query sizing]({{< relref "/operate/rc/databases/configuration/advanced-capabilities#search-and-query-sizing" >}}) for more information. |
| **High Availability** | Indicates whether a replica copy of the database is maintained in case the primary database becomes unavailable. (Warning: Doubles memory consumption). See [High Availability]({{< relref "/operate/rc/databases/configuration/high-availability" >}}). |
| **Throughput** | Identifies maximum throughput for the database, which is specified in terms of operations per second (**Ops/sec**). See [Throughput]({{< relref "/operate/rc/databases/configuration/sizing#throughput" >}}) for more information. <br/> Databases with Search and query have specific throughput requirements. See [Search and query sizing]({{< relref "/operate/rc/databases/configuration/advanced-capabilities#search-and-query-sizing" >}}) for more information. |
Expand Down
80 changes: 80 additions & 0 deletions content/operate/rc/databases/upgrade-version.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
Title: Upgrade Redis database version
alwaysopen: false
categories:
- docs
- operate
- rc
description: Describes when you can upgrade your database to the latest available version for each plan type.
linkTitle: Upgrade database version
weight: 37
---

Database version upgrade options depend on your plan type.

## Redis Cloud Essentials

All new Redis Cloud Essentials databases are on the latest available version of Redis. Redis will notify Redis Cloud Essentials users when a new database version is available.

## Redis Cloud Pro

You can upgrade Redis Cloud Pro databases that are not on the latest available version of Redis to a later version at any time.

{{< note >}}
Please keep in mind the following before upgrading your database version:

- We recommend that you [back up your data]({{< relref "/operate/rc/databases/back-up-data" >}}) before upgrading to make it easier to [manually revert the upgrade](#manually-revert-upgrade) if needed.

- We recommend that you upgrade your database during off-peak hours or during application maintenance.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- We recommend that you upgrade your database during off-peak hours or during application maintenance.
- We recommend that you upgrade your database during off-peak hours or during application maintenance to minimize reconnections.

@NoamSternRedis WDYT?


- Review the breaking changes for the new database version before upgrading:
- [Redis 7.2]({{< relref "/operate/rc/changelog/2023/june-2023#redis-72-breaking-changes" >}})
- [Redis 7.4]({{< relref "/operate/rc/changelog/july-2024#redis-74-breaking-changes" >}})

- You must upgrade the target database in an [Active-Passive]({{< relref "/operate/rc/databases/migrate-databases#sync-using-active-passive" >}}) setup before you upgrade the source database to prevent compatibility issues.
{{< /note >}}

### Upgrade Redis Cloud Pro database

To upgrade a Redis Cloud Pro database:

1. Choose your database from the **Databases** list to open your database page. Select **More actions > Version upgrade**.

{{<image filename="images/rc/databases-more-actions-menu.png" alt="The More Actions menu on the Database page." width=40% >}}

You can also select **More actions > Version upgrade** from the database list.

1. Select the target version from the **Select version** list.

{{<image filename="images/rc/database-version-upgrade.png" alt="The Redis version upgrade screen." width=80% >}}

If your database has not been backed up before, we recommend that you back up your database. Select **Go to backup** to go to the [backup settings]({{< relref "/operate/rc/databases/back-up-data" >}}).

1. Select **Upgrade** to start the upgrade.

{{<image filename="images/rc/button-upgrade.png" alt="The upgrade button." width=100px >}}

The database will start upgrading to the selected version immediately. The upgrade may take a few minutes.

You can continue to use the Redis Cloud console for other tasks during the upgrade.

### Manually revert upgrade

Automatically reverting to a previous Redis version is not supported on Redis Cloud.

If you [backed up your database]({{< relref "/operate/rc/databases/back-up-data" >}}) before you upgraded your version, you can:

1. [Delete your database]({{< relref "/operate/rc/databases/delete-database" >}}) without deleting your subscription.
1. [Create a new database]({{< relref "/operate/rc/databases/create-database/create-pro-database-existing" >}}) in your subscription with the following settings:
- **Port number**: Use the same port number as the old database.
- **Version**: Select the original version of Redis.
1. [Import the backup files]({{< relref "/operate/rc/databases/import-data" >}}) into the new database.

This allows you to connect to the database on the previous version without changing your connection details in your application.

If you did not back up your database before upgrading:

1. [Back up your database]({{< relref "/operate/rc/databases/back-up-data" >}}).
1. [Create a new database]({{< relref "/operate/rc/databases/create-database/create-pro-database-existing" >}}) in your subscription and select the original version of Redis.
1. [Import the backup files]({{< relref "/operate/rc/databases/import-data" >}}) into the new database.
1. Change connection details in your application from the old database to the new database.
2 changes: 1 addition & 1 deletion content/operate/rc/databases/view-edit-database.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@ You can:

{{<image filename="images/rc/icon-export-to-csv.png" alt="The Export button exports the current list view to CSV." >}}

- Sort the list in descending or ascending order using the arrow displayed to right of the field name in the header. Supported fields include **Subscription**, **Database name**, **Memory**, and **Tags**.
- Sort the list in descending or ascending order using the arrow displayed to right of the field name in the header. Supported fields include **Subscription**, **Database name**, **Memory usage**, and **Version**.

{{<image filename="images/rc/icon-list-sort-asc.png#no-click" alt="Use the arrows in the list header to sort the list." class="inline">}} {{<image filename="images/rc/icon-list-sort-desc.png#no-click" alt="The direction of the arrow corresponds to the direction of the sort." class="inline">}}

Expand Down
2 changes: 0 additions & 2 deletions content/operate/rc/subscriptions/view-pro-subscription.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,6 @@ From here, you can:

{{<image filename="images/rc/icon-database-status-active.png#no-click" alt="When a subscription is active, the status icon displays a green circle with a checkmark." class="inline" >}} &nbsp; {{<image filename="images/rc/icon-subscription-status-pending.png#no-click" alt="When a subscription is pending, the status icon displays a gre, animated circle." class="inline">}}

- {{< embed-md "rc-version-upgrade.md" >}}

Because subscriptions represent active deployments, there aren't many details you can change. If your needs change, [create a new subscription]({{< relref "/operate/rc/databases/create-database/create-pro-database-new" >}}) and then [migrate the existing data]({{< relref "/operate/rc/databases/migrate-databases" >}}) to the new databases.

In addition, three tabs are available:
Expand Down
Binary file added static/images/rc/button-upgrade.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/images/rc/create-database-active-active.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/images/rc/database-new-flexible.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/rc/database-version-upgrade.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/rc/databases-more-actions-menu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/images/rc/flexible-add-database-basic.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.