Skip to content

Commit 840efea

Browse files
Merge pull request #209943 from seesharprun/sep1-cosmos-update-continuous-seven-mode
Cosmos DB | Update continuous seven mode
2 parents c25a31f + c70c851 commit 840efea

File tree

9 files changed

+30
-25
lines changed

9 files changed

+30
-25
lines changed
Binary file not shown.
74.5 KB
Loading
80.8 KB
Loading
22.1 KB
Loading
Binary file not shown.
Binary file not shown.
41.9 KB
Loading

articles/cosmos-db/migrate-continuous-backup.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: kanshiG
55
ms.author: govindk
66
ms.service: cosmos-db
77
ms.subservice: cosmosdb-sql
8-
ms.date: 06/28/2022
8+
ms.date: 08/24/2022
99
ms.topic: how-to
1010
ms.reviewer: mjbrown
1111
---
@@ -45,35 +45,35 @@ To perform the migration, you need `Microsoft.DocumentDB/databaseAccounts/write`
4545

4646
## Pricing after migration
4747

48-
After you migrate your account to continuous backup mode, the costs change when compared to the periodic backup mode. The tier choice of 30 days versus seven days will also have an influence on the cost of the backup. To learn more, see [continuous backup mode pricing](continuous-backup-restore-introduction.md#continuous-backup-pricing).
48+
After you migrate your account to continuous backup mode, the cost can change when compared to the periodic backup mode. The tier choice of 30 days versus seven days will also have an influence on the cost of the backup. To learn more, see [continuous backup mode pricing](continuous-backup-restore-introduction.md#continuous-backup-pricing).
4949

5050
## <a id="portal"></a> Migrate using portal
5151

5252
Use the following steps to migrate your account from periodic backup to continuous backup mode:
5353

5454
1. Sign into the [Azure portal](https://portal.azure.com/).
5555

56-
1. Navigate to your Azure Cosmos DB account and open the **Features** pane. Select **Continuous Backup** and select **Enable**.
56+
2. Navigate to your Azure Cosmos DB account and open the **Backup & Restore** pane. Select **Backup Policies** tab and select on **change**. Once you choose the target continuous mode, select on **Save**.
5757

58-
:::image type="content" source="./media/migrate-continuous-backup/enable-backup-migration.png" alt-text="Migrate to continuous mode using Azure portal" lightbox="./media/migrate-continuous-backup/enable-backup-migration.png":::
58+
:::image type="content" source="./media/migrate-continuous-backup/migrate-from-periodic-continuous.png" alt-text="Migrate to continuous mode using Azure portal" lightbox="./media/migrate-continuous-backup/migrate-from-periodic-continuous.png":::
5959

60-
1. When the migration is in progress, the status shows **Pending.** After it’s complete, the status changes to **On.** Migration time depends on the size of data in your account.
60+
3. When the migration is in progress, the popup shows **Updating Backup policy settings**. If you select that notification, you might see **Updating** on the account level and **Migrating** for Backup policy on overview of the account. After it’s complete, the backup policy would have switched to chosen tier of **Continuous** mode. Migration time depends on the size of data in your account.
6161

62-
:::image type="content" source="./media/migrate-continuous-backup/migration-status.png" alt-text="Check the status of migration from Azure portal" lightbox="./media/migrate-continuous-backup/migration-status.png":::
62+
:::image type="content" source="./media/migrate-continuous-backup/migrate-result-periodic-continuous.png" alt-text="Check the status of migration from Azure portal" lightbox="./media/migrate-continuous-backup/migrate-result-periodic-continuous.png":::
6363

6464
## <a id="powershell"></a>Migrate using PowerShell
6565

6666
1. Install the [latest version of Azure PowerShell](/powershell/azure/install-az-ps?view=azps-6.2.1&preserve-view=true) or any version higher than 6.2.0.
67-
1. To use ``Continous7Days`` mode for provisioning or migrating, you'll have to use preview of the ``cosmosdb`` extension. Use ``Install-Module -Name Az.CosmosDB -AllowPrerelease``
68-
1. Next, run the following steps:
67+
2. To use ``Continous7Days`` mode for provisioning or migrating, you'll have to use preview of the ``cosmosdb`` extension. Use ``Install-Module -Name Az.CosmosDB -AllowPrerelease``
68+
3. Next, run the following steps:
6969

7070
1. Connect to your Azure account:
7171

7272
```azurepowershell-interactive
7373
Connect-AzAccount
7474
```
7575
76-
1. Migrate your account from periodic to continuous backup mode with ``continuous30days`` tier or ``continuous7days`` days. If a tier value isn't provided, it's assumed to be ``continuous30days``:
76+
2. Migrate your account from periodic to continuous backup mode with ``continuous30days`` tier or ``continuous7days`` days. If a tier value isn't provided, it's assumed to be ``continuous30days``:
7777
7878
```azurepowershell-interactive
7979
Update-AzCosmosDBAccount `
@@ -98,13 +98,13 @@ Use the following steps to migrate your account from periodic backup to continuo
9898
* If you already have Azure CLI installed, use the ``az upgrade`` command to upgrade to the latest version. Alternatively, you can also use the Azure Cloud Shell from the Azure portal.
9999
* To use ``Continous7Days`` mode for provisioning or migrating, you'll have to use preview of the ``cosmosdb`` extension. Use ``az extension update --name cosmosdb-preview`` to manage the extension.
100100
101-
1. Sign in to your Azure account and run the following command to migrate your account to continuous mode:
101+
2. Sign in to your Azure account and run the following command to migrate your account to continuous mode:
102102
103103
```azurecli-interactive
104104
az login
105105
```
106106

107-
1. Migrate the account to ``continuous30days`` or ``continuous7days`` tier. If tier value isn't provided, it's assumed to be ``continuous30days``:
107+
3. Migrate the account to ``continuous30days`` or ``continuous7days`` tier. If tier value isn't provided, it's assumed to be ``continuous30days``:
108108

109109
```azurecli-interactive
110110
az cosmosdb update -n <myaccount> -g <myresourcegroup> --backup-policy-type continuous
@@ -114,7 +114,7 @@ Use the following steps to migrate your account from periodic backup to continuo
114114
az cosmosdb update -g "my-rg" -n "my-continuous-backup-account" --backup-policy-type "Continuous" --continuous-tier "Continuous7Days"
115115
```
116116

117-
1. After the migration completes successfully, the output shows the ``backupPolicy`` object, which includes ``type`` property with a value of ``Continuous``.
117+
4. After the migration completes successfully, the output shows the ``backupPolicy`` object, which includes ``type`` property with a value of ``Continuous``.
118118

119119
```console
120120
{
@@ -138,15 +138,15 @@ Run the following command and check the **status** and **targetType** properties
138138
az cosmosdb show -n "myAccount" -g "myrg"
139139
```
140140

141-
:::image type="content" source="./media/migrate-continuous-backup/migration-status-started-powershell.png" alt-text="Check the migration status using PowerShell command":::
141+
:::image type="content" source="./media/migrate-continuous-backup/migration-status-started-powershell.png" lightbox="./media/migrate-continuous-backup/migration-status-started-powershell.png" alt-text="Check the migration status using PowerShell command":::
142142

143143
When the migration is complete, the backup type changes to **Continuous** and shows the chosen tier. If a tier wasn't provided, the tier would be set to ``Continuous30Days``. Run the same command again to check the status:
144144

145145
```azurecli-interactive
146146
az cosmosdb show -n "myAccount" -g "myrg"
147147
```
148148

149-
:::image type="content" source="./media/migrate-continuous-backup/migration-status-complete-powershell.png" alt-text="Backup type changes to continuous after the migration is complete":::
149+
:::image type="content" source="./media/migrate-continuous-backup/migration-status-complete-powershell.png" lightbox="./media/migrate-continuous-backup/migration-status-complete-powershell.png" alt-text="Backup type changes to continuous after the migration is complete":::
150150

151151
## <a id="ARM-template"></a> Migrate from periodic mode to Continuous mode using Resource Manager template
152152

@@ -183,6 +183,10 @@ az deployment group create -g <ResourceGroup> --template-file <ProvisionTemplate
183183

184184
You can switch between ``Continuous30Days`` and ``Continous7Days`` in Azure PowerShell, Azure CLI or the Azure portal.
185185

186+
In the portal for the given Cosmos DB account, choose **Point in Time Restore** pane, select on change link next to Backup policy mode to show you the option of Continuous (30 days) or Continuous (7 days). Choose the required target and select on **Save**.
187+
188+
:::image type="content" source="./media/migrate-continuous-backup/migrate-continuous-mode-tiers.png" lightbox="./media/migrate-continuous-backup/migrate-continuous-mode-tiers.png" alt-text="Screenshot of dialog to select tier of continuous mode.":::
189+
186190
The Following Azure CLI command illustrates switching an existing account to ``Continous7Days``:
187191

188192
```azurecli-interactive

articles/cosmos-db/provision-account-continuous-backup.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ This article explains how to provision an account with continuous backup and poi
3434

3535
When creating a new Azure Cosmos DB account, in the **Backup policy** tab, choose **continuous** mode to enable the point in time restore functionality for the new account. With the point-in-time restore, data is restored to a new account, currently you can't restore to an existing account.
3636

37-
:::image type="content" source="./media/provision-account-continuous-backup/configure-continuous-backup-portal.png" alt-text="Provision an Azure Cosmos DB account with continuous backup configuration." border="true" lightbox="./media/provision-account-continuous-backup/configure-continuous-backup-portal.png":::
37+
:::image type="content" source="./media/provision-account-continuous-backup/provision-account-continuous-mode.png" alt-text="Provision an Azure Cosmos DB account with continuous backup configuration." border="true" lightbox="./media/provision-account-continuous-backup/provision-account-continuous-mode.png":::
3838

3939
Table API and Gremlin API are in preview and can be provisioned with PowerShell and Azure CLI.
4040

@@ -46,19 +46,20 @@ For PowerShell and CLI commands, the tier value is optional, if it isn't already
4646

4747
* Before provisioning the account, install any version of Azure PowerShell higher than 6.2.0. For more information about the latest version of Azure PowerShell, see [latest version of Azure PowerShell](/powershell/azure/install-az-ps?view=azps-6.2.1&preserve-view=true).
4848
* For provisioning the ``Continuous7Days`` tier, you'll need to install the preview version of the module by running ``Install-Module -Name Az.CosmosDB -AllowPrerelease``.
49-
* Next connect to your Azure account and select the required subscription with the following commands:
5049

51-
1. Sign into Azure using the following command:
50+
1. Next connect to your Azure account and select the required subscription with the following commands:
5251

53-
```azurepowershell
54-
Connect-AzAccount
55-
```
52+
1. Sign into Azure using the following command:
5653

57-
1. Select a specific subscription with the following command:
54+
```azurepowershell
55+
Connect-AzAccount
56+
```
5857
59-
```azurepowershell
60-
Select-AzSubscription -Subscription <SubscriptionName>
61-
```
58+
2. Select a specific subscription with the following command:
59+
60+
```azurepowershell
61+
Select-AzSubscription -Subscription <SubscriptionName>
62+
```
6263
6364
### <a id="provision-powershell-sql-api"></a>SQL API account
6465
@@ -135,7 +136,7 @@ Before provisioning the account, install Azure CLI with the following steps:
135136
* If you have already installed CLI, run ``az upgrade`` command to update to the latest version. This command will only work with CLI version higher than 2.11. If you have an earlier version, use the above link to install the latest version.
136137
* For provisioning the ``Continuous7Days`` tier, you'll need to install the preview version of the extension by ``az extension update --name cosmosdb-preview``
137138

138-
1. Sign in and select your subscription
139+
2. Sign in and select your subscription
139140

140141
* Sign into your Azure account with ``az login`` command.
141142
* Select the required subscription using ``az account set -s <subscriptionguid>`` command.

0 commit comments

Comments
 (0)