EC2 Scan
Use this scan to discover your EC2 servers and look inside the operating system for installed software, dependencies and performance metrics. Set up AWS access first, then run the scan wizard.
Before you start¶
Complete the setup in AWS Requirements before running this scan.
You will need:
- A collector host inside your AWS environment
- A collector identity and a scan role in each target account
- One guest access method (SSM, SSH or WinRM), plus admin credentials for SSH or WinRM
- The list of AWS accounts and regions you want scanned
Running the scan¶
Launch DMC on the collector host. Click through the welcome screen, select AWS as the scan target, then select EC2 Scan. The wizard then walks through five screens.
AWS Configuration¶
Add an AWS identity so DMC can reach your accounts. Enter a label and the ARN of the collector role, click Add to validate and list the accounts it can reach, then select the regions to include and save the identity.
If only your own account appears here, organizations:ListAccounts may be blocked at the AWS Organizations level rather than by IAM. See AWS Requirements for how to enable multi-account discovery.
Guest Credentials¶
Under Guest Execution Methods, choose the connection methods DMC may use for each platform. SSM needs no credentials here; it runs through the AWS Systems Manager Agent already on the instance, as SYSTEM on Windows or root on Linux. WinRM / PSRP (Windows) and SSH (Linux) connect to the instance directly and need the credentials from Server admin credentials, added with Add Windows and Add Linux on this screen. A platform with no enabled method, or a direct-only method with no matching credentials, is excluded from the scan.
Settings¶
Review the scan settings before running:
- Output Path: the directory where DMC saves scan results and logs.
- Max Concurrent Servers: how many instances DMC scans in parallel: 5, 10, 15, or 20 (default 10).
- Metric Collection: the CloudWatch window DMC pulls performance data from. Set Duration in days (default 7) and Granularity: 5, 15, or 30 minutes, 1 hour, 6 hours, or 1 day (default 15 minutes).
- Scan Thresholds: the CPU and memory usage level (0-95%, default 85% CPU / 75% memory) above which a server is considered too busy and its guest scan is skipped.
Scan¶
The Scan screen lists the EC2 instances DMC discovered and how many are in scope. Click Run Scan. DMC shows real-time progress in the console output as it works through each instance.
Results¶
When the scan completes, DMC produces a password-protected ZIP of the collected data. Hand that file to your Dr Migrate contact, or import it into Dr Migrate yourself.
Confirm it worked¶
Before you finish, check these. They catch the most common issues:
- The collector host can reach AWS APIs on port 443
- The collector identity can assume the scan role with no "access denied"
- Your target instances appear (and show as Managed if using SSM)
- A test server returns software and network data, not just the EC2 record
- The export ZIP is created and you have its password
Common issues¶
| Symptom | Fix |
|---|---|
| "AssumeRole denied" | Check the scan role trust policy names the correct collector identity ARN. |
| No regions found | Confirm ec2:DescribeRegions is allowed, or select regions manually. |
| SSM scan fails | Confirm the instance is a Managed node and the SSM output bucket permission is attached. |
| Linux/Windows scan returns little data | Use root/sudo (Linux) or a local administrator account (Windows). See Server admin credentials. |

