Windows - Application Migration Service

Windows

  1. Download the Agent installer (AWSReplicationWindowsInstaller.exe). Copy or distribute the downloaded Agent installer to each Windows source server that you want to add to Application Migration Service.

    The Agent installer follows the following format: https://aws-application-migration-service-<region>.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe . Replace <region> with the AWS Region into which you are replicating.

    The following is an example of the installer link for us-east-1:

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

    Important

    You need to run the Agent Installer file as an Administrator on each Windows server.

    Important

    If you need to validate the installer hash, the correct hash can be found here: https://aws-application-migration-service-hashes-<region>.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe.sha512 (replace <region> with the AWS Region into which you are replicating. Ex. us-east-1:

    https://aws-application-migration-service-hashes-us-east-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe.sha512

    Important

    We recommend using Windows PowerShell, which support ctrl+v pasting, and not Windows Command Prompt (cmd), which does not.

    Note

    Customers that are replicating in to the Asia Pacific (Hong Kong) AWS Region must use the following installer link format: https://aws-application-migration-service-ap-east-1.s3.ap-east-1.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe

    The following table contains the installer download link by supported AWS Region:

    Region name Region identity Download Link
    US East (N. Virginia) us-east-1 https://aws-application-migration-service-us-east-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    US East (Ohio) us-east-2 https://aws-application-migration-service-us-east-2.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    US West (N. California) us-west-1 https://aws-application-migration-service-us-west-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    US West (Oregon) us-west-2 https://aws-application-migration-service-us-west-2.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Hong Kong) ap-east-1 https://aws-application-migration-service-ap-east-1.s3.ap-east-1.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Tokyo) ap-northeast-1 https://aws-application-migration-service-ap-northeast-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Seoul) ap-northeast-2 https://aws-application-migration-service-ap-northeast-2.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Osaka) ap-northeast-3 https://aws-application-migration-service-ap-northeast-3.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Singapore) ap-southeast-1 https://aws-application-migration-service-ap-southeast-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Sydney) ap-southeast-2 https://aws-application-migration-service-ap-southeast-2.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Asia Pacific (Mumbai) ap-south-1 https://aws-application-migration-service-ap-south-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Europe (Frankfurt) eu-central-1 https://aws-application-migration-service-eu-central-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Europe (Stockholm) eu-north-1 https://aws-application-migration-service-eu-north-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Europe (Ireland) eu-west-1 https://aws-application-migration-service-eu-west-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Europe (London) eu-west-2 https://aws-application-migration-service-eu-west-2.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    Canada (Central) ca-central-1 https://aws-application-migration-service-ca-central-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
    South America (São Paulo) sa-east-1 https://aws-application-migration-service-sa-east-1.s3.amazonaws.com/latest/windows/AwsReplicationWindowsInstaller.exe
  2. Run the agent installer file - AWSReplicationWindowsInstaller.exe - as an Administrator. The CMD will open.

    To run the installer with the default settings, enter your AWS Region Name, the AWS Access Key ID and the AWS Secret Access Key as described in the next step.

    If you require additional customization, you can add a variety of parameters to the installation script in order to manipulate the way the Agent is installed on your server. Add the parameters to the end of the installation script.

    Available parameters include:

    • --region

      This parameter specifies the AWS Region into which you are replicating. Enter the complete AWS Region name (for example: eu-central-1). You will be automatically prompted for this parameter after running the installer command in a standard installation.

    • --aws-access-key-id

      This parameter specifies the AWS Access Key ID. Enter the full AWS Access Key ID that was previously generated. You will be automatically prompted for this parameter after running the installer command in a standard installation.

    • --aws-secret-access-key

      This parameter specifies the AWS Secret Access Key. Enter the full AWS Secret Access Key that was previously generated. You will be automatically prompted for this parameter after running the installer command in a standard installation.

    • --no-prompt

      This parameter will run a silent installation.

    • --devices

      This parameter specifies which specific disks to replicate.

    • --force-volumes

      This parameter must be used with the --no-prompt parameter. This parameter will cancel the automatic detection of physical disks to replicate. You will need to specify the exact disks to replicate using the --devices parameter (including the root disk, failure to specify the root disk will cause replication to fail). This parameter should only be used as a troubleshooting tool if the --devices parameter fails to identify the disks correctly.

    • --tags

      Use this parameter to add resource tags to the Source server. Use a space to separate each tag (for example: --tags KEY=VALUE [KEY=VALUE ...])

    • --s3-endpoint

      Use this parameter to specify a VPC endpoint you created for S3 if you do not wish to open your firewall ports to access the default S3 endpoint. Learn more about installing the Agent on a blocked network.

    • --endpoint

      Use this parameter to specify the Private Link endpoint you created for Application Migration Service if you do not wish to open your firewall ports to access the default MGN endpoint. Learn more about installing the Agent on a blocked network.

    The installer will confirm that the installation of the AWS Replication Agent has started.

  3. The installer will prompt you to enter your AWS Region Name, the AWS Access Key ID and the AWS Secret Access Key that you previously generated. Enter the complete AWS Region name (for example: eu-central-1), and the full AWS Access Key ID and AWS Secret Access Key.

    Note

    You can also enter these values as part of the installation script command parameters. If you do not enter these parameters as part of the installation script, you will be prompted to enter them one by one as described above. (for example: AwsReplicationWindowsInstaller.exe --region regionname --aws-access-key-id AKIAIOSFODNN7EXAMPLE --aws-secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY)

  4. Once you have entered your credentials, the installer will verify that the source server has enough free disk space for Agent installation and identify volumes for replication. The installer will display the identified disks and prompt you to choose the disks you want to replicate.

    To replicate some of the disks, type the path of the disks, separated by a comma, as illustrated in the installer (for example: C:, D:, etc). To replicate all of the disks, press Enter. The installer will identify the selected disks and print their size.

    The installer will confirm that all of the disks were successfully identified.

    Note

    When identifying specific disks for replication, do not use apostrophes, brackets, or disk paths that do not exist. Type only existing disk paths. Each disk that you selected for replication is displayed with the caption Disk to replicate identified. However, the displayed list of identified disks for replication may differ from the data you entered. This difference can due to several reasons:

    • The root disk of the source server is always replicated, whether you select it or not. Therefore, it always appears on the list of identified disks for replication.

    • Application Migration Service replicates whole disks. Therefore, if you choose to replicate a partition, its entire disk will appear on the list and will later be replicated. If several partitions on the same disk are selected, then the disk encompassing all of them will only appear once on the list.

    • Incorrect disks may be chosen by accident. Ensure that the correct disks have been chosen.

    Important

    If disks are disconnected from a server, Application Migration Service can no longer replicate them, so they are removed from the list of replicated disks. When they are re-connected, the AWS Replication Agent cannot know that these were the same disks that were disconnected and therefore does not add them automatically. To add the disks after they are reconnected, rerun the AWS Replication Agent installer on the server.

    Note that the returned disks will need be replicated from the beginning. Any disk size changes will be automatically identified, but will also cause a resync. Perform a test after installing the Agent to ensure that the correct disks have been added.

  5. After all of the disks that will be replicated have been successfully identified, the installer will download and install the AWS Replication Agent on the source server.

  6. Once the AWS Replication Agent is installed, the server will be added to the Application Migration Service Console and will undergo the initial sync process. The installer will provide you with the source server's ID.

    You can review this process in real time on the Source Servers page. Learn more about the initial sync process.