Skip to content

Commit 8d30d92

Browse files
committed
V1.1 Initial Feedback update
1 parent c2e72b5 commit 8d30d92

File tree

1 file changed

+14
-17
lines changed

1 file changed

+14
-17
lines changed

articles/postgresql/migrate/auto-migration-single-to-flexible-postgresql.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: In-place auto-migration
2+
title: Auto-migration
33
description: This tutorial describes how to configure notifications, review migration details and FAQs for an Azure Database for PostgreSQL Single Server instance schedule for auto-migration to Flexible Server.
44
author: hariramt
55
ms.author: hariramt
@@ -19,15 +19,15 @@ ms.custom:
1919

2020
**Auto-migration** from Azure Database for Postgresql – Single Server to Flexible Server is a service-initiated migration during a planned downtime window for Single Server running PostgreSQL 11 and database workloads with **Basic, General Purpose or Memory Optimized SKU**, data storage used **<= 5 GiB** and **no complex features (CMK, Microsoft Entra ID, Read Replica, Private Link) enabled**. The eligible servers are identified by the service and are sent advance notifications detailing steps to review migration details and make modifications if necessary.
2121

22-
The in-place migration provides a highly resilient and self-healing offline migration experience during a planned maintenance window, with about **10 mins** of downtime. The migration service is a hosted solution using the [pgcopydb](https://github.com/dimitri/pgcopydb) binary and provides a fast and efficient way of copying databases from the source PostgreSQL instance to the target. This migration removes the overhead to manually migrate your server. Post migration, you can take advantage of the benefits of Flexible Server, including better price & performance, granular control over database configuration, and custom maintenance windows. Following described are the key phases of the migration:
22+
The auto-migration provides a highly resilient and self-healing offline migration experience during a planned migration window, with about **10 mins** of downtime. The migration service is a hosted solution using the [pgcopydb](https://github.com/dimitri/pgcopydb) binary and provides a fast and efficient way of copying databases from the source PostgreSQL instance to the target. This migration removes the overhead to manually migrate your server. Post migration, you can take advantage of the benefits of Flexible Server, including better price & performance, granular control over database configuration, and custom maintenance windows. Following described are the key phases of the migration:
2323

2424
- **Target Flexible Server is deployed** matches your Single server SKU in terms of performance and cost, inheriting all firewall rules from source Single Server.
2525

2626
- **Date is migrated** during the migration window chosen by the service or elected by you. If the window is chosen by the service, it is typically outside business hours of the specific region the server is hosted in.Source Single Server is set to read-only and the data & schema is migrated from the source Single Server to the target Flexible Server. User roles, privileges and ownership of all database objects are also migrated to the flexible server.
2727

2828
- **DNS switch and cutover** are performed within the planned migration window with minimal downtime, allowing usage of the same connection string post-migration. Client applications seamlessly connect to the target flexible server without any user driven manual updates or changes. In addition to both connection string formats (Single and Flexible Server) being supported on migrated Flexible Server, both username formats – username@server_name and username are also supported on the migrated Flexible Server.
2929

30-
- The **migrated Flexible Server is online** and can now be managed via Azure portal/CLI. The stopped Single Server is deleted seven days after the migration.
30+
- The **migrated Flexible Server is online** and can now be managed via Azure portal/CLI. The legacy Single Server is deleted seven days after the migration.
3131

3232
## Nomination Eligibility
3333

@@ -49,17 +49,17 @@ Following described are the ways to review your migration schedule once you rece
4949
> The migration schedule will be locked 7 days prior to the scheduled migration window during which you'll be unable to reschedule.
5050
5151
- The **Single Server overview page** for your instance displays a portal banner with information about your migration schedule.
52-
- For Single Servers scheduled for auto-migration, a new **Migration blade** is available on the portal. You can review the migration schedule by navigating to the Migration blade of your Single Server instance.
52+
- For Single Servers scheduled for auto-migration, the **Overview** page is updated with the relevant information. You can review the migration schedule by navigating to the Overview page of your Single Server instance.
5353
- If you wish to defer the migration, you can defer by a month at a time on the Azure portal and rescheduling the migration by selecting another migration window within a month.
5454

5555
> [!NOTE]
56-
> Since cross region or Geo redundant backups can only be enabled during create time for a postgresql Flexible Server, it's highly recommended that you enable this feature when reviewing the migration schedule if you plan to use it later.
56+
> Typically, candidate servers short-listed for auto-migration do not use cross region or Geo redundant backups. And these features can only be enabled during create time for a postgresql Flexible Server. In case you plan to use any of these features, it's recommended to opt out of the auto-migration schedule and migrate your server manually.
5757
58-
## Prerequisite checks for in-place auto-migration
58+
## Prerequisite checks for auto-migration
5959

60-
Review the following prerequisites to ensure a successful in-place auto-migration:
60+
Review the following prerequisites to ensure a successful auto-migration:
6161

62-
- The Single Server instance should be in **ready state** and shouldn't be in stopped state during the planned maintenance window for auto-migration to take place.
62+
- The Single Server instance should be in **ready state** during the planned migration window for auto-migration to take place.
6363
- If your source Azure Database for postgresql Single Server has firewall rule names exceeding 80 characters, rename them to ensure length of name is fewer than 80 characters. (The firewall rule name length supported on Flexible Server is 80 characters whereas on Single Server the allowed length is 128 characters.)
6464

6565
## How is the target postgresql Flexible Server provisioned?
@@ -93,9 +93,6 @@ The compute tier and SKU for the target flexible server is provisioned based on
9393

9494
Here's the info you need to know post auto-migration:
9595

96-
> [!NOTE]
97-
> Post-migration do no restart the stopped Single Server instance as it might hamper your client's and application connectivity.
98-
9996
- Copy the following properties from the source Single Server to target Flexible Server post auto-migration operation is completed successfully:
10097
- Monitoring page settings (Alerts, Metrics, and Diagnostic settings)
10198
- Any Terraform/CLI scripts you host to manage your Single Server instance should be updated with Flexible Server references.
@@ -112,22 +109,22 @@ Here's the info you need to know post auto-migration:
112109

113110
**Q. Why am I being auto-migrated​?**
114111

115-
**A.** Your Azure Database for Postgresql - Single Server instance is eligible for auto-migration to our flagship offering Azure Database for Postgresql - Flexible Server. This in-place migration will remove the overhead to manually migrate your server and ensure you can take advantage of the benefits of Flexible Server, including better price & performance, granular control over database configuration, and custom maintenance windows.
112+
**A.** Your Azure Database for Postgresql - Single Server instance is eligible for auto-migration to our flagship offering Azure Database for Postgresql - Flexible Server. This auto-migration will remove the overhead to manually migrate your server and ensure you can take advantage of the benefits of Flexible Server, including better price & performance, granular control over database configuration, and custom maintenance windows.
116113

117114
**Q. How does the auto-migration take place? What all does it migrate?​**
118115

119-
**A.** The Flexible Server is provisioned to closely match the same VCores and storage as that of your Single Server. Next the source Single Server is put to stopped state, data file snapshot is taken and copied to target Flexible Server. The DNS switch is performed to route all existing connections to target and the target Flexible Server is brought online. The auto-migration migrates the entire server's data files (including schema, data, users/roles and privileges). This is an offline migration where you see downtime of about 10 minutes or less.
116+
**A.** The Flexible Server is provisioned to closely match the same VCores and storage as that of your Single Server. Next the source Single Server is put in a read-only state, schema and data is copied to target Flexible Server. The DNS switch is performed to route all existing connections to target and the target Flexible Server is brought online. The auto-migration migrates the databases (including schema, data, users/roles and privileges). This is an offline migration where you see downtime of about 10 minutes or less.
120117

121-
**Q. How can I set up or view in-place migration alerts?​**
118+
**Q. How can I set up or view auto-migration alerts?​**
122119

123120
**A.** Following are the ways you can set up alerts:
124121

125-
- Configure service health alerts to receive in-place migration schedule and progress notifications via email/SMS by following steps [here](../../single-server/concepts-planned-maintenance-notification.md#to-receive-planned-maintenance-notification).
126-
- Check the in-place migration notification on the Azure portal by following steps [here](../single-server/concepts-planned-maintenance-notification.md#check-planned-maintenance-notification-from-azure-portal).
122+
- Configure service health alerts to receive auto-migration schedule and progress notifications via email/SMS by following steps [here](../../single-server/concepts-planned-maintenance-notification.md#to-receive-planned-maintenance-notification).
123+
- Check the auto-migration notification on the Azure portal by following steps [here](../single-server/concepts-planned-maintenance-notification.md#check-planned-maintenance-notification-from-azure-portal).
127124

128125
**Q. How can I defer the scheduled migration?​**
129126

130-
**A.** You can review the migration schedule by navigating to the Migration blade of your Single Server instance. If you wish to defer the migration, you can defer by a month at the most by navigating to the Migration blade of your single server instance on the Azure portal and rescheduling the migration by selecting another migration window within a month. The migration details will be locked seven days prior to the scheduled migration window after which you're unable to reschedule. This in-place migration can be deferred monthly until 30 March 2025.
127+
**A.** You can review the migration schedule by navigating to the Overview page of your Single Server instance. If you wish to defer the migration, you can defer by a month at the most by navigating to the Overview page of your single server instance on the Azure portal and rescheduling the migration by selecting another migration window within a month. The migration details will be locked seven days prior to the scheduled migration window after which you're unable to reschedule. This auto-migration can be deferred monthly until 30 March 2025.
131128

132129
**Q. What username and connection string would be supported for the migrated Flexible Server? ​​**
133130

0 commit comments

Comments
 (0)