RS: Added detailed instructions to update Active-Active DB admin credentials

content/operate/rs/security/access-control/manage-passwords/active-active-admin-credentials.md

@@ -10,14 +10,46 @@ linkTitle: Update Active-Active admin credentials
 weight: 90
 ---
 
-Active-Active databases use administrator credentials to manage operations.
+Active-Active databases use administrator credentials to manage operations. When you change the administrator password on clusters with Active-Active databases, you must update the Active-Active database configuration to prevent authentication failures during Active-Active management operations.
 
-To update the administrator user password on a cluster with Active-Active databases:
+{{<warning>}}
+Do not perform any management operations on the databases until these steps are complete.
+{{</warning>}}
+
+To update the administrator password on a cluster with Active-Active databases:
 
 1. From the user management page, update the administrator user password on the clusters you want to update.
 
-1. For each participating cluster _and_ each Active-Active database, update the admin user credentials to match the changes in step 1. 
+1. Run [`crdb-cli crdb list`]({{<relref "/operate/rs/references/cli-utilities/crdb-cli/crdb/list">}}) to find the `CRDB-GUID` that uniquely identifies each Active-Active database and the fully qualified domain names (`FQDN`) of each participating cluster:
 
-{{<warning>}}
-Do not perform any management operations on the databases until these steps are complete.
-{{</warning>}}
+    ```sh
+    crdb-cli crdb list
+    ```
+
+    Example output:
+
+    ```sh
+    CRDB-GUID                             NAME        REPL-ID  FQDN
+    4053a0dd-a4a5-4f38-b135-75b7a2dc7331  my-aa-db    1        fqdn1.example.com
+    4053a0dd-a4a5-4f38-b135-75b7a2dc7331  my-aa-db    2        fqdn2.example.com
+    ```
+
+1. Update the Active-Active database credentials using the [`crdb-cli crdb update`]({{< relref "/operate/rs/references/cli-utilities/crdb-cli/crdb/update" >}}) command:
+
+    ```sh
+    crdb-cli crdb update \
+      --crdb-guid <CRDB-GUID> \
+      --credentials id=<REPL-ID-1>,username=<admin-username>,password=<FQDN-1-password> \
+      --credentials id=<REPL-ID-2>,username=<admin-username>,password=<FQDN-2-password> \
+      --force
+    ```
+
+    Replace the following values:
+
+    - `<CRDB-GUID>`: The `CRDB-GUID` from the `crdb-cli crdb list` output
+
+    - `<admin-username>`: The administrator username for the clusters
+
+    - `<REPL-ID-1>` and `<REPL-ID-2>`: The `REPL-ID` for the corresponding FQDNs
+
+    - `<FQDN-1-password>` and `<FQDN-2-password>`: The current administrator passwords for each cluster