You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Set up an Azure Migrate appliance with a script
3
3
description: Learn how to set up an Azure Migrate appliance with a script
4
4
ms.topic: article
5
-
ms.date: 03/23/2020
5
+
ms.date: 04/16/2020
6
6
---
7
7
8
8
9
9
# Set up an appliance with a script
10
10
11
-
This article describes how to set up the [Azure Migrate appliance](deploy-appliance.md) using a PowerShell installer script.
11
+
This article describes how to set up the [Azure Migrate appliance](deploy-appliance.md) using a PowerShell installer script, for VMware VMs, and Hyper-V VMs. If you want to set up the appliance for physical servers, [review this article](how-to-set-up-appliance-physical.md).
12
12
13
13
14
14
You can deploy the appliance using a couple of methods:
@@ -33,32 +33,109 @@ The script sets up the Azure Migrate appliance on an existing physical machine o
33
33
- 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).
34
34
- Don't run the script on an existing Azure Migrate appliance.
35
35
36
+
## Set up the appliance for VMware
36
37
37
-
## Download the script
38
+
To set up the appliance for VMware you download a zipped file from the Azure portal, and extract the contents. You run the PowerShell script to launch the appliance web app. You set up the appliance and configure it for the first time. Then, you register the appliance with the Azure Migrate project.
38
39
39
-
1. Locate the machine/VM that will act as the Azure Migrate appliance.
40
-
2. On the machine, do the following:
40
+
### Download the script
41
41
42
-
- 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.
43
-
- 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).
42
+
1. In **Migration Goals** > **Servers** > **Azure Migrate: Server Assessment**, click **Discover**.
43
+
2. In **Discover machines** > **Are your machines virtualized?**, select **Yes, with VMWare vSphere hypervisor**.
44
+
3. Click **Download**, to download the zipped file.
44
45
45
-
## Verify file security
46
+
47
+
### Verify file security
48
+
49
+
Check that the zipped file is secure, before you deploy it.
50
+
51
+
1. On the machine to which you downloaded the file, open an administrator command window.
52
+
2. Run the following command to generate the hash for the zipped file
1. Extract the zipped file to a folder on the machine that will host the appliance. Make sure you don't run the script on a machine on an existing Azure Migrate appliance.
88
+
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
89
+
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
90
+
4. Run the script **AzureMigrateInstaller.ps1**, as follows:
91
+
- For the public cloud: ``` PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 -scenario VMware ```
92
+
- For Azure Government: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-VMWare-USGov>AzureMigrateInstaller.ps1 ```
93
+
94
+
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, review the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log.
95
+
96
+
### Verify access
97
+
98
+
Make sure that the appliance can connect to Azure URLs for [public](migrate-appliance.md#public-cloud-urls) and [government clouds](migrate-appliance.md#government-cloud-urls.
99
+
100
+
101
+
## Set up the appliance for Hyper-V
102
+
103
+
To set up the appliance for Hyper-V you download a zipped file from the Azure portal, and extract the contents. You run the PowerShell script to launch the appliance web app. You set up the appliance and configure it for the first time. Then, you register the appliance with the Azure Migrate project.
104
+
105
+
### Download the script
106
+
107
+
1. In **Migration Goals** > **Servers** > **Azure Migrate: Server Assessment**, click **Discover**.
108
+
2. In **Discover machines** > **Are your machines virtualized?**, select **Yes, with Hyper-V**.
109
+
3. Click **Download**, to download the zipped file.
110
+
111
+
112
+
### Verify file security
46
113
47
114
Check that the zipped file is secure, before you deploy it.
48
115
49
116
1. On the machine to which you downloaded the file, open an administrator command window.
50
117
2. Run the following command to generate the hash for the zipped file
- For Azure government (for the latest appliance version):
60
132
61
-
## Run the script
133
+
**Algorithm** | **Hash value**
134
+
--- | ---
135
+
MD5 | 717f8b9185f565006b5aff0215ecadac
136
+
137
+
138
+
### Run the script
62
139
63
140
Here's what the script does:
64
141
@@ -72,28 +149,24 @@ Here's what the script does:
72
149
73
150
To run the script:
74
151
75
-
1. Extract the zipped file to a folder on the machine that will host the appliance.
152
+
1. Extract the zipped file to a folder on the machine that will host the appliance. Make sure you don't run the script on a machine on an existing Azure Migrate appliance.
76
153
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
77
154
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
78
-
4. Run the script **AzureMigrateInstaller.ps1** as follows:
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.
155
+
4. Run the script **AzureMigrateInstaller.ps1**, as follows:
156
+
- For the public cloud: ``` PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 -scenario Hyperv ```
157
+
- For Azure Government: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-HyperV-USGov>AzureMigrateInstaller.ps1 ```
158
+
159
+
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, review the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log.
160
+
161
+
### Verify access
162
+
163
+
Make sure that the appliance can connect to Azure URLs for [public](migrate-appliance.md#public-cloud-urls) and [government clouds](migrate-appliance.md#government-cloud-urls.
164
+
165
+
93
166
94
167
## Next steps
95
168
96
-
After you've set up the appliance using the script, follow these instructions:
169
+
To learn more about setting up the appliance with a template, or for physical servers, review these articles:
97
170
98
171
- Set up the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance).
99
172
- Set up the appliance for [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance).
- Example usage: ```C:\>CertUtil -HashFile C:\AzureMigrate\AzureMigrate.ova SHA256```
49
-
3. For the latest appliance version, the generated hash should match these [settings](https://docs.microsoft.com/azure/migrate/tutorial-assess-physical#verify-security).
48
+
- Example usage for public cloud: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256 ```
49
+
- Example usage for government cloud: ``` C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller-Server-USGov.zip MD5 ```
50
+
3. Verify hash values:
51
+
52
+
- For the public cloud (for the latest appliance version):
- For Azure government (for the latest appliance version):
60
+
61
+
**Algorithm** | **Hash value**
62
+
--- | ---
63
+
MD5 | f81c155fc4a1409901caea948713913f
51
64
52
65
53
66
## Run the Azure Migrate installer script
@@ -63,19 +76,19 @@ The installer script does the following:
63
76
64
77
Run the script as follows:
65
78
66
-
1. Extract the zipped file to a folder on the server that will host the appliance.
79
+
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.
67
80
2. Launch PowerShell on the above server with administrative (elevated) privilege.
68
81
3. Change the PowerShell directory to the folder where the contents have been extracted from the downloaded zipped file.
69
82
4. Run the script named **AzureMigrateInstaller.ps1** by running the following command:
The script will launch the appliance web application when it finishes successfully.
83
+
84
+
- For the public cloud: ``` PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 ```
85
+
- For Azure Government: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-Server-USGov>AzureMigrateInstaller.ps1 ```
86
+
87
+
The script will launch the appliance web application when it finishes successfully.
74
88
75
89
If you come across any issues, you can access the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log for troubleshooting.
76
90
77
-
> [!NOTE]
78
-
> Please do not execute the Azure Migrate installer script on an existing Azure Migrate appliance.
1. Extract the zipped file to a folder on the server that will host the appliance.
129
+
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.
122
130
2. Launch PowerShell on the above server with administrative (elevated) privilege.
123
131
3. Change the PowerShell directory to the folder where the contents have been extracted from the downloaded zipped file.
124
132
4. Run the script named **AzureMigrateInstaller.ps1** by running the following command:
The script will launch the appliance web application when it finishes successfully.
129
133
130
-
If you find any issues, you can access the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log for troubleshooting.
134
+
- For the public cloud: ``` PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 ```
135
+
- For Azure Government: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-Server-USGov>AzureMigrateInstaller.ps1 ```
131
136
132
-
> [!NOTE]
133
-
> Please do not execute the Azure Migrate installer script on an existing Azure Migrate appliance.
137
+
The script will launch the appliance web application when it finishes successfully.
138
+
139
+
If you come across any issues, you can access the script logs at C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_<em>Timestamp</em>.log for troubleshooting.
0 commit comments