Discover machine apps, roles, and features

This article describes how to discover applications, roles, and features on on-premises servers, using Azure Migrate: Server Assessment.

Discovering the inventory of apps, and roles/features running on your on-premises machines helps you to identify and plan a migration path to Azure that's tailored for your workloads.


App discovery is currently in preview for VMware VMs only, and is limited to discovery only. We don't yet offer app-based assessment. Machine-based assessment for on-premises VMware VMs, Hyper-V VMs, and physical servers.

App discovery using Azure Migrate: Server Assessment is agentless. Nothing is installed on machines and VMs. Server Assessment uses the Azure Migrate appliance to perform discovery along with machine guest credentials. The appliance remotely accesses the VMware machines using VMware APIs.

Before you start

  1. Make sure you've created an Azure Migrate project.
  2. Make sure you've added the Azure Migrate: Server Assessment tool to a project.
  3. Check the VMware requirements for discovering and assessing VMware VMs with the Azure Migrate appliance.
  4. Check the requirements for deploying the Azure Migrate appliance.
  5. Verify support and requirements for application discovery.

Deploy the Azure Migrate appliance

  1. Review the requirements for deploying the Azure Migrate appliance.
  2. Review the Azure URLs that the appliance will need to access in the public and government clouds.
  3. Review data that the appliance collects during discovery and assessment.
  4. Note port access requirements for the appliance.
  5. Deploy the Azure Migrate appliance to start discovery. To deploy the appliance, you download and import an OVA template into VMware to create the appliance as a VMware VM. You configure the appliance and then register it with Azure Migrate.
  6. As you deploy the appliance, to start continuous discovery you specify the following:
    • The name of the vCenter Server to which you want to connect.
    • Credentials that you created for the appliance to connect to vCenter Server.
    • The account credentials you created for the appliance to connect to Windows/Linux VMs.

After the appliance is deployed and you've provided credentials, the appliance starts continuous discovery of VM metadata and performance data, along with and discovery of apps, features, and roles. The duration of app discovery depends on how many VMs you have. It typically takes an hour for app-discovery of 500 VMs.

Prepare a user account

Create an account to use for discovery, and add it to the appliance.

Create a user account for discovery

Set up a user account so that Server Assessment can access the VM for discovery. Learn about account requirements.

Add the user account to the appliance

Add the user account to the appliance.

  1. Open the appliance management app.

  2. Navigate to the Provide vCenter details panel.

  3. In Discover application and dependencies on VMs, click Add credentials

  4. Choose the Operating system, provide a friendly name for the account, and the User name/Password

  5. Click Save.

  6. Click Save and start discovery.

    Add VM user account

Review and export the inventory

After discovery ends, if you provided credentials for app discovery, you can review and export the app inventory in the Azure portal.

  1. In Azure Migrate - Servers > Azure Migrate: Server Assessment, click the displayed count to open the Discovered servers page.


    At this stage you can also optionally set up dependency mapping for discovered machines, so that you can visualize dependencies across machines you want to assess. Learn more.

  2. In Applications discovered, click the displayed count.

  3. In Application inventory, you can review the discovered apps, roles, and features.

  4. To export the inventory, in Discovered Servers, click Export app inventory.

The app inventory is exported and downloaded in Excel format. The Application Inventory sheet displays all the apps discovered across all the machines.

Next steps