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/auto-migration-single-to-flexible-postgresql.md
+14-17Lines changed: 14 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: In-place auto-migration
2
+
title: Auto-migration
3
3
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.
4
4
author: hariramt
5
5
ms.author: hariramt
@@ -19,15 +19,15 @@ ms.custom:
19
19
20
20
**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.
21
21
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:
23
23
24
24
-**Target Flexible Server is deployed** matches your Single server SKU in terms of performance and cost, inheriting all firewall rules from source Single Server.
25
25
26
26
-**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.
27
27
28
28
-**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.
29
29
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.
31
31
32
32
## Nomination Eligibility
33
33
@@ -49,17 +49,17 @@ Following described are the ways to review your migration schedule once you rece
49
49
> The migration schedule will be locked 7 days prior to the scheduled migration window during which you'll be unable to reschedule.
50
50
51
51
- 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.
53
53
- 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.
54
54
55
55
> [!NOTE]
56
-
> Since cross region or Geo redundant backupscan 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.
57
57
58
-
## Prerequisite checks for in-place auto-migration
58
+
## Prerequisite checks for auto-migration
59
59
60
-
Review the following prerequisites to ensure a successful in-place auto-migration:
60
+
Review the following prerequisites to ensure a successful auto-migration:
61
61
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.
63
63
- 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.)
64
64
65
65
## 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
93
93
94
94
Here's the info you need to know post auto-migration:
95
95
96
-
> [!NOTE]
97
-
> Post-migration do no restart the stopped Single Server instance as it might hamper your client's and application connectivity.
98
-
99
96
- Copy the following properties from the source Single Server to target Flexible Server post auto-migration operation is completed successfully:
100
97
- Monitoring page settings (Alerts, Metrics, and Diagnostic settings)
101
98
- 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:
112
109
113
110
**Q. Why am I being auto-migrated?**
114
111
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.
116
113
117
114
**Q. How does the auto-migration take place? What all does it migrate?**
118
115
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.
120
117
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?**
122
119
123
120
**A.** Following are the ways you can set up alerts:
124
121
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).
127
124
128
125
**Q. How can I defer the scheduled migration?**
129
126
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.
131
128
132
129
**Q. What username and connection string would be supported for the migrated Flexible Server? **
0 commit comments