How do I troubleshoot Application Migration Service and Elastic Disaster Recovery agent installation failures on Linux source servers?

Short description

To detect common errors that you receive when you install AWS MGN and AWS DRS replication agent in Linux source servers, use the AWSSupport-TroubleshootLinuxMGNDRSAgentLogs automation runbook.

The runbook uses the AWS Replication install log files to provide a list of the errors detected and how to fix them.

Resolution

Before you start the AWSSupport-TroubleshootLinuxMGNDRSAgentLogs runbook, make sure that your AWS Identity and Access Management (IAM) user or role has the required permissions. For more information, see the Required IAM permissions section of AWSSupport-TroubleshootLinuxMGNDRSAgentLogs.

1. Open the AWS Systems Manager console, and then navigate to the AWSSupport-TroubleshootLinuxMGNDRSAgentLogs page.
2. Choose Execute automation.
3. Enter the following values for the input parameters:
   BucketName: The name of the Amazon Simple Storage Service (Amazon S3) bucket where the replication agent log is stored.
   ServiceName: The name of the replication service where the log is uploaded. To use AWS Application Migration Service, specify AWS MGN. To use AWS Elastic Disaster Recovery, specify AWS DRS.
   S3ObjectKey: The key of the Amazon S3 object where the replication agent installer log file is stored. For example, if the Amazon S3 URL is s3://bucket_name/path/to/file/aws_replication_agent_installer.log, then enter path/to/file/aws_replication_agent_installer.log
   AutomationAssumeRole: (Optional) The ARNs of the IAM role that allows Automation, a capability of AWS Systems Manager to perform the actions on your behalf. If no role is specified, Automation uses the permissions of the user who starts this runbook.
4. Choose Execute.
5. After the automation completes, review the detailed results in the Outputs section. If the automation document detects one of the common errors, then the output provides the steps to resolve the issue.

Related information

AWS Support Automation Workflows (SAW)

Run an automated operation powered by Systems Manager Automation

Setting up Automation