Install AWS Replication Agent

Everpure Cloud Dedicated for AWS

Audience
Public
Technology Integrations
Amazon Web Services (AWS)
Source Type
Documentation

In order to add source servers to the Application Migration Service console, you need first to install the replication agent on each individual VM. Once the agent is installed the VM will be added to Source Server page.

Windows

Download the Agent installer by copying the following link on a browser. Make sure to select a supported region and modify the link accordingly ( the region is indicated by green ).

https://aws-application-migration-service-us-west-2.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe

2. Navigate to the downloaded file AWSReplicationWindowsInstaller.exe, right-click and Run as an Administrator. The command prompt (CMD) will open.

3. Enter AWS Region Name, the AWS Access Key ID, and the AWS Secret Access Key. Then the script will prompt which disk to be replicated, enter the boot disk C: . The installer then starts installing the Agent.

Note:

If installation fails due to Failed to validate AWS credentials. Alternatively, you can run the installer by passing the parameters to the installation script command. check the below examples can be run in CMD or Windows PowerShell.

AwsReplicationWindowsInstaller.exe --region us-west-2 --aws-access-key-id AKIAIOFODNXXXXXXX --aws-secret-access-key wJalrXUtnFEMDENXXXXXXXXXXXX

4. Once finished, the installer will provide the source server ID (indicated by green in the example below).


The installation of the AWS Replication Agent has started.
AWS Region Name: us-west-2
AWS Access Key ID: AKIAIOFODNXXXXXXX
AWS Secret Access Key:
Verifying that the source server has enough free disk space to install the AWS Replication Agent.
(a minimum of 2 GB of free disk space is required)
Identifying volumes for replication.
Choose the disks you want to replicate. Your disks are: c:,d:
To replicate some of the disks, type the path of the disks, separated with a comma (for example, C:,D:). To replicate all disks, press Enter:c:
Disk to replicate identified: c:0 of size 90 GiB
All volumes for replication were successfully identified.
Downloading the AWS Replication Agent onto the source server... Finished.
Installing the AWS Replication Agent onto the source server... Finished.
Syncing the source server with the Application Migration Service Console... Finished.
The following is the source server ID: s-5d7113fc9be07a28f.
The AWS Replication Agent was successfully installed.
Press Enter to close...

5. Navigate back to AWS MGN console, then select Source Servers. You can use the search bar to filter source machines by the provided source server ID from the previous step.

6. Wait till the first initial sync is done then move to the next step Test and cut over the migration.

Linux

1. Download the Agent installer by copying the following link on a browser. Make sure to select a supported region and modify the link accordingly ( the region is indicated by green ).


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

2. Verify Python3 is installed python3 --version. If python is not installed use your Linux distribution download manager to install it.

Note:

Ubuntu example:


sudo apt-get install python3

3. Run the script and pass the parameters as follow:


sudo python3 aws-replication-installer-init.py --region us-west-2 --aws-access-key-id AKIAIOFODNXXXXXXX --aws-secret-access-key wJalrXUtnFEMDENXXXXXXXXXXXX

4. The script will scan the disks mounted on the system and prompt you to select the disks to be replicated. In this case, enter the boot disk /dev/sda .

5. Once finished, the installer script will provide the source server ID. This ID is used to locate the source server on the AWS MGN console.


The installation of the AWS Replication Agent has started.
Identifying volumes for replication.
Choose the disks you want to replicate. Your disks are: /dev/sda, /dev/sdb
To replicate some of the disks, type the path of the disks, separated with a comma (for example, /dev/sda,/dev/sdb). To replicate all disks, press Enter:/dev/sda
Identified volume for replication: /dev/sda of size 16 GiB
All volumes for replication were successfully identified.
Downloading the AWS Replication Agent onto the source server... Finished.
Installing the AWS Replication Agent onto the source server... Finished.
Syncing the source server with the Application Migration Service Console... Finished.
The following is the source server ID: s-583ad44ca8f665999.
The AWS Replication Agent was successfully installed.
Press Enter to close...
Note:

Note that in some cases during or after the initial sync is complete. The server may show a yellow lagging alert, which indicates the server is not in sync with the source and the data is not up to date. Typically this will be resolved by the MGN automatically. However, if this persists or a red stalled alert occurred instead, this will require user intervention as it might be a communication or agent issue. See Troubelshoot AWS MGN.