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/how-to-discover-using-collector.md
+39-34Lines changed: 39 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Discovery using Azure Migrate Collector
3
-
description: User guide for Azure Migrate Collector to discover VMware servers and workloads, upload data to Azure Migrate, and generate business case and assessment reports.
3
+
description: Learn how to use Azure Migrate Collector to discover VMware servers and workloads, upload inventory and performance data to Azure Migrate, and generate business case and assessment reports..
4
4
author: molishv
5
5
ms.author: molir
6
6
ms.manager: ronai
@@ -9,12 +9,12 @@ ms.topic: how-to
9
9
ms.reviewer: v-uhabiba
10
10
ms.date: 02/11/2026
11
11
ms.custom: engagement-fy26
12
-
# Customer intent: As an IT professional, I want to use Azure Migrate Collector to discover my IT estate and generate reports, so I can plan migration and modernization efficiently.
12
+
# Customer intent: As an IT professional, I want to use Azure Migrate Collector to discover my IT estate and generate assessment and business case reports, so that I can plan migration and modernization effectively.
13
13
---
14
14
15
-
# Discover servers & workloads using Azure Migrate collector
15
+
# Discover servers and workloads using Azure Migrate collector
16
16
17
-
This article explains how to use Azure Migrate collector to quickly discover servers and workloads across your IT estate without needing direct Azure connectivity. You deploy the collector on a Windows Server to scan VMware environments and physical or virtual servers. The collected inventory data can be used to generate business case and performance-based assessment reports to support lift-and-shift migration and modernization of your IT estate.
17
+
This article explains how to use Azure Migrate collector to quickly discover servers and workloads across your IT estate without direct Azure connectivity. You deploy the collector on a Windows Server to scan VMware environments and physical or virtual servers. The collected inventory data can be used to generate business case and performance-based assessment reports to support lift-and-shift migration and modernization of your IT estate.
18
18
19
19
Azure Migrate collector can discover your VMware estate or individual Windows and Linux servers running on any hypervisor or public cloud. You can collect server configurations, performance metrics, installed software, SQL Server and PostgreSQL database instances, and web apps (.NET on IIS and Java on Tomcat). With no Azure connectivity required, you can scan the estate locally and upload data securely, saving time and avoiding complex networking or access approval requirements.
20
20
@@ -45,25 +45,25 @@ Before you set up the collector, [create a new Azure Migrate project](quickstart
45
45
46
46
Note: *You can set up custom least privileged Windows, Linux, and SQL accounts by referring [this article](best-practices-least-privileged-account.md).
47
47
48
-
### Download Azure Migrate Collector
48
+
### Download the Azure Migrate Collector
49
49
50
-
1. From Azure Migrate project, select Discover -> using Collector and select Download.
51
-
2. You can also download the Azure Migrate collector installer script directly using this link: https://aka.ms/Migrate/DownloadCollector
50
+
1. In the Azure Migrate project, select Discover -> using Collector and then select **Download**.
3. Extract the installer zip file to a folder on the server that hosts the Azure Migrate collector.
53
53
54
54
### Run the installer script
55
55
56
56
1. Launch PowerShell with administrative privileges on the host server.
57
-
2. Change directory to the extracted folder.
57
+
2. Change the directory to the extracted folder.
58
58
3. Run the installer script:
59
59
60
60
```pwsh
61
61
.\AzureMigratecollector.ps1
62
62
```
63
63
64
-
4.During the first installation of the script, select fresh option f.
65
-
5. When upgrading the collector to the new versions, select update option u.
66
-
6. The installer script:
64
+
4.For the first installation, select the **fresh (f)** option..
65
+
5. To upgrade the collector to a newer version, select the **update (u)** option.
66
+
6. The installer script performs the following actions::
67
67
- Installs agents and web applications.
68
68
- Enables Windows features: Windows Activation Service, Web-Server, Web-Mgmt-Service.
69
69
- Updates a registry key (HKLM) with persistent setting details for Azure Migrate.
@@ -75,19 +75,23 @@ Note: *You can set up custom least privileged Windows, Linux, and SQL accounts b
75
75
76
76
### Provide vCenter credentials
77
77
78
-
1. In Step 1: Select Add credentials to enter a name for the credentials. Add the username and password for the vCenter Server account that the collector will use to discover servers running on vCenter Server.
79
-
2. If you want to add multiple credentials at once, select Add more to save and add more credentials. Multiple credentials are supported for discovery of servers across multiple vCenter Servers using a single collector.
80
-
3. In Step 2: Provide vCenter Server details, select Add discovery source to add the IP address or FQDN of a vCenter Server. You can leave the port as the default (443) or specify a custom port on which vCenter Server listens. Select the friendly name for credentials you would like to map to the vCenter Server and select Save.
81
-
4. Select Add more to save the previous details and add more vCenter Server details. You can add up to 10 vCenter Servers per collector.
78
+
1. Select **Add credentials**, and then enter a name for the credentials.
79
+
Provide the username and password for the vCenter Server account that the collector uses to discover servers.
80
+
2. To add multiple credentials, select **Add more** to save the current credentials and add additional ones.
81
+
You can add multiple credentials to discover servers across multiple vCenter Servers using a single collector.
82
+
3. Provide **vCenter Server details**, select **Add discovery source**, and then enter the IP address or FQDN of the vCenter Server.
83
+
Use the default port (**443**) for discovery or specify a custom port. Select the credential name to map to the vCenter Server, and then select **Save**.
84
+
4. Select **Add more** to save the details and add additional vCenter Servers.
85
+
You can add up to 10 vCenter Servers per collector
82
86
83
87
### Provide guest and database credentials
84
88
85
89
1. Refer security best practices to set up least privileged accounts to set up least privileged accounts.
86
90
2. Provide Windows & Linux guest accounts to collect data about installed software, database instances and web apps. Provide SQL credentials (Windows or SQL server authentication) to collect SQL suitability data.
87
-
3. Verify the guest credentials by validating against a target server.
91
+
3. To verify if the guest credentials are valid, test them against few target servers.
88
92
4. Enable the checkbox to validate credential.
89
93
5. Select the vCenter and select up to 5 virtual machines from the drop down.
90
-
6. Click on validate.
94
+
6. Select **validate**.
91
95
7. If the credentials are not valid, fix the errors by following the recommendation step before triggering data collection.
92
96
8. If the credentials are successfully validated, guest discovery of installed software, inventory of database instance on the machines will be successful.
93
97
> [!NOTE]
@@ -100,19 +104,19 @@ The same Azure migrate collector can be used to discover both VMware machines an
100
104
### Provide credentials for Windows & Linux servers:
101
105
1. Provide credentials for discovery of Windows and Linux physical or virtual servers, select Add credentials.
102
106
2. For a Windows server:
103
-
Select the source type as Windows Server.
104
-
Enter a friendly name for the credentials.
105
-
Add the username and password.
106
-
Select Save.
107
+
-Select the source type as **Windows Server**.
108
+
-Enter a friendly name for the credentials.
109
+
-Add the username and password.
110
+
-Select **Save**.
107
111
3. If you use password-based authentication for a Linux server, select the source type as Linux Server (Password-based).
108
112
Enter a friendly name for the credentials.
109
-
Add the username and password, and then select Save.
113
+
Add the username and password, and then select **Save**.
110
114
4. If you use SSH key-based authentication for a Linux server:
111
115
Select the source type as Linux Server (SSH key-based).
112
116
Enter a friendly name for the credentials.
113
117
Add the username.
114
118
Browse and select the SSH private key file.
115
-
Select Save.
119
+
Select **Save**.
116
120
117
121
> [!NOTE]
118
122
> -Azure Migrate supports SSH private keys created using the ssh-keygen command with RSA, DSA, ECDSA, and ed25519 algorithms.
@@ -128,8 +132,9 @@ The same Azure migrate collector can be used to discover both VMware machines an
128
132
4. The collector communicates with Windows servers using WinRM port 5986 (HTTPS) and Linux servers using port 22 (TCP). If HTTPS prerequisites are not configured on Hyper‑V servers, it automatically switches to WinRM port 5985 (HTTP).
129
133
5. When you save, the collector validates connectivity to each server and shows the Validation status in the table. If validation fails, select Validation failed to review the error, fix the issue, and validate again. You can revalidate connectivity at any time before starting data collection or remove servers by selecting Delete.
130
134
6. Before starting data collection, you can optionally turn off the workload discovery slider for the added servers. This setting can be changed at any time.
131
-
7. To discover SQL Server instances and databases, add additional credentials (Windows domain, non‑domain, or SQL authentication). The appliance attempts to automatically map these credentials to SQL servers. Domain credentials are authenticated against Active Directory to prevent account lockouts and must be provided in Down‑Level format (domain\username), as UPN format is not supported.
132
-
8. Domain credential validation status is shown in the credentials table. If validation fails, select the failed status to view details, fix the issue, and select Revalidate credentials.
135
+
7. Add additional credentials (Windows domain, Windows non‑domain, or SQL authentication) to discover SQL Server instances and databases. The appliance automatically maps these credentials to SQL servers.
136
+
8. Provide domain credentials in Down‑Level format (domain\username). UPN format is not supported.Domain credentials are authenticated against Active Directory to prevent account lockouts.
137
+
9. Domain credential validation status is shown in the credentials table. If validation fails, select the failed status to view details, fix the issue, and select Revalidate credentials.
133
138
134
139
### Start data collection
135
140
@@ -162,12 +167,12 @@ The same Azure migrate collector can be used to discover both VMware machines an
162
167
163
168
## Upload the collected data to an Azure Migrate project
164
169
1. Refer this article to create a new Azure Migrate project. Inventory Import from collector is supported only for newly created projects.
165
-
2. Once the project is created, select start discovery using collector option.
170
+
2. After creating the project, select Start discovery using collector.
166
171
167
172
### Import the zip file generated using collector
168
173
169
-
1. Click Browse and select the ZIP file exported from your collector.
170
-
2. Once you have selected the right file, click on import.
174
+
1. Select Browse and select the ZIP file exported from your collector.
175
+
2. Once you have selected the right file, select import.
171
176
3. You will be able to see the import status as it proceeds.
172
177
173
178
> [!NOTE]
@@ -176,17 +181,17 @@ The same Azure migrate collector can be used to discover both VMware machines an
176
181
### Create business cases and assessments
177
182
178
183
1. After upload is successful, create business cases and assessments.
179
-
2.Wait 45 minutes after successful upload before creating a business case or assessment to ensure all discovery data is updated.
184
+
2.After a successful upload, wait 45 minutes before creating a business case or assessment to ensure all discovery data is updated.
180
185
181
186
### Import more inventory
182
187
183
188
1. If you wish to discover more inventory with the Azure migrate collector after your initial import, follow these steps to add the new data to your Azure Migrate project:
184
-
2. Navigate to “All inventory” view. You will be able to see your existing discovery data here.
185
-
3. Click on the “Discover” option at the top and select “Using collector”.
189
+
2. Navigate to **All inventory** view. You will be able to see your existing discovery data here.
190
+
3. Select **Discover** option at the top and select **Using collector**.
186
191
4. You will be able to navigate to the import page.
187
-
5. Select “Azure migrate collector (ZIP)” in the file type dropdown
188
-
6. Click Browse and select the ZIP file exported from your collector.
189
-
7. Once you have selected the right file, click on import to ingest the file.
192
+
5. Select **Azure migrate collector (ZIP)** in the file type dropdown
193
+
6. Select Browse and select the ZIP file exported from your collector.
194
+
7. Once you have selected the right file, select import to ingest the file.
190
195
191
196
> [!NOTE]
192
197
> Multiple zip files of different hypervisor type (VMware, physical) can be imported to the same project.
0 commit comments