edited failover article

Author: MashaMSFT

articles/azure-sql/managed-instance/managed-instance-link-use-ssms-to-failover-database.md

@@ -1,91 +1,97 @@
 ---
-title: Managed Instance link - Use SSMS to failover database 
+title: Failover database with link feature in SSMS
 titleSuffix: Azure SQL Managed Instance
-description: This tutorial teaches you how to use Managed Instance link and SSMS to failover database from SQL Server to Azure SQL Managed Instance.
+description: This guide teaches you how to use the SQL Managed Instance link in SQL Server Management Studio (SSMS) to failover database from SQL Server to Azure SQL Managed Instance.
 services: sql-database
 ms.service: sql-managed-instance
 ms.subservice: data-movement
-ms.custom: sqldbrb=1
+ms.custom: 
 ms.devlang: 
-ms.topic: tutorial
+ms.topic: guide
 author: sasapopo
 ms.author: sasapopo
 ms.reviewer: mathoma
 ms.date: 03/07/2022
 ---
-# Tutorial: Perform Managed Instance link database failover with SSMS
+# Failover database with link feature in SSMS
 
 [!INCLUDE[appliesto-sqlmi](../includes/appliesto-sqlmi.md)]
 
 This article teaches you to use the Managed Instance link feature to failover your database from SQL Server to Azure SQL Managed Instance in SQL Server Management Studio (SSMS). 
 
-Managed Instance link is in public preview.
+Failing over your database from your SQL Server instance to your SQL Managed Instance breaks the link between the two databases, stopping replication, and leaving both databases in an independent state, both ready for read-write workloads. 
+
+Managed Instance link is currently in public preview.
 
 ## Prerequisites 
 
-To replicate your databases to Azure SQL Managed Instance, you need the following prerequisites: 
+To failover your databases to Azure SQL Managed Instance, you need the following prerequisites: 
 
 - An active Azure subscription. If you don't have one, [create a free account](https://azure.microsoft.com/free/).
 - [SQL Server 2019](https://www.microsoft.com/en-us/evalcenter/evaluate-sql-server-2019?filetype=EXE)
 - An instance of Azure SQL Managed Instance. [Get started](instance-create-quickstart.md) if you don't have one. 
 - [SQL Server Management Studio (SSMS) v 18.11 or later](/sql/ssms/download-sql-server-management-studio-ssms).
 - Network connectivity between SQL Server and SQL Managed Instance using either [Azure ExpressRoute](../../expressroute/expressroute-howto-circuit-portal-resource-manager.md), [Virtual network peering](../../virtual-network/virtual-network-peering-overview.md), or [VPN gateways](../../vpn-gateway/tutorial-create-gateway-portal.md). 
+- Setup the [link feature and replicated your database to your managed instance in Azure](managed-instance-link-use-ssms-to-replicate-database.md). 
 
-## Managed Instance link database failover (migration)
+## Failover database
 
-Follow the steps described in this section to perform Managed Instance link database failover.
+Use the **Failover database to Managed Instance** wizard in SQL Server Management Studio (SSMS) to failover your database from your instance of SQL Server to your instance of SQL Managed Instance. The wizard takes you through the failing over your database. Once the link is created, your source database gets a read-only replica copy on your target Azure SQL Managed Instance. 
 
-1. Managed Instance link database failover starts with connecting to SQL Server from SSMS.
-    To perform Managed Instance link database failover and migrate database from SQL Server to Managed Instance, open the context menu of the SQL Server database. Then select Azure SQL Managed Instance link and then choose Failover database option.
+> [!CAUTION]
+> If you are performing a planned manual failover, stop the workload on the database hosted on the source SQL Server to allow the replicated database on the SQL Managed Instance to completely catch up and failover without data loss. If you are performing a forced failover, there may be data loss. 
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-ssms-database-context-failover-database.png" alt-text="Screenshot showing database's context menu option for database failover.":::
+To failover your database, follow these steps: 
 
-2. When the wizard starts, click Next. 
+1. Open SQL Server Management Studio (SSMS) and connect to your instance of SQL Server. 
+1. In **Object Explorer**, right-click your database, hover over **Azure SQL Managed Instance link** and select **Failover database** to open the **Failover database to Managed Instance** wizard: 
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-introduction.png" alt-text="Screenshot showing Introduction window.":::
+   :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-ssms-database-context-failover-database.png" alt-text="Screenshot showing database's context menu option for database failover.":::
 
-3. On the Log in to Azure window, sign-in to your Azure account, select Subscription that is hosting the Managed Instance and click Next.
+1. Select **Next** on the **Introduction** page of the **Failover database to Managed Instance** wizard:
+
+   :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-introduction.png" alt-text="Screenshot showing Introduction window.":::
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-login-to-azure.png" alt-text="Screenshot showing Log in to Azure window.":::
 
-4. On the Failover type window, select the failover type, fill in the required details and click Next.
+3. On the **Log in to Azure** page, select **Sign-in** to provide your credentials and sign into your Azure account. Select the subscription that is hosting the your SQL Managed Instance and then select **Next**: 
 
-    In regular situations you should choose planned manual failover option and confirm that the workload on SQL Server database is stopped.
+    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-login-to-azure.png" alt-text="Screenshot showing Log in to Azure window.":::
+
+4. On the **Failover type** page, choose the type of failover you're performing and check the box to confirm that you've either stopped the workload for a planned failover, or you understand that there may be data loss for a forced failover. Select **Next**: 
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-failover-type.png" alt-text="Screenshot showing Failover Type window.":::
+   :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-failover-type.png" alt-text="Screenshot showing Failover Type window.":::
 
-> [!NOTE]
-> If you are performing planned manual failover, you should stop the workload on the database hosted on the SQL Server to allow Managed Instance link to completely catch up with the replication, so that failover without data loss is possible.
+1. On the **Clean up (optional)**, choose to drop the availability group if it was created solely for the purpose of migrating your database to Azure and you no longer need the availability group. If you want to keep the availability group, then leave the boxes unchecked. Select **Next**: 
 
-5. In case Availability Group and Distributed Availability Group were created only for the purpose of Managed Instance link, you can choose to drop these objects on the Clean-up window. Dropping these objects is optional. Click Next.
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-cleanup-optional.png" alt-text="Screenshot showing Cleanup (optional) window.":::
+   :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-cleanup-optional.png" alt-text="Screenshot showing Cleanup (optional) window.":::
 
-6. In the Summary window, you will be able to review the upcoming process. Optionally you can create the script to save it, or to execute it manually. If everything is as expected and you want to proceed with the Managed Instance link database failover, click Finish.
+1. On the **Summary** page, review the actions that will be performed for your failover. (Optionally) You can also create a script to save and run yourself at a later time. When you're ready to proceed with the failover, select **Finish**: 
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-summary.png" alt-text="Screenshot showing Summary window.":::
+   :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-summary.png" alt-text="Screenshot showing Summary window.":::
 
-7. You will be able to track the progress of the process.
+7. The **Executing actions** page displays the progress of the actions:  
 
     :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-executing-actions.png" alt-text="Screenshot showing Executing actions window.":::
 
-8. Once all steps are completed, click Close.
+8. After all steps complete, the **Results** page shows a completed status, with checkmarks next to each successfully completed action. You can now close the window: 
 
     :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-results.png" alt-text="Screenshot showing Results window.":::
 
-9. After this, Managed Instance link no longer exists. Both databases on SQL Server and Managed Instance can execute read-write workload and are independent. 
-    With this step, the migration of the database from SQL Server to Managed Instance is completed.
+## View failed over database 
+
+During the failover process, the Managed Instance link is dropped and no longer exists. Both databases on the source SQL Server instance and target SQL Managed Instance can execute a read-write workload, and are completely independent. 
 
-    Database on SQL Server.
+You can validate this by reviewing the database on the source SQL Server: 
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-ssms-sql-server-database.png" alt-text="Screenshot showing database on SQL Server in SSMS.":::
+:::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-ssms-sql-server-database.png" alt-text="Screenshot showing database on SQL Server in SSMS.":::
 
-    Database on Managed Instance.
+And then reviewing the database on the target SQL Managed Instance: 
 
-    :::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-ssms-managed-instance-database.png" alt-text="Screenshot showing database on Managed Instance in SSMS.":::
+:::image type="content" source="./media/managed-instance-link-use-ssms-to-failover-database/link-failover-ssms-managed-instance-database.png" alt-text="Screenshot showing database on Managed Instance in SSMS.":::
 
 ## Next steps
 
 For more information about Managed Instance link feature, see the following resources:
 
-- [Managed Instance link feature](./link-feature.md)
+To learn more, see [Link feature in Azure SQL Managed Instance](link-feature.md). 

articles/azure-sql/managed-instance/managed-instance-link-use-ssms-to-replicate-database.md

@@ -1,24 +1,26 @@
 ---
-title: Use link feature in SSMS to replicate database 
+title: Replicate database with link feature in SSMS
 titleSuffix: Azure SQL Managed Instance
 description: This guide teaches you how to use the SQL Managed Instance link in SQL Server Management Studio (SSMS) to replicate database from SQL Server to Azure SQL Managed Instance.
 services: sql-database
 ms.service: sql-managed-instance
 ms.subservice: data-movement
-ms.custom: sqldbrb=1
+ms.custom: 
 ms.devlang: 
-ms.topic: tutorial
+ms.topic: guide
 author: sasapopo
 ms.author: sasapopo
 ms.reviewer: mathoma
 ms.date: 03/07/2022
 ---
-# Use link feature in SSMS to replicate database
+# Replicate database with link feature in SSMS
 
 [!INCLUDE[appliesto-sqlmi](../includes/appliesto-sqlmi.md)]
 
 This article teaches you to use the Managed Instance link feature to replicate your database from SQL Server to Azure SQL Managed Instance in SQL Server Management Studio (SSMS). 
 
+Before configuring replication for your database through the link feature, make sure you've [prepared your environment](managed-instance-link-preparation.md). 
+
 Managed Instance link is in public preview.
 
 ## Prerequisites 
@@ -30,9 +32,10 @@ To replicate your databases to Azure SQL Managed Instance, you need the followin
 - An instance of Azure SQL Managed Instance. [Get started](instance-create-quickstart.md) if you don't have one. 
 - [SQL Server Management Studio (SSMS) v 18.11 or later](/sql/ssms/download-sql-server-management-studio-ssms).
 - Network connectivity between SQL Server and SQL Managed Instance using either [Azure ExpressRoute](../../expressroute/expressroute-howto-circuit-portal-resource-manager.md), [Virtual network peering](../../virtual-network/virtual-network-peering-overview.md), or [VPN gateways](../../vpn-gateway/tutorial-create-gateway-portal.md). 
+- [Prepared your environment for replication](managed-instance-link-preparation.md).
 
 
-## Setup link
+## Replicate database
 
 Use the **New Managed Instance link** wizard in SQL Server Management Studio (SSMS) to setup the link between your instance of SQL Server and your instance of SQL Managed Instance. The wizard takes you through the process of creating the Managed Instance link. Once the link is created, your source database gets a read-only replica copy on your target Azure SQL Managed Instance. 
 
@@ -71,7 +74,7 @@ To set up the Managed Instance link, follow these steps:
 
     :::image type="content" source="./media/managed-instance-link-use-ssms-to-replicate-database/link-replicate-summary.png" alt-text="Screenshot showing Summary window.":::
 
-9. The **Executing actions** page displays the progress of the action:  
+9. The **Executing actions** page displays the progress of the actions:  
 
     :::image type="content" source="./media/managed-instance-link-use-ssms-to-replicate-database/link-replicate-executing-actions.png" alt-text="Screenshot showing Executing actions window.":::
 
@@ -94,4 +97,4 @@ Connect to  your SQL Managed Instance and use **Object Explorer** to view your r
 
 ## Next steps
 
-To learn more, see [Link feature in Azure SQL Managed Instance](./link-feature.md). 
+To learn more, see [Link feature in Azure SQL Managed Instance](link-feature.md). To break the link and failover your database to the SQL Managed Instance, see [failover database](managed-instance-link-use-ssms-to-failover-database.md). 

articles/azure-sql/managed-instance/media/managed-instance-link-use-ssms-to-failover-database/link-failover-login-to-azure.png

@@ -1229,11 +1229,13 @@
       - name: Migrate TDE cert 
         href: managed-instance/tde-certificate-migrate.md
 
-    - name: Use Managed Instance link
+    - name: Managed Instance link
       items:
-      - name: to replicate databases in SSMS
+      - name: Prepare environment for link 
+        href: managed-instance/managed-instance-link-preparation.md
+      - name: Replicate databases in SSMS
         href: managed-instance/managed-instance-link-use-ssms-to-replicate-database.md
-      - name: to failover databases in SSMS
+      - name: Failover databases in SSMS
         href: managed-instance/managed-instance-link-use-ssms-to-failover-database.md
 
     - name: Configure business continuity