You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/postgresql/migrate/migration-service/how-to-setup-azure-cli-commands-postgresql.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ The following table defines the parameters and the commands that use them:
39
39
|`migration-name`| Create, Show | Unique identifier to migrations attempted to Flexible Server. This field accepts only alphanumeric characters and doesn't accept any special characters except a hyphen (-). The name can't start with -, and no two migrations to a Flexible Server target can have the same name. |
40
40
| `filter` | List | To filter migrations, two values are supported – Active and All
41
41
|`help`| Create, List, Show | Provides information about each command. |
42
-
|`migration-mode`| Create | This is an optional parameter. Default value: Offline. Offline migration involves copying your source databases at a point in time to your target server. |
42
+
|`migration-mode`| Create | This is an optional parameter. Default value: Offline. Offline migration involves copying your source databases to your target server at a point in time. |
43
43
| `migration-option` | Create | Allows you to perform validations before triggering a migration. Default is ValidateAndMigrate. Allowed values are - Migrate, Validate, ValidateAndMigrate.
44
44
|`properties`| Create | Absolute path to a JSON file that has the information about the source server |
Copy file name to clipboardExpand all lines: articles/postgresql/migrate/migration-service/tutorial-migration-service-aws-offline.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ ms.custom:
15
15
16
16
# Tutorial: Migrate offline from AWS RDS PostgreSQL to Azure Database for PostgreSQL with the migration service
17
17
18
-
In this article, we explore how to migrate your PostgreSQL database from AWS RDS to Azure Database for PostgreSQL offline.
18
+
This article explores how to migrate your PostgreSQL database from AWS RDS to Azure Database for PostgreSQL offline.
19
19
20
20
The migration service in Azure Database for PostgreSQL is a fully managed service integrated into the Azure portal and Azure CLI. It's designed to simplify your migration journey to Azure Database for PostgreSQL server.
21
21
@@ -34,7 +34,7 @@ To complete the migration, you need the following prerequisites:
34
34
35
35
## Perform the migration
36
36
37
-
You can perform the migration by using the Azure portal or the Azure CLI.
37
+
You can migrate by using the Azure portal or the Azure CLI.
38
38
39
39
#### [Portal](#tab/portal)
40
40
@@ -59,7 +59,7 @@ The migration service comes with a simple, wizard-based experience on the Azure
59
59
> [!NOTE]
60
60
> The first time you use the migration service, an empty grid appears with a prompt to begin your first migration.
61
61
62
-
If migrations to your flexible server target have already been created, the grid now contains information about attempted migrations.
62
+
If migrations to your flexible server target are already created, the grid now contains information about attempted migrations.
63
63
64
64
1. Select the **Create** button to go through a wizard-based series of tabs to perform a migration.
65
65
@@ -77,7 +77,8 @@ The user needs to provide multiple details related to the migration, such as the
77
77
-**Validate** - Checks your server and database readiness for migration to the target.
78
78
-**Migrate** - Skips validations and starts migrations.
79
79
-**Validate and Migrate**—Performs validation before triggering a migration. If there are no validation failures, the migration is triggered.
80
-
- Choosing the **Validate** or **Validate and Migrate** option is always a good practice to perform premigration validations before running the migration.
80
+
81
+
Choosing the **Validate** or **Validate and Migrate** option is always a good practice for performing premigration validations before running the migration.
81
82
82
83
To learn more about the premigration validation, visit [premigration](concepts-premigration-migration-service.md).
83
84
@@ -132,7 +133,7 @@ After the successful test connection, select the **Next: Select Database(s) for
132
133
#### Select database for migration
133
134
134
135
Under the **Select database for migration** tab, you can choose a list of user databases to migrate from your source PostgreSQL server.
135
-
After selecting the databases, select the **Next:Summary**
136
+
After selecting the databases, select the **Next:Summary**
136
137
137
138
:::image type="content" source="media/tutorial-migration-service-aws-offline/05-portal-offline-select-database-aws.png" alt-text="Screenshot of the fetchDB migration page.":::
138
139
@@ -148,7 +149,7 @@ After you select the **Start Validation and Migration** button, a notification a
148
149
149
150
:::image type="content" source="media/tutorial-migration-service-aws-offline/portal-offline-monitor-migration-aws.png" alt-text="Screenshot of the monitor migration page." lightbox="media/tutorial-migration-service-aws-offline/portal-offline-monitor-migration-aws.png":::
150
151
151
-
The grid that displays the migrations has these columns: **Name**, **Status**, **Migration mode**, **Migration type**, **Source server**, **Source server type**, **Databases**, **Duration** and **Start time**. The entries are displayed in the descending order of the start time, with the most recent entry on the top. You can use the refresh button to refresh the status of the validation or migration run.
152
+
The grid that displays the migrations has these columns: **Name**, **Status**, **Migration mode**, **Migration type**, **Source server**, **Source server type**, **Databases**, **Duration, and **Start time**. The entries are displayed in the descending order of the start time, with the most recent entry on the top. You can use the refresh button to refresh the status of the validation or migration run.
Copy file name to clipboardExpand all lines: articles/postgresql/migrate/migration-service/tutorial-migration-service-aws-online.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ ms.custom:
15
15
16
16
# Tutorial: Migrate online from AWS RDS PostgreSQL to Azure Database for PostgreSQL with the migration service
17
17
18
-
In this article, we explore how to migrate your PostgreSQL database from AWS RDS to Azure Database for PostgreSQL online.
18
+
This article explores how to migrate your PostgreSQL database from AWS RDS to Azure Database for PostgreSQL online.
19
19
20
20
The migration service in Azure Database for PostgreSQL is a fully managed service integrated into the Azure portal and Azure CLI. It's designed to simplify your migration journey to Azure Database for PostgreSQL server.
21
21
@@ -35,7 +35,7 @@ To complete the migration, you need the following prerequisites:
35
35
36
36
## Perform the migration
37
37
38
-
You can perform the migration by using the Azure portal or the Azure CLI.
38
+
You can migrate by using the Azure portal or the Azure CLI.
39
39
40
40
#### [Portal](#tab/portal)
41
41
@@ -61,11 +61,11 @@ The migration service comes with a simple, wizard-based experience on the Azure
61
61
62
62
If you've already created migrations to your Azure Database for PostgreSQL target, the grid contains information about attempted migrations.
63
63
64
-
1. Select the **Create** button. You then go through a wizard-based series of tabs to create a migration into this Azure Database for PostgreSQL target from the PostgreSQL source instance.
64
+
1. Select the **Create** button. Then, you go through a wizard-based series of tabs to create a migration into this Azure Database for PostgreSQL target from the PostgreSQL source instance.
65
65
66
66
#### Setup
67
67
68
-
The first tab is the setup tab, where the user needs to provide migration details like migration name source type to initiate the migrations
68
+
The first tab is the **Setup** tab, where the user needs to provide migration details like migration name source type to initiate the migrations.
69
69
70
70
:::image type="content" source="media/tutorial-migration-service-aws-online/01-portal-online-setup-aws.png" alt-text="Screenshot of Setup migration." lightbox="media/01-tutorial-migration-service-aws-online/01-portal-online-setup-aws.png":::
71
71
@@ -79,7 +79,7 @@ The first tab is the setup tab, where the user needs to provide migration detail
79
79
-**Migrate** - Skips validations and starts migrations.
80
80
-**Validate and Migrate**—Performs validation before triggering a migration. The migration is triggered only if there are no validation failures.
81
81
82
-
Choosing the **Validate** or **Validate and Migrate** option is always a good practice to perform premigration validations before running the migration. To learn more about the premigration validation, refer to this [documentation](concepts-premigration-migration-service.md).
82
+
Choosing the **Validate** or **Validate and Migrate** option is always a good practice when performing premigration validations before running the migration. To learn more about the premigration validation, refer to this [documentation](concepts-premigration-migration-service.md).
83
83
84
84
-**Migration mode** allows you to pick the mode for the migration. **Offline** is the default option.
85
85
@@ -103,8 +103,8 @@ The **Connect to Source** tab prompts you to provide details related to the Sour
103
103
-**Port** - Port number of the Source server
104
104
-**Server admin login name** - Username of the source PostgreSQL server
105
105
-**Password** - Password of the Source PostgreSQL server
106
-
-**SSL Mode**—The supported values are prefer and require. When the SSL at the Source PostgreSQL server is OFF, use SSLMODE=prefer. If the SSL at the source server is ON, use SSLMODE=require. SSL values can be determined in the Postgresql.conf file.
107
-
-**Test Connection** - Performs the connectivity test between target and Source. Once the connection is successful, users can proceed with the next step. Otherwise, we need to identify the networking issues between the target and Source and verify the username/password for the Source. Test connection takes a few minutes to establish a connection between the target and Source
106
+
-**SSL Mode**—The supported values are preferred and required. When the SSL at the Source PostgreSQL server is OFF, use SSLMODE=prefer. If the SSL at the source server is ON, use SSLMODE=require. SSL values can be determined in the Postgresql.conf file.
107
+
-**Test Connection**—Performs the connectivity test between the target and the Source. Once the connection is successful, users can proceed with the next step. Otherwise, we need to identify the networking issues between the target and the Source and verify the username/password for the Source. Establishing a test connection takes a few minutes.
108
108
109
109
After the successful test connection, select the **Next: Select Migration target**
110
110
@@ -136,21 +136,21 @@ The **Summary** tab summarizes all the Source and target details for creating th
136
136
137
137
#### Monitor the migration
138
138
139
-
After you select the start button, a notification appears in a few seconds saying that the validation or migration creation is successful. You're redirected automatically to the **Migration** page of Flexible Server, which has a new entry for the recently created validation or migration.
139
+
After you select the start button, a notification will appear in a few seconds saying that the validation or migration creation is successful. You'll then be automatically redirected to the **Migration** page of Flexible Server, which has a new entry for the recently created validation or migration.
140
140
141
141
:::image type="content" source="media/tutorial-migration-service-aws-online/aws-monitor.png" alt-text="Screenshot of Monitor migration." lightbox="media/tutorial-migration-service-aws-online/aws-monitor.png":::
142
142
143
143
The grid that displays the migrations has these columns: **Name**, **Status**, **Migration mode**, **Migration type**, **Source server**, **Source server type**, **Databases**, **Duration**, and **Start time**. The entries are displayed in the descending order of the start time, with the most recent entry at the top. You can use the refresh button to refresh the status of the validation or migration.
144
144
Select the migration name in the grid to see the associated details.
145
145
146
-
As soon as the validation or migration is created, it moves to the **InProgress** state and **PerformingPreRequisiteSteps** substrate. The workflow takes 2-3 minutes to set up the migration infrastructure and network connections.
146
+
When the validation or migration is created, it moves to the **InProgress** state and **PerformingPreRequisiteSteps** substrate. The workflow takes 2-3 minutes to set up the migration infrastructure and network connections.
147
147
148
148
#### Migration details
149
149
150
150
In the Setup tab, we have selected the migration option as **Migrate and Validate**. In this scenario, validations are performed first before migration starts. After the **PerformingPreRequisiteSteps** substate is completed, the workflow moves into the substate of **Validation in Progress**.
151
151
152
152
- If validation has errors, the migration moves into a **Failed** state.
153
-
- If validation completes without any error, the migration starts, and the workflow moves into the substate of **Migrating Data**.
153
+
- If validation completes without error, the migration starts, and the workflow moves into the substate of **Migrating Data**.
154
154
155
155
You can see the results of validation and migration at the instance and database level.
156
156
@@ -190,19 +190,19 @@ Some possible migration states:
190
190
191
191
#### Cutover
192
192
193
-
If there are both **Migrate** and **Validate and Migrate**, completion of the Online migration requires another step—the user must take a Cutover action. After the copy/clone of the base data is complete, the migration moves to the `WaitingForUserAction` state and the `WaitingForCutoverTrigger' substate. In this state, the user can trigger the cutover from the portal by selecting the migration.
193
+
If there are both **Migrate** and **Validate and Migrate**, completing the Online migration requires another step—the user must take a Cutover action. After the copy/clone of the base data is complete, the migration moves to the `WaitingForUserAction` state and the `WaitingForCutoverTrigger' substate. In this state, the user can trigger the cutover from the portal by selecting the migration.
194
194
195
195
Before initiating cutover, it's important to ensure that:
196
196
197
-
- Writes to the Source are stopped - `Latency` value is 0 or close to 0 The `Latency` information can be obtained from the migration details screen as shown below:
197
+
- Writes to the Source are stopped - `Latency` value is 0 or close to 0. The `Latency` information can be obtained from the migration details screen as shown below:
198
198
199
199
:::image type="content" source="media/tutorial-migration-service-aws-online/aws-cutover-migration.png" alt-text="Screenshot of Cutover migration." lightbox="media/tutorial-migration-service-aws-online/aws-cutover-migration.png":::
200
200
201
201
-`latency` value decreases to 0 or close to 0
202
202
203
-
- The `latency` value indicates when the target last synced with the Source. At this point, writing to the Source can be stopped, and cutover can be initiated. In case there's heavy traffic at the Source, it's recommended to stop writes first so that `Latency` can come close to 0, and then cutover is initiated.
204
-
The Cutover operation applies all pending changes from the Source to the Target and completes the migration. If you trigger a "Cutover" even with nonzero `Latency,` the replication stops until that point in time. All the data on the Source until the cutover point is then applied on the target. Say a latency was 15 minutes at the cutover point, so all the changed data in the last 15 minutes are applied on the target.
205
-
Time depends on the backlog of changes occurring in the last 15 minutes. Hence, it's recommended that the latency go to zero or near zero before triggering the cutover.
203
+
- The `latency` value indicates when the target last synced with the Source. At this point, writing to the Source can be stopped, and cutover can be initiated. In case there's heavy traffic at the Source, it's recommended to stop writes first so that `Latency` can come close to 0, and then a cutover is initiated.
204
+
The Cutover operation applies all pending changes from the Source to the Target and completes the migration. If you trigger a "Cutover" even with nonzero `Latency,` the replication stops until that point in time. All the data is on the Source until the cutover point is applied to the target. Say a latency was 15 minutes at the cutover point, so all the changed data in the last 15 minutes are applied to the target.
205
+
Time depends on the backlog of changes occurring in the last 15 minutes. Hence, it's recommended that the Latency go to zero or near zero before triggering the cutover.
206
206
207
207
:::image type="content" source="media/tutorial-migration-service-aws-online/aws-confirm-cutover.png" alt-text="Screenshot of Confirmcutovermigration." lightbox="media/tutorial-migration-service-aws-online/aws-confirm-cutover.png":::
208
208
@@ -224,7 +224,7 @@ Once the CLI is installed, open the command prompt and log into your Azure accou
224
224
225
225
### Configure the migration task
226
226
227
-
To begin the migration, you need to create a JSON file with the migration details. The JSON file contains the following information:
227
+
To begin the migration, create a JSON file with the migration details. The JSON file contains the following information:
228
228
229
229
- Edit the below placeholders `<< >>` in the JSON lines and store them in the local machine as `<<filename>>.json` where the CLI is being invoked. In this tutorial, we have saved the file in C:\migration-CLI\migration_body.json
230
230
@@ -274,7 +274,7 @@ To begin the migration, you need to create a JSON file with the migration detail
274
274
275
275
#### Cutover
276
276
277
-
In online migrations, after the base data migration is complete, the migration task moves to the `WaitingForCutoverTrigger` substate. In this state, the user can trigger the cutover through the CLI using the command below. The cutover can also be triggered from the portal by selecting the migration name in the migration grid.
277
+
After the base data migration is completein online migrations, the migration task moves to the `WaitingForCutoverTrigger` substate. In this state, the user can trigger the cutover through the CLI using the command below. The cutover can also be triggered from the portal by selecting the migration name in the migration grid.
278
278
279
279
```bash
280
280
az postgres flexible-server migration update --subscription <<subscription ID>> --resource-group <<resource group name>> --name <<Name of the Flexible Server>> --migration-name <<Unique Migration Name>> --cutover
0 commit comments