Merge pull request #278336 from MicrosoftDocs/release-postgresql-migrations

[PostgreSQL] New Content for migration service for online migrations and updates with runtime sever added with new images -- 06/18/2024 3PM

Author: Albertyang0

articles/postgresql/.openpublishing.redirection.postgresql.json

@@ -1619,6 +1619,26 @@
         "source_path_from_root": "/articles/postgresql/flexible-server/concepts-compute-storage.md",
         "redirect_url": "/azure/postgresql/flexible-server/concepts-compute",
         "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/migrate/migration-service/tutorial-migration-service-aws.md",
+        "redirect_url": "/azure/postgresql/migrate/migration-service/tutorial-migration-service-aws-offline",
+        "redirect_document_id": true
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/migrate/migration-service/tutorial-migration-service-iaas.md",
+        "redirect_url": "/azure/postgresql/migrate/migration-service/tutorial-migration-service-iaas-offline",
+        "redirect_document_id": true
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/migrate/migration-service/concepts-migration-service-postgresql.md",
+        "redirect_url": "/azure/postgresql/migrate/migration-service/overview-migration-service-postgresql",
+        "redirect_document_id": true
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/migrate/migration-service/troubleshoot-error-codes-premigration.md",
+        "redirect_url": "/azure/postgresql/migrate/migration-service/troubleshoot-error-codes",
+        "redirect_document_id": true
     }
     ]
 }

articles/postgresql/TOC.yml

@@ -543,32 +543,40 @@
   - name: Migration Service
     items:
     - name: Overview
-      href: migrate/migration-service/concepts-migration-service-postgresql.md
+      href: migrate/migration-service/overview-migration-service-postgresql.md
     - name: Tutorials
       items:
       - name: Migrate from Single Server
         href: migrate/migration-service/tutorial-migration-service-single-to-flexible.md
-      - name: Migrate from on-premises or Azure VM
-        href: migrate/migration-service/tutorial-migration-service-iaas.md
-      - name: Migrate from AWS RDS
-        href: migrate/migration-service/tutorial-migration-service-aws.md
+      - name: Migrate from an Azure VM or an on-premises PostgreSQL server offline
+        href: migrate/migration-service/tutorial-migration-service-iaas-offline.md
+      - name: Migrate from an Azure VM or an on-premises PostgreSQL server online
+        href: migrate/migration-service/tutorial-migration-service-iaas-online.md
+      - name: Migrate from AWS RDS offline
+        href: migrate/migration-service/tutorial-migration-service-aws-offline.md
+      - name: Migrate from AWS RDS online
+        href: migrate/migration-service/tutorial-migration-service-aws-online.md
     - name: Concepts
       items:
       - name: Premigration validation
         href: migrate/migration-service/concepts-premigration-migration-service.md
       - name: User roles and permissions
         href: migrate/migration-service/concepts-user-roles-migration-service.md
+      - name: Runtime Server
+        href: migrate/migration-service/concepts-migration-service-runtime-server.md
       - name: Best practices
         href: migrate/migration-service/best-practices-migration-service-postgresql.md
       - name: Known issues and limitations
         href: migrate/migration-service/concepts-known-issues-migration-service.md
     - name: How-to guides
       items:
-      - name: Network setup
+      - name: How to set up Azure CLI
+        href: migrate/migration-service/how-to-setup-azure-cli-commands-postgresql.md
+      - name: How to set up the network
         href: migrate/migration-service/how-to-network-setup-migration-service.md
     - name: Troubleshoot
       items:
-      - name: Premigration error codes
+      - name: Troubleshoot errors
         href: migrate/migration-service/troubleshoot-error-codes-premigration.md
   - name: Migrate data with pg_dump
     href: migrate/how-to-migrate-using-dump-and-restore.md

articles/postgresql/migrate/migration-service/concepts-known-issues-migration-service.md

@@ -53,6 +53,8 @@ Here are common limitations that apply to migration scenarios:
 
 - Migration to burstable SKUs isn't supported; databases must first be migrated to a non-burstable SKU and then scaled down if needed.
 
+- The Migration Runtime Server is specifically designed to operate with the default DNS servers/private DNS zones i.e., **privatelink.postgres.database.azure.com**. Custom DNS names/DNS servers are not supported by the migration service when utilizing the migration runtime server feature. When configuring private endpoints for both the source and target databases, it is imperative to use the default private DNS zone provided by Azure for the private link service. The use of custom DNS configurations is not yet supported and may lead to connectivity issues during the migration process.
+
 ## Limitations migrating from Azure Database for PostgreSQL single server
 
 - It's required that both the Azure Database for PostgreSQL single server and the Azure Database for PostgreSQL flexible server are in the same Azure region. Exceptions to this limitation are made for Azure Database for PostgreSQL flexible server situated in India, China, and UAE, where cross-region migrations are permitted.

articles/postgresql/migrate/migration-service/concepts-migration-service-runtime-server.md

@@ -0,0 +1,52 @@
+---
+title: "Introduction of migration runtime server in Migration service in Azure Database for PostgreSQL"
+description: "Concepts about the migration runtime server in migration service Azure Database for PostgreSQL"
+author: apduvuri
+ms.author: adityaduvuri
+ms.reviewer: maghan
+ms.date: 06/13/2024
+ms.service: postgresql
+ms.topic: conceptual
+---
+
+# Migration Runtime Server with the migration service in Azure Database for PostgreSQL Preview
+
+The Migration Runtime Server is a specialized feature within the [migration service in Azure Database for PostgreSQL](concepts-migration-service-postgresql.md), designed to act as an intermediary server during migration. It's a separate Azure Database for PostgreSQL - Flexible Server instance that isn't the target server but is used to facilitate the migration of databases from a source environment that is only accessible via a private network.
+
+The migration runtime server is helpful in scenarios where both the source PostgreSQL instances and the target Azure Database for PostgreSQL Flexible Server are configured to communicate over private endpoints or private IPs, ensuring that the migration occurs within a secure and isolated network space. The Migration Runtime Server handles the data transfer, connecting to the source PostgreSQL instance to retrieve data and then pushing it to the target server.
+
+The migration runtime server is distinct from the target server and is configured to handle the data transfer process, ensuring a secure and efficient migration path.
+
+:::image type="content" source="media/concepts-migration-service-runtime-server/private-endpoint-scenario.png" alt-text="Screenshot of migration runtime server.":::
+
+## Supported migration scenarios with the Migration Runtime Server
+
+The migration runtime server is essential for transferring data between different source PostgreSQL instances and the Azure Database for PostgreSQL - Flexible Server. It's necessary in the following scenarios:
+
+- When the source is an Azure Database for PostgreSQL—Single Server configured with a private endpoint and the target is an Azure Database for PostgreSQL—Flexible Server with a private endpoint.
+- For sources such as on-premises databases, Azure VMs, or AWS instances that are only accessible via private networks, and the target Azure Database for PostgreSQL - Flexible Server with a private endpoint.
+
+## How do you use the Migration Runtime Server feature?
+
+To use the Migration Runtime Server feature within the migration service in Azure Database for PostgreSQL, follow these steps in the Azure portal:
+
+- Sign in to the Azure portal and access the migration service (from the target server) in the Azure Database for PostgreSQL instance.
+- Begin a new migration workflow within the service.
+- When you reach the "Select runtime server" tab, use the Migration Runtime Server by selecting "Yes."
+Choose your Azure subscription and resource group and the location of the VNet-integrated Azure Database for PostgreSQL—Flexible server.
+- Select the appropriate Azure Database for PostgreSQL Flexible Server to serve as your Migration Runtime Server.
+
+:::image type="content" source="media/concepts-migration-service-runtime-server/select-runtime-server.png" alt-text="Screenshot of selecting migration runtime server.":::
+
+## Migration Runtime Server essentials
+
+- **Minimal Configuration**—Despite being created from an Azure Database for PostgreSQL Flexible Server, the migration runtime server solely facilitates migration without the need for HA, backups, version specificity, or advanced storage features.
+- **Performance and Sizing**—The migration runtime server must be appropriately scaled to manage the workload, and it's recommended that you select an SKU equivalent to or greater than that of the target server.
+- **Networking** Ensure that the migration runtime server is appropriately integrated into the Virtual Network (virtual network) and that network security allows for secure communication with both the source and target servers. For more information visit [Network guide for migration service](how-to-network-setup-migration-service.md).
+- **Cleanup Post-Migration**—After the migration is complete, the migration runtime server should be decommissioned to avoid unnecessary costs. Before deletion, ensure all data has been successfully migrated and that the server is no longer needed.
+
+## Related content
+
+- [Migration service](concepts-migration-service-postgresql.md)
+- [Network setup](how-to-network-setup-migration-service.md)
+- [Premigration validations](concepts-premigration-migration-service.md)