|
| 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 an 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 (or VMs that you want to migrate as physical servers), the script is the only method 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 that will act as 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. It requires a static or dynamic IP address, and access to the internet. |
| 23 | +- Before you deploy the appliance, review detailed 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 (for the latest appliance version): |
| 45 | + |
| 46 | + **Algorithm** | **Hash value** |
| 47 | + --- | --- |
| 48 | + MD5 | 1e92ede3e87c03bd148e56a708cdd33f |
| 49 | + SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c |
| 50 | + |
| 51 | +## Run the script |
| 52 | + |
| 53 | +Here's what the script does: |
| 54 | + |
| 55 | +- Installs agents and a web application. |
| 56 | +- Installs Windows roles, including Windows Activation Service, IIS, and PowerShell ISE. |
| 57 | +- Downloads 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 settings 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 on the machine, 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 these instructions: |
| 87 | +
|
| 88 | +- Set up the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance). |
| 89 | +- Set up the appliance for [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance). |
| 90 | +- Set up the appliance for [physical servers](how-to-set-up-appliance-physical.md). |
0 commit comments