Set up an appliance for physical servers

This article describes how to set up the Azure Migrate appliance if you're assessing physical servers with the Azure Migrate: Server Assessment tool.

The Azure Migrate appliance is a lightweight appliance, used by Azure Migrate Server Assessment to do the following:

  • Discover on-premises servers.
  • Send metadata and performance data for discovered servers to Azure Migrate Server Assessment.

Learn more about the Azure Migrate appliance.

Appliance deployment steps

To set up the appliance you:

  • Download a zipped file with Azure Migrate installer script from the Azure portal.
  • Extract the contents from the zipped file. Launch the PowerShell console with administrative privileges.
  • Execute the PowerShell script to launch the appliance web application.
  • Configure the appliance for the first time, and register it with the Azure Migrate project.

Download the installer script

Download the zipped file for the appliance.

  1. In Migration Goals > Servers > Azure Migrate: Server Assessment, click Discover.

  2. In Discover machines > Are your machines virtualized?, click Not virtualized/Other.

  3. Click Download to download the zipped file.

    Download VM

Verify security

Check that the zipped file is secure, before you deploy it.

  1. On the machine to which you downloaded the file, open an administrator command window.

  2. Run the following command to generate the hash for the zipped file:

    • C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]
    • Example usage for public cloud: C:\>CertUtil -HashFile C:\Users\administrator\Desktop\ SHA256
    • Example usage for government cloud: C:\>CertUtil -HashFile C:\Users\administrator\Desktop\ MD5
  3. Verify the latest version of the appliance, and hash values:

    • For the public cloud:

      Scenario Download* Hash value
      Physical (63.1 MB) Latest version 0a27adf13cc5755e4b23df0c05732c6ac08d1fe8850567cb57c9906fbc3b85a0
    • For Azure Government:

      Scenario Download* Hash value
      Physical (63.1 MB) Latest version 93dfef131026e70acdfad2769cd208ff745ab96a96f013cdf3f9e1e61c9b37e1

Run the Azure Migrate installer script

The installer script does the following:

  • Installs agents and a web application for physical server discovery and assessment.
  • Install Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
  • Download and installs an IIS rewritable module. Learn more.
  • Updates a registry key (HKLM) with persistent setting details for Azure Migrate.
  • Creates the following files under the path:
    • Config Files: %Programdata%\Microsoft Azure\Config
    • Log Files: %Programdata%\Microsoft Azure\Logs

Run the script as follows:

  1. Extract the zipped file to a folder on the server that will host the appliance. Make sure you don't run the script on a machine on an existing Azure Migrate appliance.

  2. Launch PowerShell on the above server with administrative (elevated) privilege.

  3. Change the PowerShell directory to the folder where the contents have been extracted from the downloaded zipped file.

  4. Run the script named AzureMigrateInstaller.ps1 by running the following command:

    • For the public cloud: PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1
    • For Azure Government: PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-Server-USGov>AzureMigrateInstaller.ps1

    The script will launch the appliance web application when it finishes successfully.

If you come across any issues, you can access the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_Timestamp.log for troubleshooting.

Verify appliance access to Azure

Make sure that the appliance VM can connect to Azure URLs for public and government clouds.

Configure the appliance

Set up the appliance for the first time.

  1. Open a browser on any machine that can connect to the VM, and open the URL of the appliance web app: https://appliance name or IP address: 44368.

    Alternately, you can open the app from the desktop by clicking the app shortcut.

  2. In the web app > Set up prerequisites, do the following:

    • License: Accept the license terms, and read the third-party information.
    • Connectivity: The app checks that the VM has internet access. If the VM uses a proxy:
      • Click Proxy settings, and specify the proxy address and listening port, in the form http://ProxyIPAddress or http://ProxyFQDN.
      • Specify credentials if the proxy needs authentication.
      • Only HTTP proxy is supported.
    • Time sync: Time is verified. The time on the appliance should be in sync with internet time for VM discovery to work properly.
    • Install updates: Azure Migrate Server Assessment checks that the appliance has the latest updates installed.

Register the appliance with Azure Migrate

  1. Click Log In. If it doesn't appear, make sure you've disabled the pop-up blocker in the browser.
  2. On the new tab, sign in using your Azure credentials.
    • Sign in with your username and password.
    • Sign-in with a PIN isn't supported.
  3. After successfully signing in, go back to the web app.
  4. Select the subscription in which the Azure Migrate project was created. Then select the project.
  5. Specify a name for the appliance. The name should be alphanumeric with 14 characters or less.
  6. Click Register.

Start continuous discovery

Connect from the appliance to physical servers, and start the discovery.

  1. Click Add Credentials to specify the account credentials that the appliance will use to discover servers.
  2. Specify the Operating System, a friendly name for the credentials, and the username and password. Then click Add. You can add one set of credentials each for Windows and Linux servers.
  3. Click Add server, and specify server details- FQDN/IP address and friendly name of credentials (one entry per row) to connect to the server.
  4. Click Validate. After validation, the list of servers that can be discovered is shown.
    • If validation fails for a server, review the error by hovering over the icon in the Status column. Fix issues, and validate again.
    • To remove a server, select > Delete.
  5. After validation, click Save and start discovery to start the discovery process.

This starts discovery. It takes around 15 minutes for metadata of discovered VMs to appear in the Azure portal.

Verify servers in the portal

After discovery finishes, you can verify that the servers appear in the portal.

  1. Open the Azure Migrate dashboard.
  2. In Azure Migrate - Servers > Azure Migrate: Server Assessment page, click the icon that displays the count for Discovered servers.

Next steps

Try out assessment of physical servers with Azure Migrate Server Assessment.