Skip to content

Commit cb98d77

Browse files
authored
Merge pull request #111626 from rayne-wiselman/rayneapril15
updating articles for Azure Gov
2 parents a3afaa8 + 2318ef8 commit cb98d77

33 files changed

+534
-318
lines changed

articles/migrate/common-questions-appliance.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure Migrate appliance FAQ
33
description: Get answers to common questions about the Azure Migrate appliance.
44
ms.topic: conceptual
5-
ms.date: 03/09/2020
5+
ms.date: 04/15/2020
66
---
77

88
# Azure Migrate appliance: Common questions
@@ -26,6 +26,15 @@ Here's more information about the Azure Migrate appliance:
2626

2727
[Learn more](migrate-appliance.md) about the appliance.
2828

29+
## How can I deploy the appliance?
30+
31+
The appliance can be deployed as follows:
32+
33+
- Using a template for VMware VMs and Hyper-V VMs (OVA template for VMware or VHD for Hyper-V).
34+
- If you don't want to use a template, or you're in Azure Government, you can deploy the appliance for VMware or Hyper-V using a PowerShell script.
35+
- For physical servers, you always deploy the appliance using a script.
36+
37+
2938
## How does the appliance connect to Azure?
3039

3140
The appliance can connect over the internet or by using Azure ExpressRoute with public/Microsoft peering.
@@ -40,11 +49,8 @@ When you use the downloaded template to create the appliance VM, you can add com
4049

4150
## What network connectivity is required?
4251

43-
See the following articles for information about network connectivity requirements for the Azure Migrate appliance:
4452

45-
- **VMware assessment**: [URL access](migrate-appliance.md#url-access) and [port access](migrate-support-matrix-vmware.md#port-access)
46-
- **VMware agentless migration**: [URL access](migrate-appliance.md#url-access) and [port access](migrate-support-matrix-vmware-migration.md#agentless-ports)
47-
- **Hyper-V assessment**: [URL access](migrate-appliance.md#url-access) and [port access](migrate-support-matrix-hyper-v.md#port-access)
53+
The appliance needs access to Azure URLs. [Review](migrate-appliance.md#url-access) the URL list.
4854

4955
## What data does the appliance collect?
5056

articles/migrate/common-questions-discovery-assessment.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Questions about discovery, assessment, and dependency analysis in Azure Migrate
33
description: Get answers to common questions about discovery, assessment, and dependency analysis in Azure Migrate.
44
ms.topic: conceptual
5-
ms.date: 02/17/2020
5+
ms.date: 04/15/2020
66

77
---
88

@@ -15,10 +15,17 @@ This article answers common questions about discovery, assessment, and dependenc
1515
- Questions about [server migration](common-questions-server-migration.md)
1616
- Get questions answered in the [Azure Migrate forum](https://aka.ms/AzureMigrateForum)
1717

18+
19+
## What geographies are supported for discovery and assessment with Azure Migrate?
20+
21+
Review the supported geographies for [public](migrate-support-matrix.md#supported-geographies-public-cloud) and [government clouds](migrate-support-matrix.md#supported-geographies-azure-government).
22+
23+
1824
## How many VMs can I discover with an appliance?
1925

2026
You can discover up to 10,000 VMware VMs, up to 5,000 Hyper-V VMs, and up to 250 physical servers by using a single appliance. If you have more machines, read about [scaling a Hyper-V assessment](scale-hyper-v-assessment.md), [scaling a VMware assessment](scale-vmware-assessment.md), or [scaling a physical server assessment](scale-physical-assessment.md).
2127

28+
2229
## The size of my VM changed. Can I run an assessment again?
2330

2431
The Azure Migrate appliance continuously collects information about the on-premises environment. An assessment is a point-in-time snapshot of on-premises VMs. If you change the settings on a VM that you want to assess, use the recalculate option to update the assessment with the latest changes.

articles/migrate/common-questions-server-migration.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ This article answers common questions about the Azure Migrate: Server Migration
1414
- Questions about [discovery, assessment, and dependency visualization](common-questions-discovery-assessment.md)
1515
- Get questions answered in the [Azure Migrate forum](https://aka.ms/AzureMigrateForum)
1616

17+
## What geographies are supported for migration with Azure Migrate?
18+
19+
Review the supported geographies for [public](migrate-support-matrix.md#supported-geographies-public-cloud) and [government clouds](migrate-support-matrix.md#supported-geographies-azure-government).
20+
1721
## How does agentless VMware replication work?
1822

1923
The agentless replication method for VMware uses VMware snapshots and VMware Changed Block Tracking (CBT).

articles/migrate/concepts-assessment-calculation.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ This article provides an overview of assessments in the [Azure Migrate:Server As
1313

1414
An assessment with the Server Assessment tool measures the readiness, and estimates the impact, of migrating on-premises servers to Azure.
1515

16+
> [!NOTE]
17+
> In Azure Government, review the [supported target](migrate-support-matrix.md#supported-geographies-azure-government) assessment locations. Note that VM size recommendations in assessments will use the VM series specifically for Government Cloud regions. [Learn more](https://azure.microsoft.com/global-infrastructure/services/?regions=usgov-non-regional,us-dod-central,us-dod-east,usgov-arizona,usgov-iowa,usgov-texas,usgov-virginia&products=virtual-machines) about VM types.
18+
1619
## Types of assessments
1720

1821
Assessments you create with Server Assessment are a point-in-time snapshot of data. Server Assessment provides two types of assessments.
@@ -177,7 +180,7 @@ After the machine is marked as ready for Azure, Server Assessment makes sizing r
177180
If you use performance-basing sizing, Server Assessment making sizing recommendations as follows:
178181

179182
- Server Assessment considers the performance history of the machine to identify the VM size and disk type in Azure.
180-
- If servers have been imported using a CSV file, the values you specify are used. This method is especially helpful if you've over-allocated the on-premises machine, utilization is actually low, and you want to right-size the VM in Azure to save costs.
183+
- If servers have been imported using a CSV file, the values you specify are used. This method is especially helpful if you've over-allocated the on-premises machine, utilization is low, and you want to right-size the VM in Azure to save costs.
181184
- If you don't want to use the performance data, reset the sizing criteria to as-is on-premises, as described in the previous section.
182185

183186
#### Calculate storage sizing
@@ -269,4 +272,4 @@ Costs are displayed in the currency specified in the assessment settings.
269272

270273
- Learn about running assessments for [VMware VMs](tutorial-prepare-vmware.md), [Hyper-V VMs](tutorial-prepare-hyper-v.md), and [physical servers](tutorial-prepare-physical.md).
271274
- Learn about assessing servers [imported with a CSV file](tutorial-assess-import.md).
272-
- Learn about setting up [dependency visualization](concepts-dependency-visualization.md).
275+
- Learn about setting up [dependency visualization](concepts-dependency-visualization.md).

articles/migrate/concepts-dependency-visualization.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Dependency analysis in Azure Migrate Server Assessment
33
description: Describes how to use dependency analysis for assessment using Azure Migrate Server Assessment.
44
ms.topic: conceptual
5-
ms.date: 03/11/2020
5+
ms.date: 04/15/2020
66
---
77

88
# Dependency analysis
@@ -25,7 +25,7 @@ There are two options for deploying dependency analysis
2525
- **Agentless**: With agentless analysis, you don't need to install agents on machines you want to cross-check. This option is currently in preview, and is only available for VMware VMs.
2626

2727
> [!NOTE]
28-
> Dependency analysis isn't available in Azure Government.
28+
> Agent-based dependency analysis isn't available in Azure Government. You can use agentless dependency analysis.
2929
3030
## Agentless analysis
3131

articles/migrate/deploy-appliance-script.md

Lines changed: 119 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,28 @@
22
title: Set up an Azure Migrate appliance with a script
33
description: Learn how to set up an Azure Migrate appliance with a script
44
ms.topic: article
5-
ms.date: 03/23/2020
5+
ms.date: 04/16/2020
66
---
77

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.
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+
13+
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.
1226

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.
1727

1828
## Prerequisites
1929

@@ -23,32 +33,109 @@ The script sets up the Azure Migrate appliance on an existing physical machine o
2333
- 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).
2434
- Don't run the script on an existing Azure Migrate appliance.
2535

36+
## Set up the appliance for VMware
37+
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.
39+
40+
### Download the script
41+
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.
45+
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
53+
- ```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:
58+
59+
- For the public cloud (for the latest appliance version):
60+
61+
**Algorithm** | **Hash value**
62+
--- | ---
63+
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
64+
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
65+
66+
- For Azure government (for the latest appliance version):
67+
68+
**Algorithm** | **Hash value**
69+
--- | ---
70+
MD5 | 6316bcc8bc932204295bfe33f4be3949
71+
72+
73+
### Run the script
74+
75+
Here's what the script does:
76+
77+
- Installs agents and a web application.
78+
- Installs Windows roles, including Windows Activation Service, IIS, and PowerShell ISE.
79+
- Downloads and installs an IIS rewritable module. [Learn more](https://www.microsoft.com/download/details.aspx?id=7435).
80+
- Updates a registry key (HKLM), with persistent settings for Azure Migrate.
81+
- Creates log and configuration files as follows:
82+
- **Config Files**: %ProgramData%\Microsoft Azure\Config
83+
- **Log Files**: %ProgramData%\Microsoft Azure\Logs
84+
85+
To run the script:
86+
87+
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.
2695

27-
## Download the script
96+
### Verify access
2897

29-
1. Locate the machine/VM that will act as the Azure Migrate appliance.
30-
2. On the machine, do the following:
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.
3199

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).
34100

35-
## Verify file security
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
36113

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

39116
1. On the machine to which you downloaded the file, open an administrator command window.
40117
2. Run the following command to generate the hash for the zipped file
41118
- ```C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]```
42-
- Example usage: ```C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256```
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:
43123

44-
3. Verify that the generated hash values match these settings (for the latest appliance version):
124+
- For the public cloud (for the latest appliance version):
45125

46-
**Algorithm** | **Hash value**
47-
--- | ---
48-
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
49-
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
126+
**Algorithm** | **Hash value**
127+
--- | ---
128+
MD5 | 1e92ede3e87c03bd148e56a708cdd33f
129+
SHA256 | a3fa78edc8ff8aff9ab5ae66be1b64e66de7b9f475b6542beef114b20bfdac3c
50130

51-
## Run the script
131+
- For Azure government (for the latest appliance version):
132+
133+
**Algorithm** | **Hash value**
134+
--- | ---
135+
MD5 | 717f8b9185f565006b5aff0215ecadac
136+
137+
138+
### Run the script
52139

53140
Here's what the script does:
54141

@@ -62,28 +149,24 @@ Here's what the script does:
62149

63150
To run the script:
64151

65-
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.
66153
2. Launch PowerShell on the machine, with administrator (elevated) privileges.
67154
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.
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+
83166

84167
## Next steps
85168

86-
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:
87170

88171
- Set up the appliance for [VMware](how-to-set-up-appliance-vmware.md#configure-the-appliance).
89172
- Set up the appliance for [Hyper-V](how-to-set-up-appliance-hyper-v.md#configure-the-appliance).

0 commit comments

Comments
 (0)