|
| 1 | +--- |
| 2 | +title: Set up an Azure Migrate appliance with a script |
| 3 | +description: Learn how to set up an Azure Migrate appliance with a script |
| 4 | +ms.topic: article |
| 5 | +ms.date: 03/23/2020 |
| 6 | +--- |
| 7 | + |
| 8 | + |
| 9 | +# Set up an appliance with a script |
| 10 | + |
| 11 | +This article describes how to set up the [Azure Migrate appliance](deploy-appliance.md) using a PowerShell installer script. |
| 12 | + |
| 13 | +The script provides: |
| 14 | +- An alternative to setting up the appliance using a OVA template, for assessment and agentless migration of VMware VMs. |
| 15 | +- An alternative to setting up the appliance using a VHD template, for assessment and migration of Hyper-V VMs. |
| 16 | +- For assessment of physical servers, the script is the only method available for setting up the appliance. |
| 17 | + |
| 18 | +## Prerequisites |
| 19 | + |
| 20 | +The script sets up the Azure Migrate appliance on an existing physical machine or VM. |
| 21 | + |
| 22 | +- The machine on which you run the script to set up the appliance must be running Windows Server 2016, with 32 GB of memory, eight vCPUs, around 80 GB of disk storage, and an external virtual switch. |
| 23 | +- Before you start, review appliance requirements for [VMware VMs](migrate-appliance.md#appliance---vmware), [Hyper-V VMs](migrate-appliance.md#appliance---hyper-v), and [physical servers](migrate-appliance.md#appliance---physical). |
| 24 | +- Don't run the script on an existing Azure Migrate appliance. |
| 25 | + |
| 26 | + |
| 27 | +## Download the script |
| 28 | + |
| 29 | +1. Locate the machine/VM that will act as the Azure Migrate appliance. |
| 30 | +2. On the machine, do the following: |
| 31 | + |
| 32 | + - To use the appliance with VMware VMs or Hyper-V VMs, [download](https://go.microsoft.com/fwlink/?linkid=2105112) the zipped folder containing the installer script and the MSIs. |
| 33 | + - To use the appliance with physical servers, download the script from the Azure Migrate portal, as described in this [tutorial](tutorial-assess-physical.md#set-up-the-appliance). |
| 34 | + |
| 35 | +## Verify file security |
| 36 | + |
| 37 | +Check that the zipped file is secure, before you deploy it. |
| 38 | + |
| 39 | +1. On the machine to which you downloaded the file, open an administrator command window. |
| 40 | +2. Run the following command to generate the hash for the zipped file |
| 41 | + - ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]``` |
| 42 | + - Example usage: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256``` |
| 43 | + |
| 44 | +3. Verify that the generated hash values match these settings (these are for the latest appliance version): |
| 45 | + |
| 46 | + **Algorithm** | **Hash value** |
| 47 | + --- | --- |
| 48 | + MD5 | 1e92ede3e87c03bd148e56a708cdd33f |
| 49 | + SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c |
| 50 | + |
| 51 | +## Run the script |
| 52 | + |
| 53 | +Run the installer script to: |
| 54 | + |
| 55 | +- Installs agents and a web application. |
| 56 | +- Install Windows roles, including Windows Activation Service, IIS, and PowerShell ISE. |
| 57 | +- Download and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435). |
| 58 | +- Updates a registry key (HKLM), with persistent setting details for Azure Migrate. |
| 59 | +- Creates log and configuration files as follows: |
| 60 | + - **Config Files**: %ProgramData%\Microsoft Azure\Config |
| 61 | + - **Log Files**: %ProgramData%\Microsoft Azure\Logs |
| 62 | + |
| 63 | +To run the script: |
| 64 | + |
| 65 | +1. Extract the zipped file to a folder on the machine that will host the appliance. |
| 66 | +2. Launch PowerShell with administrator (elevated) privileges. |
| 67 | +3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file. |
| 68 | +4. Run the script **AzureMigrateInstaller.ps1** as follows: |
| 69 | + |
| 70 | + - For VMware: |
| 71 | + ``` |
| 72 | + PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 -scenario VMware |
| 73 | + ``` |
| 74 | + - For Hyper-V: |
| 75 | + ``` |
| 76 | + PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 -scenario Hyperv |
| 77 | + ``` |
| 78 | + - For physical servers: |
| 79 | + ``` |
| 80 | + PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 |
| 81 | + ``` |
| 82 | +5. After the script runs successfully, it launches the appliance web application so that you can set up the appliance. If you encounter any issues, you can view the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log. |
| 83 | +
|
| 84 | +## Next steps |
| 85 | +
|
| 86 | +After you've set up the appliance using the script, follow the instructions to configure the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance), [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance), or physical servers for the first time. |
0 commit comments