Skip to content

Commit 7feeb8d

Browse files
PMEds28PMEds28
authored
Merge pull request #111914 from rayne-wiselman/rayneapril19-2
adding new article
2 parents 7192084 + fa00dc2 commit 7feeb8d

File tree

3 files changed

+215
-60
lines changed

3 files changed

+215
-60
lines changed

‎articles/migrate/deploy-appliance-script-government.md

Lines changed: 187 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,187 @@
1+
---
2+
title: Set up an Azure Migrate appliance in Azure Government
3+
description: Learn how to set up an Azure Migrate appliance in Azure Government
4+
ms.topic: article
5+
ms.date: 04/16/2020
6+
---
7+
8+
9+
# Set up an appliance in Azure Government
10+
11+
Follow this article to deploy an [Azure Migrate appliance](deploy-appliance.md) for VMware VMs, Hyper-V VMs, and physical servers, in an Azure Government cloud. You run a script to create the appliance, and verify that it can connect to Azure. If you want to set up an appliance in the public cloud, follow [this article](deploy-appliance-script.md).
12+
13+
14+
> [!NOTE]
15+
> The option to deploy an appliance using a template (for VMware VMs and Hyper-V VMs) isn't supported in Azure Government.
16+
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+
## Set up the appliance for VMware
27+
28+
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.
29+
30+
### Download the script
31+
32+
1. In **Migration Goals** > **Servers** > **Azure Migrate: Server Assessment**, click **Discover**.
33+
2. In **Discover machines** > **Are your machines virtualized?**, select **Yes, with VMWare vSphere hypervisor**.
34+
3. Click **Download**, to download the zipped file.
35+
36+
37+
### Verify file security
38+
39+
Check that the zipped file is secure, before you deploy it.
40+
41+
1. On the machine to which you downloaded the file, open an administrator command window.
42+
2. Run the following command to generate the hash for the zipped file
43+
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
44+
- Example: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller-VMWare-USGov.zip MD5```
45+
46+
3. Verify the generated hash values. For the latest appliance version:
47+
48+
**Algorithm** | **Hash value**
49+
--- | ---
50+
MD5 | 6316bcc8bc932204295bfe33f4be3949
51+
52+
53+
### Run the script
54+
55+
Here's what the script does:
56+
57+
- Installs agents and a web application.
58+
- Installs Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
59+
- Downloads and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435).
60+
- Updates a registry key (HKLM), with persistent settings for Azure Migrate.
61+
- Creates log and configuration files as follows:
62+
- **Config Files**: %ProgramData%\Microsoft Azure\Config
63+
- **Log Files**: %ProgramData%\Microsoft Azure\Logs
64+
65+
To run the script:
66+
67+
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.
68+
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
69+
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
70+
4. Run the script **AzureMigrateInstaller.ps1**, as follows: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-VMWare-USGov>AzureMigrateInstaller.ps1 ```
71+
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.
72+
73+
### Verify access
74+
75+
Make sure that the appliance can connect to Azure URLs for [government clouds](migrate-appliance.md#government-cloud-urls).
76+
77+
78+
## Set up the appliance for Hyper-V
79+
80+
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.
81+
82+
### Download the script
83+
84+
1. In **Migration Goals** > **Servers** > **Azure Migrate: Server Assessment**, click **Discover**.
85+
2. In **Discover machines** > **Are your machines virtualized?**, select **Yes, with Hyper-V**.
86+
3. Click **Download**, to download the zipped file.
87+
88+
89+
### Verify file security
90+
91+
Check that the zipped file is secure, before you deploy it.
92+
93+
1. On the machine to which you downloaded the file, open an administrator command window.
94+
2. Run the following command to generate the hash for the zipped file
95+
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
96+
- Example: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller-HyperV-USGov.zip MD5```
97+
98+
3. Verify the generated hash values. For the latest appliance version:
99+
100+
**Algorithm** | **Hash value**
101+
--- | ---
102+
MD5 | 717f8b9185f565006b5aff0215ecadac
103+
104+
105+
### Run the script
106+
107+
Here's what the script does:
108+
109+
- Installs agents and a web application.
110+
- Installs Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
111+
- Downloads and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435).
112+
- Updates a registry key (HKLM), with persistent settings for Azure Migrate.
113+
- Creates log and configuration files as follows:
114+
- **Config Files**: %ProgramData%\Microsoft Azure\Config
115+
- **Log Files**: %ProgramData%\Microsoft Azure\Logs
116+
117+
To run the script:
118+
119+
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.
120+
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
121+
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
122+
4. Run the script **AzureMigrateInstaller.ps1**, as follows: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-HyperV-USGov>AzureMigrateInstaller.ps1 ```
123+
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.
124+
125+
### Verify access
126+
127+
Make sure that the appliance can connect to Azure URLs for [government clouds](migrate-appliance.md#government-cloud-urls).
128+
129+
130+
## Set up the appliance for physical servers
131+
132+
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.
133+
134+
### Download the script
135+
136+
1. In **Migration Goals** > **Servers** > **Azure Migrate: Server Assessment**, click **Discover**.
137+
2. In **Discover machines** > **Are your machines virtualized?**, select **Not virtualized/Other**.
138+
3. Click **Download**, to download the zipped file.
139+
140+
141+
### Verify file security
142+
143+
Check that the zipped file is secure, before you deploy it.
144+
145+
1. On the machine to which you downloaded the file, open an administrator command window.
146+
2. Run the following command to generate the hash for the zipped file
147+
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
148+
- Example: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller-Server-USGov.zip MD5```
149+
150+
3. Verify the generated hash values. For the latest appliance version:
151+
152+
**Algorithm** | **Hash value**
153+
--- | ---
154+
MD5 | f81c155fc4a1409901caea948713913f
155+
156+
157+
### Run the script
158+
159+
Here's what the script does:
160+
161+
- Installs agents and a web application.
162+
- Installs Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
163+
- Downloads and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435).
164+
- Updates a registry key (HKLM), with persistent settings for Azure Migrate.
165+
- Creates log and configuration files as follows:
166+
- **Config Files**: %ProgramData%\Microsoft Azure\Config
167+
- **Log Files**: %ProgramData%\Microsoft Azure\Logs
168+
169+
To run the script:
170+
171+
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.
172+
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
173+
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
174+
4. Run the script **AzureMigrateInstaller.ps1**, as follows: ``` PS C:\Users\Administrators\Desktop\AzureMigrateInstaller-Server-USGov>AzureMigrateInstaller.ps1 ```
175+
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.
176+
177+
### Verify access
178+
179+
Make sure that the appliance can connect to Azure URLs for [government clouds](migrate-appliance.md#government-cloud-urls).
180+
181+
## Next steps
182+
183+
After deploying the appliance, you need to configure it for the first time, and register it with the Azure Migrate project.
184+
185+
- Set up the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance).
186+
- Set up the appliance for [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance).
187+
- Set up the appliance for [physical servers](how-to-set-up-appliance-physical.md).

‎articles/migrate/deploy-appliance-script.md

Lines changed: 23 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,13 @@ ms.date: 04/16/2020
88

99
# Set up an appliance with a script
1010

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).
11+
Follow this article to create an [Azure Migrate appliance](deploy-appliance.md) for the assessment/migration of VMware VMs, and Hyper-V VMs. You run a script to create an appliance, and verify that it can connect to Azure.
1212

13+
You can deploy the appliance for VMware and Hyper-V VMs using a script, or using a template that you download from the Azure portal. Using a script is useful if you're unable to create a VM using the downloaded template.
1314

14-
You can deploy the appliance using a couple of methods:
15-
16-
17-
- Using a template for VMware VMs (OVA) or Hyper-V VMs (VHD).
18-
- Using a script. This is the method described in this article. The script provides:
19-
- An alternative to setting up the appliance using an OVA template, for assessment and agentless migration of VMware VMs.
20-
- An alternative to setting up the appliance using a VHD template, for assessment and migration of Hyper-V VMs.
21-
- 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.
22-
- A way to deploy the appliance in Azure Government.
23-
24-
25-
After creating the appliance, you verify that it can connect to Azure Migrate. You then configure the appliance for the first time, and register it with the Azure Migrate project.
26-
15+
- To use a template, follow the tutorials for [VMware](tutorial-prepare-vmware.md) or [Hyper-V](tutorial-prepare-hyper-v.md).
16+
- To set up an appliance for physical servers, you can only use a script. Follow [this article](how-to-set-up-appliance-physical.md).
17+
- To set up an appliance in an Azure Government cloud, follow [this article](deploy-appliance-script-government.md).
2718

2819
## Prerequisites
2920

@@ -51,24 +42,15 @@ Check that the zipped file is secure, before you deploy it.
5142
1. On the machine to which you downloaded the file, open an administrator command window.
5243
2. Run the following command to generate the hash for the zipped file
5344
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
54-
- Example usage for public cloud: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256```
55-
- Example usage for government cloud: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller-VMWare-USGov.zip```
56-
57-
3. Verify the generated hash values:
45+
- Example: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256```
46+
3. Verify the generated hash value. For the latest appliance version:
5847

59-
- For the public cloud (for the latest appliance version):
48+
**Algorithm** | **Hash value**
49+
--- | ---
50+
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
51+
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
6052

61-
**Algorithm** | **Hash value**
62-
--- | ---
63-
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
64-
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
6553

66-
- For Azure government (for the latest appliance version):
67-
68-
**Algorithm** | **Hash value**
69-
--- | ---
70-
MD5 | 6316bcc8bc932204295bfe33f4be3949
71-
7254

7355
### Run the script
7456

@@ -88,15 +70,14 @@ To run the script:
8870
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
8971
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
9072
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 ```
73+
74+
``` PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 -scenario VMware ```
9375

9476
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.
9577

9678
### Verify access
9779

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-
80+
Make sure that the appliance can connect to Azure URLs for the [public](migrate-appliance.md#public-cloud-urls) cloud.
10081

10182
## Set up the appliance for Hyper-V
10283

@@ -116,24 +97,14 @@ Check that the zipped file is secure, before you deploy it.
11697
1. On the machine to which you downloaded the file, open an administrator command window.
11798
2. Run the following command to generate the hash for the zipped file
11899
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
119-
- Example usage for public cloud: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256```
120-
- Example usage for government cloud: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller-HyperV-USGov.zip MD5```
121-
122-
3. Verify the generated hash values:
123-
124-
- For the public cloud (for the latest appliance version):
125-
126-
**Algorithm** | **Hash value**
127-
--- | ---
128-
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
129-
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
100+
- Example: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256```
130101

131-
- For Azure government (for the latest appliance version):
102+
3. Verify the generated hash values. For the latest appliance version:
132103

133-
**Algorithm** | **Hash value**
134-
--- | ---
135-
MD5 | 717f8b9185f565006b5aff0215ecadac
136-
104+
**Algorithm** | **Hash value**
105+
--- | ---
106+
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
107+
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
137108

138109
### Run the script
139110

@@ -152,22 +123,17 @@ To run the script:
152123
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.
153124
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
154125
3. Change the PowerShell directory to the folder containing the contents extracted from the downloaded zipped file.
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 ```
126+
4. Run the script **AzureMigrateInstaller.ps1**, as follows: ``` PS C:\Users\administrator\Desktop\AzureMigrateInstaller> AzureMigrateInstaller.ps1 -scenario Hyperv ```
158127

159128
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.
160129

161130
### Verify access
162131

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-
132+
Make sure that the appliance can connect to Azure URLs for the [public](migrate-appliance.md#public-cloud-urls) cloud.
166133

167134
## Next steps
168135

169-
To learn more about setting up the appliance with a template, or for physical servers, review these articles:
136+
After deploying the appliance, you need to configure it for the first time, and register it with the Azure Migrate project.
170137

171138
- Set up the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance).
172139
- Set up the appliance for [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance).
173-
- Set up the appliance for [physical servers](how-to-set-up-appliance-physical.md).

‎articles/migrate/toc.yml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -96,14 +96,16 @@
9696
href: how-to-assess.md
9797
- name: Deploy Azure Migrate appliance
9898
items:
99-
- name: Deploy appliance for VMware (OVA)
99+
- name: Deploy appliance with template (VMware)
100100
href: how-to-set-up-appliance-vmware.md
101-
- name: Deploy appliance for Hyper-V (VHD)
101+
- name: Deploy appliance with template (Hyper-V)
102102
href: how-to-set-up-appliance-hyper-v.md
103-
- name: Deploy appliance for VMware/Hyper-V (script)
103+
- name: Deploy appliance with script (VMware/Hyper-V)
104104
href: deploy-appliance-script.md
105105
- name: Deploy appliance for physical servers
106106
href: how-to-set-up-appliance-physical.md
107+
- name: Deploy appliance in Azure Government
108+
href: deploy-appliance-script-government.md
107109
- name: Limit discovery scope for VMware VMs
108110
href: set-discovery-scope.md
109111
- name: Discover applications/roles/features

0 commit comments

Comments
 (0)