Menu
AWS Migration Hub
User Guide

Doing More in Migration Hub

This section contains additional information to help enrich your migration experience by providing details on how to fully utilize the Migration Hub console discussed in the following topics:

Tracking Migration Updates

In order to better understand how Migration Hub helps you monitor progress of a migration, there are three concepts to understand in the Migration Hub:

  • Applications

  • Resources (for example, servers)

  • Updates

Migration tools like AWS SMS, AWS DMS, and integrated partners' tools send updates to AWS Migration Hub. These updates include information about how a particular resource migration (for example, server or database) is progressing. One or more resources are grouped together to make an application. Each application has a dedicated page in Migration Hub where you can go to see the updates for all the resources in the application.

When Migration Hub receives an update, it is displayed on the updates page. There can be a delay of up to five minutes for the initial update to appear in the updates page.

Tracking When You Perform Discovery First and Then Migrate

If you started performing discovery using AWS discovery tools, the servers list will likely be populated before you start migrating. Migration Hub attempts to automatically map updates from migration tools to servers in the servers list. If it cannot find a match in the discovered servers list, then Migration Hub will add a server corresponding to the migration update to the servers list and automatically map the update to the server.

Sometimes, when using AWS discovery tools, the automatic mapping of migration updates to servers can be incorrect. You can see updates and their mappings on the Updates page and can correct the mapping by choosing Edit.

See Step 2.a in To determine if a migration update must be manually mapped to a discovered server procedures below. If you have to frequently correct mappings after performing discovery, please contact AWS Support.

To determine if a migration update must be manually mapped to a discovered server

  1. In the navigation pane, under Migrate, select Updates.

  2. Verify if the Mapped servers column is populated for every row of migration updates.

    1. If the Mapped servers column is populated for every row of migration updates, this means auto-mapping was supported by the migration tool and manual mapping is not required. You can edit the server mapping by choosing Edit next to the server name.

    2. If one or more rows of the Mapped servers columns is not populated and there is a Map button present in that row's Action column, this is an indication that manual mapping is required. Proceed to the next set of procedures.

Tracking When You Migrate Without Performing Discovery

If you did not perform discovery with an AWS discovery tool, then Migration Hub will add a server corresponding to the migration update to the servers list and automatically map the update to the server. You can group servers to applications (see, migrate-wt-group-as-applications and then start tracking the migration on the application’s details page in the Migrate section of the console. See, Group Servers as Applications and Track Status of Migrations.

Troubleshooting and Manually Mapping Migration Updates

You can verify that the migration update is mapped to a server by viewing the update on the Updates page. If a server has not been mapped to a migration and you just started the migration task, see if it appears as mapped after waiting five minutes and refreshing the page.

If after an initial wait of five minutes the update is still not mapped to a server, then you can manually map the update to a server by selecting the Map button. For more information, see the following procedure, To manually map a migration update to a discovered server. For officially supported migration tools, you should not need to manually map migration updates. If this happens frequently, please contact AWS Support.

The following steps show you how to manually map a migration update to a discovered server that was not able to be automapped.

To manually map a migration update to a discovered server

  1. In the navigation pane, under Migrate, select Updates.

  2. For each migration update row that has a Map button present in the Action column, select the Map button.

  3. In the Map to discovered server box, select the radio button of the server you want to map to the migration update.

  4. Choose Save. A green confirmation message appears at the top of the screen.

  5. Verify that the server name of the server you just mapped is now present in the Mapped servers column.

Tracking Metrics Using the Dashboards

Dashboards provide a way to quickly see status and progress summary data, and also help you navigate to more detailed data.

Main Dashboard

The main dashboard gathers data from the Discover and Migrate dashboards in a central location.

The main dashboard consists of four at-a-glance status and information panes as well as a consolidated list of links for quick access. These panes allow you to understand the summary status of most recently updated applications and also get quick access to any of them, to get an overview of applications in different states, and to track the migration progress over time.

To reach the main dashboard, choose Dashboard from the navigation pane.

After viewing dashboard data summaries, you might want to retrieve more detail without interrupting your workflow. You do this by navigating directly from the relevant status or information pane on the dashboard.

In the table following, you can find instructions on how to navigate from a dashboard to the information you want to see. You can also find instructions on how to get to this information by using the navigation pane.

To See Do This Which Is the Same As
All servers

From the total number of servers inside the Discovery summary box in the Main dashboard, choose View all servers.

  1. In the navigation pane, choose Servers.

All agents

From the total number of agents in the Discovery summary box in the Main Dashboard, choose View all agents.

  1. In the navigation pane, choose Data Collectors.

  2. Choose the Agents tab.

All connectors

From the total number of connectors in the Discovery summary box in the Main dashboard, choose View all connectors.

  1. In the navigation pane, choose Data Collectors.

  2. Choose the Connectors tab.

All applications

From either the Main dashboard or Migrate dashboard, in the Most recently updated applications pane, choose View all applications

Or, from the Discover dashboard in the Servers & Applications pane, choose View all applications.

  1. In the navigation pane, under Migrate, choose Applications.

  2. Choose Applications.

Application details...
  • migration status

  • server list

From either the Main dashboard or Migrate dashboard in the Most recently updated applications box, choose the application's status box.

  1. In the navigation pane, choose Migrate.

  2. Choose Applications.

  3. In the Application Name column, choose the application name.

Server details...
  • basic information

  • performance information

From either the Main dashboard or Migrate dashboard, in the Most recently updated applications pane, choose the application. Then choose the server name in the Server ID column.

  1. In the navigation pane, choose Servers.

  2. In the Server ID column, choose the server name.