Manage regions page

Author: cmilesb

content/embeds/rc-aa-cidr.md

@@ -0,0 +1,9 @@
+Every CIDR should be unique to properly route network traffic between each Active-Active database instance and your consumer VPCs. The CIDR block regions should _not_ overlap between the Redis server and your app consumer VPCs. In addition, CIDR blocks should not overlap between cluster instances. 
+
+When all **Deployment CIDR** regions display a green checkmark, you're ready to continue.  
+
+{{<image filename="images/rc/icon-cidr-address-ok.png" width="30px" alt="Green checkmarks indicate valid CIDR address values." >}}
+
+Red exclamation marks indicate error conditions; the tooltip provides additional details.
+
+{{<image filename="images/rc/icon-cidr-address-error.png" width="30px" alt="Red exclamation points indicate CIDR address problems." >}} 

content/operate/rc/databases/active-active/_index.md

@@ -1,5 +1,6 @@
 ---
 Title: Active-Active Redis
+linkTitle: Active-Active
 alwaysopen: false
 categories:
 - docs

content/operate/rc/databases/active-active/create-active-active-database.md

@@ -7,7 +7,7 @@ categories:
 - rc
 description: Shows how to create an Active-Active database
 linkTitle: Create Active-Active database
-weight: 20
+weight: 5
 aliases: 
     - /operate/rc/subscriptions/create-active-active-subscription
     - /operate/rc/databases/create-database/create-active-active-database
@@ -91,18 +91,10 @@ In the **Advanced options** section, you can:
 
 - Define CIDR addresses for each region in the **VPC configuration** section.
 
-    Every CIDR should be unique to properly route network traffic between each Active-Active database instance and your consumer VPCs. The CIDR block regions should _not_ overlap between the Redis server and your app consumer VPCs. In addition, CIDR blocks should not overlap between cluster instances. 
-
-    When all **Deployment CIDR** regions display a green checkmark, you're ready to continue.  
-
-    {{<image filename="images/rc/icon-cidr-address-ok.png" width="30px" alt="Green checkmarks indicate valid CIDR address values." >}}
-
-    Red exclamation marks indicate error conditions; the tooltip provides additional details.
-
-    {{<image filename="images/rc/icon-cidr-address-error.png" width="30px" alt="Red exclamation points indicate CIDR address problems." >}} 
-
-    If you chose to deploy your Active-Active database to an existing [Bring your own Cloud]({{< relref "/operate/rc/subscriptions/bring-your-own-cloud" >}}) account, you can also define the VPC ID for each region. Select **In existing VPC** and the set the VPC ID for each selected region. 
-
+    {{< embed-md "rc-aa-cidr.md" >}}
+    
+    If you chose to deploy your Active-Active database to an existing [Bring your own Cloud]({{< relref "/operate/rc/subscriptions/bring-your-own-cloud" >}}) account, you can also define the VPC ID for each region. Select **In existing VPC** and the set the VPC ID for each selected region.
+    
 - Set your [maintenance]({{< relref "/operate/rc/subscriptions/maintenance" >}}) settings in the **Maintenance windows** section. Select **Manual** if you want to set [manual maintenance windows]({{< relref "/operate/rc/subscriptions/maintenance/set-maintenance-windows" >}}).
 
 When finished, choose **Continue** to determine your size requirements.

content/operate/rc/databases/active-active/manage-regions.md

@@ -0,0 +1,90 @@
+---
+Title: Manage regions in Active-Active databases
+alwaysopen: false
+categories:
+- docs
+- operate
+- rc
+description: Shows how to add and edit regions for an Active-Active deployment.
+linkTitle: Manage regions
+weight: 10
+---
+
+You can add and edit regions for an Active-Active deployment after it has been created by going to the **Regions** tab of the [subscription page]({{< relref "/operate/rc/subscriptions/view-pro-subscription" >}}). 
+
+{{<image filename="images/rc/subscription-details-regions-tab.png" alt="The Regions tab lets you manage the regions in your Active-Active subscription." >}}
+
+## Add a new region
+
+To add a new region to an Active-Active deployment:
+
+1. In the **Regions** tab of the subscription page, select **Add region**.
+
+    {{<image filename="images/rc/subscription-details-regions-tab-add.png" width="128px" alt="Select Add region to add a new region to your Active-Active subscription." >}}
+
+1. In the **Region setup** step:
+
+    {{<image filename="images/rc/subscription-add-region-setup.png" alt="The Region setup step." >}}
+
+    1. Select the desired region from the **Region** list.
+
+    1. If you chose to deploy your Active-Active database to an existing [Bring your own Cloud]({{< relref "/operate/rc/subscriptions/bring-your-own-cloud" >}}) account, you can define the VPC ID for the new region. Select **In existing VPC** and the set the VPC ID for the region.
+
+    1. Enter a unique CIDR address for the region.  
+    
+        {{< embed-md "rc-aa-cidr.md" >}}
+
+    Select **Continue**.
+
+1. In the **Throughput** step, enter the desired read and write throughput for the new region. 
+
+    {{<image filename="images/rc/subscription-add-region-throughput.png" alt="The Throughput step." >}}
+
+    You can also select **Set throughput as existing region** to duplicate the throughput settings from an existing region.
+
+1. Review the required resources and updated price for the database in the **Required resources** step. 
+
+    {{<image filename="images/rc/subscription-add-region-required-resources.png" alt="The Required resources step." >}}
+
+    Select **Continue** to add the region to your Active-Active deployment.
+
+Redis Cloud will provision the new region in the background and add it to all databases in the subscription. You aren't allowed to make changes to the database settings while this process is running. 
+
+Your database will still be available, but you may notice some increased latency. This process will take some time depending on the size of your database.
+
+## Edit regions
+
+To edit the local throughput settings for a database instance or remove a region from the deployment, select **Edit regions** in the **Regions** tab of the subscription page.
+
+{{<image filename="images/rc/subscription-details-regions-tab-edit.png" alt="Select Edit regions to update regions for your Active-Active subscription." >}}
+
+From here, you can:
+
+- [Edit local throughput](#edit-local-throughput) for a database instance
+- [Remove a region](#remove-region) from the subscription
+
+After making the desired changes, [save and confirm the changes](#save-and-confirm-changes).
+
+### Edit local throughput
+
+To edit the local throughput settings for a database instance:
+
+1. Select the region you want to edit. 
+
+1. Add or reduce the local read and write throughput for each database in that region in the **Local reads ops/sec** and **Local writes ops/sec** fields.
+
+    {{<image filename="images/rc/subscription-edit-region-throughput.png" alt="The Edit regions page, with throughput settings changed." >}}
+
+### Remove region
+
+To remove a region from an Active-Active deployment, select the **Delete** button for the region you want to remove.
+
+{{<image filename="images/rc/subscription-edit-region-delete.png" alt="Select the Delete button to remove a region from your Active-Active subscription." >}}
+
+### Save and confirm changes
+
+After making your changes, select **Save changes** to apply them. You'll need to review and confirm the changes and any updated costs before they are applied. Select **Confirm** to apply the changes. 
+
+Redis Cloud will make the desired changes in the background. You aren't allowed to make changes to the database settings while this process is running. 
+
+Your databases will still be available, but you may notice some increased latency. This process will take some time depending on the size of your database.

content/operate/rc/databases/connect/_index.md

@@ -23,6 +23,10 @@ Once you have the username and password, select **Connect** to open the connecti
 
 {{< image filename="/images/rc/button-connect.png#no-click" alt="Connect button." >}}
 
+{{< note >}}
+For [Active-Active databases]({{< relref "/operate/rc/databases/active-active" >}}), you connect to one of the database instances. Select the region you to connect to from the region selection to access the connection information for that instance.
+{{< /note >}}
+
 The connection wizard provides the following database connection methods:
 
 - [Redis Insight](#using-redisinsight)

content/operate/rc/subscriptions/view-pro-subscription.md

@@ -33,7 +33,7 @@ From here, you can:
 
 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:
+In addition, you can view and edit the following subscription details:
 
 1.  The **Databases** tab lists the databases in your subscription and summarizes their settings.
 
@@ -43,6 +43,8 @@ In addition, three tabs are available:
 
 4.  The **Security** tab lets you set security settings for the databases in your subscription.
 
+5.  The **Regions** tab lets you manage the regions in your Active-Active subscription (_Active-Active subscriptions only_).
+
 The following sections provide more info.
 
 ## **Databases** tab
@@ -130,3 +132,11 @@ See the individual links to learn more.
 The **Security** tab lets you set security settings for the databases in your subscription.
 
 Here, you can [block public endpoints]({{< relref "/operate/rc/security/database-security/block-public-endpoints" >}}) for all databases in the subscription.
+
+## **Regions** tab
+
+The **Regions** tab is only available for Active-Active subscriptions.  It lets you manage the regions in your Active-Active subscription.
+
+{{<image filename="images/rc/subscription-details-regions-tab.png" alt="The Regions tab lets you manage the regions in your Active-Active subscription." >}}
+
+See [Manage regions for an Active-Active database]({{< relref "/operate/rc/databases/active-active/manage-regions" >}}) for more information.