Phase 1: Migrate - AWS Migration Hub

Phase 1: Migrate

The migrate phase has the following steps:

  • Connect migration tools to Migration Hub.

  • Migrate using the connected migration tools.

  • Group servers as applications.

Migrate Step 1: Connect migration tools to Migration Hub

If you landed here from Step 4 of Get started migrating, the following steps show you how to authorize a migration tool and begin migrating.

Migration happens outside AWS Migration Hub using AWS migration tools or partner migration tools. To access these tools, in the Migration Hub console navigation pane under Migrate, choose Tools.

The table following lists the supported tools.

Resource type Migration tool


AWS Application Migration Service (AWS MGN)–AWS Application Migration Service is the primary migration service recommended for lift-and-shift migrations to AWS. For more information about AWS MGN, see AWS Application Migration Service and Using the AWS Migration Hub with MGN.

AWS Server Migration Service (AWS SMS)–For more information about AWS SMS, see AWS Server Migration Service and AWS SMS Documentation.

The ATADATA ATAmotion partner tool–For more information about ATAmotion, see AWS Migration Hub Partners.


AWS Database Migration Service (AWS DMS)–For more information about AWS DMS, see AWS Database Migration Service and AWS DMS Documentation.

The preceding tools communicate directly to Migration Hub giving an aggregated view of their migrated progress and status so they can be tracked through Migration Hub.

The following steps walk you through connecting (authorizing) your selected migration tool.

To connect (authorize) a migration tool

  1. In the Migration Hub console navigation pane under Migrate, choose Tools.

  2. Decide upon which AWS migration tool or integrated partners' tool to migrate your application.

  3. Choose Connect in the box to authorize the migration tool you selected to communicate with Migration Hub.

    1. AWS migration tools utilize a one-click authorization process that automatically adds the required AWS Identity and Access Management (IAM) permissions role once you choose Connect.

    2. Integrated partners' tools take you to their website when you choose Connect where you will be instructed on how to complete authorization.


Note that if you are using API's or do not want to authorize through Migration Hub's console, you can learn about manual role creation in New User IAM Setup.

Migrate Step 2: Migrate using the connected migration tools

The following steps walk you through the migration of a previously defined application.

To migrate an application

  1. In the Migration Hub console navigation pane under Migrate, choose Tools.

  2. If you connected (authorized) an AWS migration tool, choose the console link. If you connected (authorized) an integrated partner's tool, choose the website link.

  3. When you have been linked to either the tool's console or website, follow the migration instructions for your selected migration tool as migration happens outside of Migration Hub.

  4. After your application's migration has started, return to Migration Hub.

Migrate Step 3: Group servers as applications

These steps walk you through the process of grouping servers as applications when directly migrating with a migration tool without performing discovery first.

When the migration tool has started, you will see the servers listed in Migration Hub from the migration updates sent from the migration tool. You can select the servers and group them as applications. Keep in mind that the server information communicated to Migration Hub from the migration tool is not as detailed as what is collected from a discovery tool.

The following steps will show you how to select the server or servers you want to group for your application, how to create your application and name it, and how to add identifying tags.

To group servers into a new or existing application

  1. In the Migration Hub console navigation pane, select Servers.

  2. In the severs list, select the checkbox for each of the servers you want to group into a new or existing application.

    1. You can also search and filter on any of the criteria specified in the headers of the server list. Click inside the search bar and choose an item from the dropdown, then choose an operator from the next dropdown, and then type in your criteria.

    2. Optionally, for each selected server, you can add a descriptive tag by choosing Add tag. A dialog box appears where you can type a value for Key, and optionally, a value for Value.

  3. Create your application, or add to an existing one, by choosing Group as application.

  4. In the Group as application dialog box, select either Group as a new application or Add to an existing application.

    1. If you chose Group as a new application, type a name for Application name. Optionally, you can type a description for Application description.

    2. If you chose Add to an existing application, select the radio button next to the application name in the list box.

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

Next steps

Once you have completed the three steps of the Migrate phase, proceed to