Troubleshooting AWS Systems Manager Distributor
The following information can help you troubleshoot problems that might occur when you use Distributor.
Topics
Wrong package with the same name is installed
Problem: You've installed a package, but AWS Systems Manager Distributor installed a different package instead.
Cause: During installation, AWS Systems Manager finds AWS-published packages as results before user-defined external packages. If your user-defined package name is the same as an AWS-published package name, the AWS package is installed instead of your package.
Solution: To avoid this problem, name your package something different from the name for an AWS-published package.
Error: Failed to retrieve manifest: Could not find latest version of package
Problem: You received an error like the following:
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package arn:aws:ssm:::package/package-name
status code: 400, request id:guid
Cause: You are using a version of SSM Agent with Systems Manager Distributor that is earlier than version 2.3.274.0.
Solution: Update the version of SSM Agent to version 2.3.274.0 or later. For more information, see Update SSM Agent by using Run Command or Walkthrough: Automatically update SSM Agent (CLI).
Error: Failed to retrieve manifest: Validation exception
Problem: You received an error like the following:
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn' at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern: arn:aws:ssm:region-id
:account-id
:package/package-name
Cause: You are using a version of SSM Agent with Systems Manager Distributor that is earlier than version 2.3.274.0.
Solution: Update the version of SSM Agent to version 2.3.274.0 or later. For more information, see Update SSM Agent by using Run Command or Walkthrough: Automatically update SSM Agent (CLI).