Troubleshooting Amazon DataSync agent issues - Amazon DataSync
How do I connect to an Amazon EC2 agent's local console?What does the Failed to retrieve agent activation key error mean?I can't activate an agent using a VPC endpointI don't know what's going on with my agent. Can someone help me?
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Troubleshooting Amazon DataSync agent issues

The following topics describe issues common to Amazon DataSync agents and how you can resolve them.

How do I connect to an Amazon EC2 agent's local console?

Make sure the Amazon EC2 instance's security group allows access with SSH (TCP port 22), then log in with the following command:

ssh -i PRIVATE-KEY admin@AGENT-PUBLIC-DNS-NAME

  • The user name is admin.

  • The PRIVATE-KEY value is the .pem file containing the private certificate of the Amazon EC2 key pair that you used to launch the instance. For more information, see retrieve the public key from the private key in the Amazon EC2 User Guide for Linux Instances.

  • The AGENT-PUBLIC-DNS-NAME value is the public DNS name of your agent. You can find this public DNS name by choosing the instance in the Amazon EC2 console and going to the Description tab.

For more information on connecting to the Amazon EC2 instance, see Connect to your instance in the Amazon EC2 User Guide for Linux Instances.

What does the Failed to retrieve agent activation key error mean?

When activating your DataSync agent, the agent connects to the endpoint you specify to request an activation key. You can get this error in non-VPC endpoint situations. For example, when your agent is deployed on-premises and your firewall settings block the connection. You can also get this error if your agent is deployed as an Amazon EC2 instance and the security groups are locked down.

Action to take

Verify that your security group is set up to allow your agent to connect to the VPC endpoint and that you have allowed the required ports. For information about required ports, see Amazon DataSync network requirements.

Also, check your firewall and router settings and make sure that they allow communication with Amazon service endpoints. For information, see Amazon DataSync network requirements.

I can't activate an agent using a VPC endpoint

If you are having issues when you are activating an agent that is created using a VPC endpoint, open a support channel against your VPC endpoint elastic network interface. For information about Support Channel, see Getting help with your agent from Amazon Web Services Support.

I don't know what's going on with my agent. Can someone help me?

If you're having issues with your DataSync agent that you can't solve, see Getting help with your agent from Amazon Web Services Support.