AWS Systems Manager
User Guide

Uninstall a Package

You can use the AWS Management Console or the AWS CLI to uninstall Distributor packages from your AWS Systems Manager managed instances by using Run Command. In this release, you can uninstall one version of one package per command. You can uninstall a specific version or the default version.

Uninstall a Package (Console)

You can use Run Command in the AWS Systems Manager console to uninstall a package one time. Distributor uses AWS Systems Manager Run Command to uninstall packages.

  1. Open the AWS Systems Manager console at https://console.aws.amazon.com/systems-manager/.

  2. In the navigation pane, choose Run Command.

  3. On the Run Command home page, choose Run command.

  4. Choose the AWS-ConfigureAWSPackage command document.

  5. From Action, choose Uninstall

  6. For Name, enter the name of the package that you want to uninstall.

  7. In Targets, choose target managed instances by specifying a tag key and values that are shared by the managed instances, or specify instances by any of seven attributes, including instance ID, platform, and SSM Agent version.

  8. You can use the advanced options to add comments about the operation, change Concurrency and Error threshold values in Rate control, specify output options, or configure Amazon SNS notifications. For more information, see Running Commands from the Console in this guide.

  9. When you are ready to uninstall the package, choose Run, and then choose View results.

  10. In the commands list, choose the AWS-ConfigureAWSPackage command that you ran. If the command is still in progress, choose the refresh icon in the top-right corner of the console.

  11. When the Status column shows Success or Failed, choose the Output tab.

  12. Choose View output. The command output page shows the results of your command execution.

Uninstall a Package (CLI)

You can use the AWS CLI to uninstall a Distributor package from managed instances by using Run Command.

  • Run the following command in the AWS CLI.

    aws ssm send-command --document-name "AWS-ConfigureAWSPackage" --instance-ids "instance_IDs" --parameters '{"action":["Uninstall"],"name":["package_name (in same account) or package_ARN (shared from different account)"]}'

    The following is an example.

    aws ssm send-command --document-name "AWS-ConfigureAWSPackage" --instance-ids "i-00000000000000" --parameters '{"action":["Uninstall"],"name":["Test-ConfigureAWSPackage"]}'

For information about other options you can use with the send-command command, see send-command in the AWS Systems Manager section of the AWS CLI Command Reference.