Install agent

AWS Application Migration Service replicates data to AWS using agent that must be installed on the source server.

  1. Retrieve AWS credentials for the agent

    For the Application Migration Service agent to replicate data, you need to have an AWS IAM User with proper privileges created in your target AWS account (see more information here). We’ve created a user for you, what you need to do is retrieve its Access Key ID and Secret Access Key to use it during agent installation.

    For self-paced lab - it’s described on the Output section of the ApplicationMigrationWorkshop CloudFormation Template.

    AWS Credentials

    For AWS Event - it’s described at Application Migration Service - IAM Access Key ID and IAM Secret Access Key on the Team Dashboard.

    AWS Credetentials EE

  2. Retrieve the source Webserver connection information

    For self-paced lab - it’s described on the Output section of the ApplicationMigrationWorkshop CloudFormation Template.

    Centos-pem

    For AWS Event - it’s described at Webserver IP, Webserver Username and Webserver SSH Key on the Team Dashboard.

    Centos-pem

  3. Download and save locally (for example as webserver.pem file) the Webserver SSH key (.pem)

    If you’re using Microsoft Windows OS, convert the SSH key .pem file to .ppk using PuttyGen and then use Putty to connect (more details can be found here).

  4. Connect to the Source Webserver using SSH terminal

    For Microsoft Windows users review this article.
    For Mac OS users review this article.

  5. Run the following commands

wget -O ./aws-replication-installer-init.py https://aws-application-migration-service-us-west-2.s3.amazonaws.com/latest/linux/aws-replication-installer-init.py
sudo python3 aws-replication-installer-init.py
  1. Provide AWS region and AWS credentials

    When prompted provide AWS Region (us-west-2), then AWS Access Key ID and AWS Secret Access Key retrieved in step 1.

    When copying-pasting AWS Secret Access Key, its content is not displayed for security reasons. Just press Enter after paste.

  2. Confirm volumes to be replicated

    Once you’ve entered AWS credentials, installer will identify volumes attached to the system and prompt you to choose which disks you want to replicate. Press Enter since we want to replicate all volumes.

    Application Migration Service - agent installation

  3. Replication start

    Once the agent is installed, you will see information about it in the Application Migration Service Source Servers list.

    Application Migration Service - Source Servers list

    The replication starts right away. While it’s taking place, let’s review and update server details.