Update tutorial-discover-mysql-database-instances.md

ankitsurkar06 · web-flow · commit 4969d4a3718f · 2025-04-24T19:40:46.000+05:30
updated changes for MySQL instance discovery using single appliance
diff --git a/articles/migrate/tutorial-discover-mysql-database-instances.md b/articles/migrate/tutorial-discover-mysql-database-instances.md
@@ -11,20 +11,8 @@ monikerRange: migrate-classic
 
 # Tutorial: Discover MySQL database instances running in your datacenter (preview)
 
-This article describes how to discover MySQL database instances running on servers in your datacenter, using **Azure Migrate: Discovery and assessment tool**. The discovery process is agentless; no agents are installed on the target servers.
-
-In this tutorial, you learn how to:
-> [!div class="checklist"]
-> - [Set up Kubernetes based appliance for discovery of MySQL database instances](#set-up-kubernetes-based-appliance)
-> - [Encryption at rest](#encryption-at-rest)
-> - [Configure the appliance and initiate continuous discovery](#configure-kubernetes-based-appliance)
-> - [Clean up of setup](#clean-up-of-setup)
-> - [Overview of Discovery results](#overview-of-discovery-results)
-
-
-> [!NOTE]
-> - A Kubernetes-based appliance is required to discover MySQL database instances. [Learn more](migrate-appliance.md) about scenarios covered by a Windows-based appliance.
 
+This article describes how to discover MySQL database instances running on servers in your datacenter, using **Azure Migrate appliance**. The discovery process is agentless; no agents are installed on the target servers. 
 
 ## Supported regions
 
@@ -42,11 +30,10 @@ The following table lists the regions that support MySQL Discovery and Assessmen
 | United Kingdom | UK South |
 | United States  | Central US </br> West US 2 | 
 
-
 ## Prerequisites
 
 - An Azure subscription. If you don't have one, create a [free account](https://azure.microsoft.com/pricing/free-trial/).
-- Before you begin to discover MySQL database instances, use the below tutorials to create an Azure Migrate project as per your requirements in one of the [supported regions](#supported-regions):
+- Before you begin to discover MySQL database instances, use the below links to create an Azure Migrate project and deploy an appliance as per your requirements in one of the [supported regions](#supported-regions):
 
    - [Discover servers running in a VMware environment](tutorial-discover-vmware.md)
    - [Discover servers running in Hyper-V environment](tutorial-discover-hyper-v.md)
@@ -58,186 +45,19 @@ The following table lists the regions that support MySQL Discovery and Assessmen
 - Ensure that you perform the [discovery of software inventory](how-to-discover-applications.md) by providing the server credentials to the appliance configuration manager.
 
 > [!NOTE]
-> Only Azure Migrate projects created with public endpoint connectivity are supported. Private endpoint projects aren't supported.
-
-
-## Set up Kubernetes-based appliance
-
-After you complete the server discovery and software inventory using the Azure Migrate appliance, follow these steps to enable discovery of MySQL database instances by setting up a Kubernetes appliance:
-
-### Onboard Kubernetes-based appliance
-
-1. Sign in to the  [Azure portal](https://portal.azure.com) and search for **Azure Migrate**.
-1. In **Servers, databases and web apps**, select **Discover, assess and migrate**.
-1. Select the Azure Migrate project to set up the Kubernetes-based appliance
-1. You'll see a message above **Azure Migrate: Discovery and assessment** tile to onboard a Kubernetes-based appliance to enable discovery of MySQL databases and Spring Boot applications. Select the link on the message to get started with onboarding the Kubernetes-based appliance.
-
-    :::image type="content" source="./media/tutorial-discover-mysql-database-instances/kubernetes-appliance-install-message.png" alt-text="Screenshot on how to get started onboarding kubernetes based appliance." lightbox="media/tutorial-discover-mysql-database-instances/kubernetes-appliance-install-message.png":::
-   
-1. In the Onboard Kubernetes-based appliance page, under the **Setup appliance** section, choose either one of the options.
-
-   - **Install appliance using packaged Kubernetes cluster** (recommended). You must set up a Kubernetes-cluster on a Linux server and then use the installer script to set up the Azure Migrate appliance. 
-   - **Bring your own Kubernetes cluster**: You must bring your own Kubernetes cluster running on-premises, connect it to Azure Arc, and use the installer script to set up the appliance.
-
-   #### [Install appliance using packaged Kubernetes cluster (recommended)](#tab/appliance-kcluster)
-
-   To install an appliance using the packaged Kubernetes cluster, follow these steps:
-
-   1. In **Provide appliance details for Azure Migrate**, the appliance name is shown by default, but you can choose to provide your own friendly name to the appliance.
-
-   1. Select a Key Vault from the drop-down list or **Create new** Key Vault. This Key Vault is used to process the credentials provided in the project to start discovery of MySQL database instances.
-
-      > [!NOTE]
-      > You can select or create in the same subscription and region as that of the Azure Migrate Project. When you create/select Key Vault, ensure it doesn't have purge protection enabled, else there will be issues in processing of credentials through the Key Vault. 
-
-   #### [Bring your own Kubernetes cluster](#tab/appliance-byo-kcluster)
-   
-   To bring your own Kubernetes cluster, follow these steps:
-
-   1. In **Choose connected cluster**, select an existing Azure Arc connected cluster from your subscription. If you don't have an existing connected cluster, you can Arc-enable a Kubernetes cluster running on-premises by following the steps [here](/azure/azure-arc/kubernetes/quickstart-connect-cluster?tabs=azure-cli).
-
-      > [!Note]
-      > You can only select an existing connected cluster that's deployed in the same region as your Azure Migrate project.
-
-   1. In **Provide appliance details for Azure Migrate**, the appliance name is provided by default. However, you can provide a friendly name.
-
-   1. You can select a Key Vault from the drop-down or **Create new** Key Vault. This Key Vault is used to process the credentials provided in the project to start discovery of MySQL database instances.
-
-   > [!Note]
-   > You can choose or create the Key Vault in the same subscription and region as that of the Azure Migrate project. When you create/select a Key Vault, ensure that purge protection is disabled else, there will be issues in processing of credentials through the Key Vault.
-
-    ---
-
-1.	After you provide the appliance name and Key Vault, select **Generate script** to generate an installer script that you can download or copy the script and save it as </br>
-  `Deploy.sh` on a Linux server on-premises.
-
-1.	Before you execute the script, ensure that the following prerequisites on the Linux server are met:
-
-    **Support** | **Details**
-    ---- | ----
-    **Supported Linux OS** | Ubuntu 20.04
-    **Hardware configuration required** | 16-GB RAM, with 30-GB storage, 8 Core CPU
-    **Network Requirements** | Access to the following endpoints: <br/><br/> https://dc.services.visualstudio.com/v2/track <br/><br/> [Azure CLI endpoints for proxy bypass](/cli/azure/azure-cli-endpoints) 
-
-
-### Connect using an outbound proxy server
-
-If your machine is behind an outbound proxy server, requests must be routed via the outbound proxy server. To provide proxy settings, follow these steps:
-
-1. Open the terminal on the server and execute the following command to set up environment variables as a root user: </br>
-   `sudo su -`
-1. On the deployment machine, set the environment variables needed for </br> `deploy.sh` </br> to use the outbound proxy server:
-    
-    ```
-    export HTTP_PROXY=”<proxy-server-ip-address>:<port>”
-    export HTTPS_PROXY=”<proxy-server-ip-address>:<port>”
-    export NO_PROXY=””
-    ```
-
-1. If your proxy uses a certificate, provide the absolute path to the certificate.
-   `export PROXY_CERT=””`
-
-   > [!Note] 
-   > The machine uses proxy details while installing the required prerequisites to run the </br>`deploy.sh script`. </br> It won't override the proxy settings of the Azure Arc-enabled Kubernetes cluster.
-
-### Execute the installer script
+> Only Azure Migrate projects created with public endpoint connectivity are supported. Private endpoint projects aren't supported in the preview.
 
-Before you execute the installer script, ensure that you have verified the following prerequisites:
+## Provide MySQL credentials
 
-**Packaged Kubernetes cluster**
-
- - Run the script after you connect to a Linux machine on its terminal that has met the networking prerequisite and OS compatibility.  
- - Ensure that you install curl on the server. For Ubuntu, you can install it using the command </br>`sudo apt-get install curl` </br> For other OS (RHEL), you can use the command </br>  `yum install curl`.
- - Ensure that you install microk8s 1.29 on the server. For Ubuntu, you can install using the command </br> `sudo snap install microk8s --classic --channel=1.29/stable`.</br> Learn more on [how to install microk8s on Red Hat Enterprise Linux 9](https://snapcraft.io/install/microk8s/rhel).
-
-**Bring your own cluster**
- 
- - Run the script after you connect to a Linux machine on its terminal that meets the networking prerequisites and OS compatibility. 
- - Ensure that you have curl installed on the server. For Ubuntu, you can install it using the command </br> `sudo apt-get install curl` </br> and for other OS (RHEL), you can use the command </br> `yum install curl`
-
-> [!Important]
-> Don't edit the script before you execute it. You can only edit the script when you want to [clean up the setup](#clean-up-of-setup).
-
-After you save the script on the Linux server, follow these steps:
-
-1. Open the Terminal on the server and execute the following command to execute the script as a root user: 
-    `sudo su -` 
-
-1. Change the directory to where you saved the script and execute the script using command: `bash deploy.sh` 
-
-1. Follow the instructions in the script and sign in with your Azure user account when prompted. 
-
-1. The script performs the following: 
-
-    1. Installs required CLI extensions
-    2. Registers Azure Resource Providers 
-    3. Checks for prerequisites like connectivity to required endpoints 
-    4. Sets up MicroK8s Kubernetes cluster 
-    5. Installs the required operators on the cluster 
-    6. Creates the required Migrate resources 
-    
-1. After the script is executed successfully, configure the appliance through the portal.
-
-
-> [!NOTE]
-> Rerun the script if you encounter any issue during script execution and it would resume from the last successful state. In case you want to perform a complete fresh install, see [cleanup of setup](#clean-up-of-setup) details before you rerun the script.
-
-## Encryption at rest
-
-To ensure that Kubernetes secrets are secured, go through the following recommendations:
-
-#### [Packaged Kubernetes cluster](#tab/cluster)
-
-As you're setting a packaged appliance, we have shared responsibility to ensure that the secrets are secured.  
-- We recommend you choose a Linux VM with disk encryption for its services.
-
-#### [Bring your own Kubernetes cluster](#tab/encrypt-rest)
-
-As you bring your own Kubernetes cluster, there's a shared responsibility to ensure that the secrets are secured. 
-- We recommend you choose a Kubernetes cluster with disk encryption for its services. 
-- [Learn more](https://kubernetes.io/docs/tasks/administer-cluster/encrypt-data/) about encrypting data at rest in Kubernetes.
-
----
-
-
-## Configure Kubernetes-based appliance
-
-After you successfully set up the appliance using the installer script, configure the appliance by following these steps:
-
-1. Go to the Azure Migrate project where you started onboarding the Kubernetes-based appliance.
-1. On the **Azure Migrate: Discovery and assessment** tile, select the appliance count for **Pending action** under appliances summary. 
-
-   :::image type="content" source="./media/tutorial-discover-mysql-database-instances/kubernetes-appliance-pending-actions.png" alt-text="Screenshot shows the appliance count for pending action.":::
-
-1. In **Overview** > **Manage** > **Appliances**, a filtered list of appliances appears with actions pending.
-1. Find the Kubernetes-based appliance that you set up and select **Credentials unavailable** status to configure the appliance.
-1. In the **Manage credentials** page, select **Add credentials** to initiate discovery of the MySQL database instances running on your servers.
-1. Select **MySQL authentication** credential type, provide a friendly name, input the MySQL username, and password and select **Save**.
+1. Open the appliance configuration manager, complete the prerequisite checks and registration of the appliance.
+2. Navigate to the Manage credentials and discovery sources panel.
+1. In Step 3: Select **MySQL authentication** credential type, provide a friendly name, input the MySQL username, and password and select **Save**.
 
    > [!NOTE]
-   > - The credentials added on the portal are processed via the Azure Key Vault chosen in the initial steps of onboarding the Kubernetes-based appliance. The credentials are then synced (saved in an encrypted format) to the Kubernetes cluster on the appliance and removed from the Azure Key Vault.
-   > - After the credentials are successfully synced, they would be used for discovery of the specific workload in the next discovery cycle.
    > - Ensure that the user corresponding to the added MySQL credentials have the following privileges: 
    >    - Select permission on information_schema tables.
    >    - Select permission on mysql.users table.
 
-1. For a more detailed and accurate assessment of your MySQL database instances hosted on Linux servers, you’ll also need to add the server credentials. Select **Add credentials** once again and add the Linux server credentials under the credential type **Linux guest**. 
-
-1. After you add the credentials, refresh the page to see the **Sync status** of the credential. If status is **Incomplete**, you can select the status to review the error encountered and take the recommended action. After the credentials are successfully synced, wait for 24 hours before you can review the discovered inventory by filtering for the specific workload in the **Discovered servers** page.
-
-   > [!NOTE]
-   > You can add/update credentials any time by navigating to **Azure Migrate: Discovery and assessment** > **Overview** > **Manage** > **Appliances** page, selecting **Manage credentials** from the options available in the Kubernetes-based appliance. 
-
-## Clean up of setup
-
-To clean up, run the following script in delete mode:
-
-In the script generated by the portal, after all the user arguments (after line 19 in the following image), add `export DELETE= “true”` and run the same script again. This cleans up all existing components created during appliance creation.
-
-:::image type="content" source="./media/tutorial-discover-spring-boot/delete-image.png" alt-text="Screenshot shows delete mode." lightbox="./media/tutorial-discover-spring-boot/delete-image.png":::
-
-## Overview of Discovery results
-
 You can review the discovered MySQL databases after around 24 hours of discovery initiation, through the **Discovered servers** view.
 
 1. On the **Azure Migrate: Discovery and assessment** tile on the Hub page, select the number below the **Discovered servers**.
@@ -263,4 +83,4 @@ You can review the discovered MySQL databases after around 24 hours of discovery
 
 ## Next steps
 - Learn how to [create and run a MySQL assessment](create-mysql-assessment.md).
-- Learn more about [how MySQL assessments are calculated](assessments-overview-migrate-to-azure-db-mysql.md).
+- Learn more about [how MySQL assessments are calculated](assessments-overview-migrate-to-azure-db-mysql.md).
