Troubleshooting AWS Migration Hub - AWS Migration Hub

Troubleshooting AWS Migration Hub

This page provides troubleshooting guidance for AWS Migration Hub, as well as links to topics on how to troubleshoot issues with AWS Application Discovery Service, Agentless Collector, and Migration Evaluator.

My migrations do not appear in Migration Hub

If you are not seeing your applications' migration status updates on the Updates page in Migration Hub, it could be due to one of the following reasons:

  • You have not selected a home Region or you are not currently viewing the home Region console.

  • Migration tools are not authorized to communicate with Migration Hub.

  • You do not have the necessary policies and roles set up in IAM.

  • Migration status mapping is incorrect or needs to be done manually.

Authentication issues

To make sure authentication is occurring correctly:

Migration status matching when using AWS discovery tools

  • Check whether a migration update must be manually mapped or was incorrectly mapped to a discovered server, see Tracking migration updates.

Updates about my migrations don't appear inside an application

If you are not seeing your migration updates associated with an application, it could be due to one of the following reasons:

  • Servers not being grouped as an application.

  • Migration update status not being refreshed.

  • Migration updates are not mapped or are incorrectly mapped to a server.

Servers application grouping issues

Update status issues

Update and server mapping issues

  • Check whether the update is present on Updates page.

  • If not on the Updates page, then check whether the migration tool was authorized by looking on the Migration Tools page - in the navigation pane, under Migrate, choose Tools.

  • On the Updates page, verify that the update is mapped to the correct server (it will show "Edit" in "Mapped servers" column).

  • If mapped to a server on the Updates page, then verify whether the server is grouped into an application on the Servers page with an application name present in the "Applications" column.

My API call failed

  • Check whether you called GetHomeRegion before your call, if required.

  • You can use the AWS Migration Hub home Region APIs within your home Region only. API calls originating from outside your home Region are rejected, except for the ability to register your agents and collectors.

Errors enabling data collection

Although you can register discovery agents and collectors outside of your AWS Migration Hub home Region, you cannot start data collection outside the home Region. The Application Discovery Service StartDataCollection API call prevents you from enabling data collection outside the home Region.

Troubleshooting AWS Application Discovery Service issues

See Troubleshooting AWS Application Discovery Service.

Troubleshooting Agentless Collector issues

See Troubleshooting Agentless Collector.

Troubleshooting Migration Evaluator issues

See the Collector Installation Guide on the Migration Evaluator Resources page.