From 93791a04ba53d677835eede5209323121ac4154f Mon Sep 17 00:00:00 2001 From: Rachel Elledge Date: Thu, 28 May 2026 17:21:33 -0500 Subject: [PATCH] DOC-6666 RS & k8s: Enabling clustering for Active-Active DBs after creation --- .../kubernetes/active-active/create-reaadb.md | 5 ++++- .../operate/rs/databases/active-active/create.md | 15 ++++++++++++--- .../rs/databases/active-active/get-started.md | 15 ++++++++++++--- .../operate/rs/databases/active-active/manage.md | 14 +++++++++++++- 4 files changed, 41 insertions(+), 8 deletions(-) diff --git a/content/operate/kubernetes/active-active/create-reaadb.md b/content/operate/kubernetes/active-active/create-reaadb.md index 842e804dbb..764dfa938f 100644 --- a/content/operate/kubernetes/active-active/create-reaadb.md +++ b/content/operate/kubernetes/active-active/create-reaadb.md @@ -89,7 +89,10 @@ Example REAADB named `reaadb-boeing` linked to the REC named `rec-chicago` with {{}} -{{}}Sharding is disabled on Active-Active databases created with a `shardCount` of 1. Sharding cannot be enabled after database creation. {{}} +{{}} +- Sharding is disabled on Active-Active databases created with a `shardCount` of 1. +- To enable sharding after database creation, update the `shardCount` in the REAADB file. Using other methods could cause data synchronization issues. +{{}} For more details on RERC fields, see the [RERC API reference]({{}}). diff --git a/content/operate/rs/databases/active-active/create.md b/content/operate/rs/databases/active-active/create.md index c770f22013..c5c6745456 100644 --- a/content/operate/rs/databases/active-active/create.md +++ b/content/operate/rs/databases/active-active/create.md @@ -173,9 +173,18 @@ After you create the Active-Active database, you can set the TLS mode to **Requi - Clear the **Enable sharding** option to use only one shard, which allows you to use [multi-key operations]({{}}) without the limitations. - {{}} -You cannot enable or turn off database clustering after the Active-Active database is created. - {{}} + {{}} +You cannot turn off database clustering after the Active-Active database is created. + {{}} + + To enable clustering after the Active-Active database is created, use the [`crdb-cli crdb update`]({{< relref "/operate/rs/references/cli-utilities/crdb-cli/crdb/update" >}}) command to update `shards_count`: + + ```sh + crdb-cli crdb update --crdb-guid --default-db-config '{"shards_count": }' + ``` + {{< warning >}} +Do not increase the shard count using other methods, as they could cause data synchronization issues. + {{< /warning >}} - [**OSS Cluster API**]({{< relref "/operate/rs/databases/configure/oss-cluster-api.md" >}}) - The OSS Cluster API configuration allows access to multiple endpoints for increased throughput. The OSS Cluster API setting applies to all instances of the Active-Active database across participating clusters. diff --git a/content/operate/rs/databases/active-active/get-started.md b/content/operate/rs/databases/active-active/get-started.md index c90333be59..82385a5a03 100644 --- a/content/operate/rs/databases/active-active/get-started.md +++ b/content/operate/rs/databases/active-active/get-started.md @@ -145,9 +145,18 @@ Each Active-Active instance must have a unique fully-qualified domain name (FQDN - Turn off **Sharding** to use only one shard and avoid [Multi-key command]({{< relref "/operate/rs/databases/durability-ha/clustering" >}}) limitations. - {{< note >}} -You cannot enable or turn off database clustering after the Active-Active database is created. - {{< /note >}} + {{< note >}} +You cannot turn off database clustering after the Active-Active database is created. + {{< /note >}} + + To enable clustering after the Active-Active database is created, use the [`crdb-cli crdb update`]({{< relref "/operate/rs/references/cli-utilities/crdb-cli/crdb/update" >}}) command to update `shards_count`: + + ```sh + crdb-cli crdb update --crdb-guid --default-db-config '{"shards_count": }' + ``` + {{< warning >}} +Do not increase the shard count using other methods, as they could cause data synchronization issues. + {{< /warning >}} 1. Click **Create**. diff --git a/content/operate/rs/databases/active-active/manage.md b/content/operate/rs/databases/active-active/manage.md index 02b7819328..0cc02a4f14 100644 --- a/content/operate/rs/databases/active-active/manage.md +++ b/content/operate/rs/databases/active-active/manage.md @@ -15,7 +15,7 @@ You can configure and manage your Active-Active database from either the Cluster ## Database settings -Most Active-Active database settings can be changed after database creation. One notable exception is database clustering, which can't be turned on or off after the database has been created. +Most Active-Active database settings can be changed after database creation, except for database clustering, which can't be turned off later. As of Redis Software version 8.0.16, the Cluster Manager UI supports both [global](#change-global-configuration) and [local](#change-local-configuration) configuration changes for Active-Active databases. In earlier versions, configuration changes made in the Cluster Manager UI applied only to the local instance and required additional manual updates for each participating cluster. @@ -105,6 +105,18 @@ On the **Local** configuration tab, any locally configured settings that differ {{A local configuration label appears next to Memory eviction allkeys-lru.}} +### Enable clustering after database creation + +To enable clustering after the Active-Active database is created, use the [`crdb-cli crdb update`]({{< relref "/operate/rs/references/cli-utilities/crdb-cli/crdb/update" >}}) command to update `shards_count`: + +```sh +crdb-cli crdb update --crdb-guid --default-db-config '{"shards_count": }' +``` + +{{< warning >}} +Do not use other methods to enable clustering after database creation, as they could cause data synchronization issues. +{{< /warning >}} + ## Participating clusters You can add and remove participating clusters of an Active-Active database to change the topology.