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
Copy file name to clipboardExpand all lines: articles/migrate/migrate-appliance.md
+62-24Lines changed: 62 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,11 +36,53 @@ The appliance can be deployed using a couple of methods:
36
36
- If you don't want to use a template, you can deploy the appliance for VMware or Hyper-V environment using a [PowerShell installer script](deploy-appliance-script.md).
37
37
- In Azure Government, you should deploy the appliance using a PowerShell installer script. Refer to the steps of deployment [here](deploy-appliance-script-government.md).
38
38
- For physical or virtualized servers on-premises or any other cloud, you always deploy the appliance using a PowerShell installer script. Refer to the steps of deployment [here](how-to-set-up-appliance-physical.md).
39
-
- Download links are available in the tables below.
39
+
40
40
41
41
> [!Note]
42
-
> - Don't install any other components, such as the **Microsoft Monitoring Agent (MMA)** or **Replication appliance**, on the same server hosting the Azure Migrate appliance. If you install the MMA agent, you can face problems like **"Multiple custom attributes of the same type found"**. It's recommended to have a dedicated server to deploy the appliance.
43
-
> - Federal Information Processing Standards (FIPS) mode is not supported for appliance deployment.
42
+
> - Don't install any other components, such as **Replication appliance**, on the same server that hosts the Azure Migrate appliance.
43
+
> - Federal Information Processing Standards (FIPS) mode isn't supported for appliance deployment.
44
+
45
+
## Verify security
46
+
47
+
Before you use the OVA/VHD/Zip file to deploy appliance, verify that the file is secure:
48
+
49
+
1. On the server where you downloaded the file, open Command Prompt window by using **Run as administrator** option.
50
+
1. Run this command to create the hash for the OVA/VHD/Zip file:
- Use the Zip file to set up the VMware, Hyper-V, or Physical appliance stack in Azure public cloud and Azure Government.
81
+
82
+
| Algorithm | Download | SHA256 |
83
+
| --- | --- | --- |
84
+
| Zip file (693 MB) |[Latest version](https://go.microsoft.com/fwlink/?linkid=2191847)| B4632DAA872310BCE44CFC7FF1C8968CDC7BAA2EB924C18FF630B18D57852EDA |
85
+
44
86
45
87
## Appliance services
46
88
@@ -69,29 +111,29 @@ The following table summarizes the Azure Migrate appliance requirements for VMwa
69
111
**Appliance services** | The appliance has the following services:<br><br> - **Appliance configuration manager**: This is a web application that can be configured with source details to start the discovery and assessment of servers.<br> - **VMware discovery agent**: The agent collects server configuration metadata that can be used to create as on-premises assessments.<br>- **VMware assessment agent**: The agent collects server performance metadata that can be used to create performance-based assessments.<br>- **Auto update service**: The service keeps all the agents running on the appliance up to date. It automatically runs once every 24 hours.<br>- **DRA agent**: Orchestrates server replication, and coordinates communication between replicated servers and Azure. Used only when replicating servers to Azure using agentless migration.<br>- **Gateway**: Sends replicated data to Azure. Used only when replicating servers to Azure using agentless migration.<br>- **SQL discovery and assessment agent**: sends the configuration and performance metadata of SQL Server instances and databases to Azure.<br>- **Web apps discovery and assessment agent**: sends the web apps configuration data to Azure.
70
112
**Project limits** | An appliance can only be registered with a single project.<br> A single project can have multiple registered appliances.
71
113
**Discovery limits** | An appliance can discover up to 10,000 severs running across multiple vCenter Servers.<br>A single appliance can connect to up to 10 vCenter Servers.
72
-
**Supported deployment** | Deploy as new server running on vCenter Server using OVA template.<br><br> Deploy on an existing server running Windows Server 2019or Windows Server 2022 using PowerShell installer script.
114
+
**Supported deployment** | Deploy as new server running on vCenter Server using OVA template.<br><br> Deploy on an existing server that runs Windows Server 2019, Windows Server 2022, or Windows Server 2025 using PowerShell.
73
115
**OVA template** | Download from project or from [here](https://go.microsoft.com/fwlink/?linkid=2191954).<br><br> Download size is 11.9 GB.<br><br> The downloaded appliance template comes with a Windows Server 2022 evaluation license, which is valid for 180 days.<br>If the evaluation period is close to expiry, we recommend that you download and deploy a new appliance using OVA template, or you activate the operating system license of the appliance server.
74
116
**OVA verification** | The OVA template downloaded from project by checking the hash values.
75
117
**PowerShell script** | Refer to this [article](./deploy-appliance-script.md#set-up-the-appliance-for-vmware) on how to deploy an appliance using the PowerShell installer script.<br/><br/>
76
-
**Hardware and network requirements** | The appliance should run on server with Windows Server 2019 or Windows Server 2022, 32-GB RAM, 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.<br/> The appliance requires internet access, either directly or through a proxy.<br/><br/> If you deploy the appliance using OVA template, you need enough resources on the vCenter Server to create a server that meets the hardware requirements.<br/><br/> If you run the appliance on an existing server, make sure that it is running Windows Server 2019 or Windows Server 2022, and meets hardware requirements.
118
+
**Hardware and network requirements** | The appliance should run on server with Windows Server 2019 or Windows Server 2022, 32-GB RAM, 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.<br/><br/> The onboarding script checks for Windows Server 2016 or earlier versions and blocks the appliance deployment on those systems.<br/><br/> The appliance requires internet access, either directly or through a proxy.<br/><br/> If you deploy the appliance using OVA template, you need enough resources on the vCenter Server to create a server that meets the hardware requirements.
77
119
**VMware requirements** | If you deploy the appliance as a server on vCenter Server, it must be deployed on a vCenter Server running 5.5, 6.0, 6.5, 6.7 or 7.0 and an ESXi host running version 5.5 or later.<br/><br/>
78
120
**VDDK (agentless migration)** | To use the appliance for agentless migration of servers, the VMware vSphere VDDK must be installed on the appliance server.
79
121
80
122
## Appliance - Hyper-V
81
123
82
-
**Requirement** | **Hyper-V**
83
-
--- | ---
84
-
**Permissions** | To access the appliance configuration manager locally or remotely, you need to have a local or domain user account with administrative privileges on the appliance server.
85
-
**Appliance services** | The appliance has the following services:<br><br> - **Appliance configuration manager**: This is a web application that can be configured with source details to start the discovery and assessment of servers.<br> - **Discovery agent**: The agent collects server configuration metadata that can be used to create as on-premises assessments.<br>- **Assessment agent**: The agent collects server performance metadata that can be used to create performance-based assessments.<br>- **Auto update service**: The service keeps all the agents running on the appliance up to date. It automatically runs once every 24 hours.<br>- **SQL discovery and assessment agent**: sends the configuration and performance metadata of SQL Server instances and databases to Azure.
86
-
**Project limits** | An appliance can only be registered with a single project.<br> A single project can have multiple registered appliances.
87
-
**Discovery limits** | An appliance can discover up to 5000 servers running in Hyper-V environment.<br> An appliance can connect to up to 300 Hyper-V hosts.
88
-
**Supported deployment** | Deploy as server running on a Hyper-V host using a VHD template.<br><br> Deploy on an existing server running Windows Server 2019or Windows Server 2022 using PowerShell installer script.
89
-
**VHD template** | Zip file that includes a VHD. Download from project or from [here](https://go.microsoft.com/fwlink/?linkid=2140422).<br><br> Download size is 8.91 GB.<br><br> The downloaded appliance template comes with a Windows Server 2022 evaluation license, which is valid for 180 days. If the evaluation period is close to expiry, we recommend that you download and deploy a new appliance, or that you activate the operating system license of the appliance server.
90
-
**VHD verification** | The VHD template downloaded from project by checking the hash values.
91
-
**PowerShell script** | Refer to this [article](./deploy-appliance-script.md#set-up-the-appliance-for-hyper-v) on how to deploy an appliance using the PowerShell installer script.<br/>
92
-
**Hardware and network requirements** | The appliance should run on server with Windows Server 2019 or Windows Server 2022, 16-GB RAM, 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.<br/> The appliance needs a static or dynamic IP address, and requires internet access, either directly or through a proxy.<br/><br/> If you run the appliance as a server running on a Hyper-V host, you need enough resources on the host to create a server that meets the hardware requirements.<br/><br/> If you run the appliance on an existing server, make sure that it is running Windows Server 2019 or Windows Server 2022, and meets hardware requirements.
93
-
**Hyper-V requirements** | If you deploy the appliance with the VHD template, the appliance provided by Azure Migrate is Hyper-V VM version 5.0.<br/><br/> The Hyper-V host must be running Windows Server 2019or Windows Server 2022.
94
-
124
+
|**Requirement**|**Hyper-V**|
125
+
|--- | ---|
126
+
|**Permissions**| To access the appliance configuration manager locally or remotely, you need to have a local or domain user account with administrative privileges on the appliance server.|
127
+
|**Appliance services**| The appliance has the following services:<br><br> - **Appliance configuration manager**: This is a web application that can be configured with source details to start the discovery and assessment of servers.<br> - **Discovery agent**: The agent collects server configuration metadata that can be used to create as on-premises assessments.<br>- **Assessment agent**: The agent collects server performance metadata that can be used to create performance-based assessments.<br>- **Auto update service**: The service keeps all the agents running on the appliance up to date. It automatically runs once every 24 hours.<br>- **SQL discovery and assessment agent**: sends the configuration and performance metadata of SQL Server instances and databases to Azure.|
128
+
|**Project limits**| An appliance can only be registered with a single project.<br> A single project can have multiple registered appliances.|
129
+
|**Discovery limits**| An appliance can discover up to 5000 servers running in Hyper-V environment.<br/><br/> An appliance can connect to up to 300 Hyper-V hosts.|
130
+
|**Supported deployment**| Deploy as server running on a Hyper-V host using a VHD template.<br/><br/> Deploy on an existing server that runs Windows Server 2019, Windows Server 2022, or Windows Server 2025 using PowerShell.|
131
+
|**VHD template**| Zip file that includes a VHD. Download from project or from [here](https://go.microsoft.com/fwlink/?linkid=2140422).<br><br> Download size is 8.91 GB.<br><br> The downloaded appliance template comes with a Windows Server 2022 evaluation license, which is valid for 180 days. If the evaluation period is close to expiry, we recommend that you download and deploy a new appliance, or that you activate the operating system license of the appliance server.|
132
+
|**VHD verification**|Verify the VHD template downloaded from project by checking the hash values.|
133
+
|**PowerShell script**| Refer to this [article](./deploy-appliance-script.md#set-up-the-appliance-for-hyper-v) on how to deploy an appliance using the PowerShell installer script.|
134
+
|**Hardware and network requirements** | The appliance should run on server with Windows Server 2019 or Windows Server 2022, 16-GB RAM, 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.<br/> The appliance needs a static or dynamic IP address, and requires internet access, either directly or through a proxy.
135
+
<br/><br/> If you run the appliance as a server running on a Hyper-V host, you need enough resources on the host to create a server that meets the hardware requirements.<br/><br/> The appliance runs on a server with Windows Server 2019, Windows Server 2022, or Windows Server 2025. It needs 32 GB RAM, 8 vCPUs, around 80 GB of disk storage, and an external virtual switch.|
136
+
|**Hyper-V requirements**| If you deploy the appliance with the VHD template, the appliance provided by Azure Migrate is Hyper-V VM version 5.0.<br/><br/> The Hyper-V host must be running Windows Server 2019 or Windows Server 2022.|
95
137
96
138
## Appliance - Physical
97
139
@@ -101,11 +143,10 @@ The following table summarizes the Azure Migrate appliance requirements for VMwa
101
143
**Appliance services** | The appliance has the following services:<br><br> - **Appliance configuration manager**: This is a web application that can be configured with source details to start the discovery and assessment of servers.<br> - **Discovery agent**: The agent collects server configuration metadata that can be used to create as on-premises assessments.<br>- **Assessment agent**: The agent collects server performance metadata that can be used to create performance-based assessments.<br>- **Auto update service**: The service keeps all the agents running on the appliance up to date. It automatically runs once every 24 hours.<br>- **SQL discovery and assessment agent**: sends the configuration and performance metadata of SQL Server instances and databases to Azure.
102
144
**Project limits** | An appliance can only be registered with a single project.<br> A single project can have multiple registered appliances.<br>
103
145
**Discovery limits** | An appliance can discover up to 1000 physical servers.
104
-
**Supported deployment** | Deploy on an existing server running Windows Server 2022 using PowerShell installer script.
146
+
**Supported deployment** | Deploy on an existing server that runs Windows Server 2019, Windows Server 2022, or Windows Server 2025 using PowerShell.
105
147
**PowerShell script** | Download the script (AzureMigrateInstaller.ps1) in a zip file from the project or from [here](https://go.microsoft.com/fwlink/?linkid=2140334). [Learn more](tutorial-discover-physical.md).<br><br> Download size is 85.8 MB.
106
148
**Script verification** | Verify the PowerShell installer script downloaded from project by checking the hash values.
107
-
**Hardware and network requirements** | The appliance should run on server with Windows Server 2019 or Windows Server 2022, 16-GB RAM, 8 vCPUs, around 80 GB of disk storage.<br/> The appliance needs a static or dynamic IP address, and requires internet access, either directly or through a proxy.<br/><br/> If you run the appliance on an existing server, make sure that it is running Windows Server 2019 or Windows Server 2022, and meets hardware requirements.
108
-
149
+
**Hardware and network requirements** | The appliance runs on a server with Windows Server 2019, Windows Server 2022, or Windows Server 2025. It needs 32 GB RAM, 8 vCPUs, about 80 GB of disk storage, and an external virtual switch.<br/><br/> The appliance uses a static or dynamic IP address and needs internet access, either directly or through a proxy.
109
150
110
151
## URL access
111
152
@@ -178,7 +219,6 @@ download.microsoft.com/download | Allow downloads from Microsoft download center
178
219
*.blob.core.usgovcloudapi.net (optional)| This is optional and is not required if the storage account has a private endpoint attached.
179
220
*.applicationinsights.us (optional)| Upload appliance logs used for internal monitoring.
180
221
181
-
182
222
### Microsoft Azure operated by 21Vianet (Microsoft Azure operated by 21Vianet) URLs
183
223
184
224
**URL** | **Details**
@@ -199,7 +239,6 @@ download.microsoft.com/download | Allow downloads from Microsoft download center
199
239
200
240
### Microsoft Azure operated by 21Vianet URLs
201
241
202
-
203
242
**URL** | **Details**
204
243
--- | --- |
205
244
*.portal.azure.cn | Navigate to the Azure portal.
@@ -216,7 +255,6 @@ download.microsoft.com/download | Allow downloads from Microsoft download center
216
255
*.blob.core.chinacloudapi.cn | **Used for VMware agentless migration.**<br/><br/>Upload data to storage for migration.
217
256
*.applicationinsights.azure.cn | Upload appliance logs used for internal monitoring.
218
257
219
-
220
258
## Discovery and collection process
221
259
222
260
:::image type="content" source="./media/migrate-appliance/architecture.png" alt-text="Diagram of Appliance architecture.":::
0 commit comments