Skip to content
Branch: master
Find file Copy path
Find file Copy path
11 contributors

Users who have contributed to this file

@mmendonca3 @nehalaws @shengmiw @AmyZhangAmz @dimaAmz @wael-amz @chanjeon @mattford-amazon @shihuazhang @djulian-amzn @YujiaozhAws
418 lines (340 sloc) 15.3 KB


  • Disable appconfig to load credential from specific profile path, add EC2 credentials as the default fallback
  • Remove sudoers file creation logic if ssm-user already exists
  • Enable supplementary groups for ssm-user on Linux


  • Bug fix for UTF-8 encoded issue caused by locale activation on Ubuntu 16.04 instance
  • Refactor ssm-user creation logic
  • Bug fix for reporting IP address with wrong network interface
  • Update configure package document arn pattern


  • Bug fix for on-premises instance registration in CN region


  • Add support for further encryption of session data using AWS KMS
  • Bug fix for excessive instance-id fetching by document workers


  • Bug fix for downloading content failure caused by wrong S3 endpoint
  • Bug fix for reboot failure caused by session manager panic
  • Bug fix for session manager shell output dropping character
  • Bug fix for mgs endpoint configuration consistency


  • Updates to UpdateInstanceInformation call, Windows initialization


  • Bug fix addressing issues in Distributor package upgrade


  • Bug fix to allow installation of Distributor packages that do not have a version name.
  • Bug fix for agent crash with message "WaitGroup is reused before previous Wait has returned".


  • Add frequent collector to detect changed inventory types and upload it to SSM service between two scheduled collections.
  • Change AWS Systems Manager Distributor to reduce calls to GetDocument by calling DescribeDocument.
  • Add exit code when ssm-cli execution fails.
  • Create ssm-user only after the control channel has been successfully created.

  • Enabled AWS Systems Manager Distributor that lets you securely distribute and install software packages.
  • Add support for the arm64 architecture on Amazon Linux 2, Ubuntu 16.04/18.04, and RHEL 7.6 to support EC2 A1 instances.

  • Bug fix for session manager logging on Windows
  • Bug fix for ConfigureCloudWatch plugin
  • Bug fix for update SSM agent occasionally failing due to SSM agent service stuck in starting state

  • Bug fix for past sessions occasionally stuck in terminating state
  • Darwin masquerades as Linux to bypass OS validation on the backend until official support can be added

  • Update managed instance role token more frequently

  • Bug fix for issue that GatherInventory throw out error when there is no Windows Update in instance
  • Add more filters when getting the Windows event logs at startup to improve performance
  • Add random jitter before call PutInventory in inventory datauploader

  • Bug fix for issues during process termination on instances where IAM policy does not grant ssmmessages permissions.

  • Bug fix to prevent defunct processes when creating the local user ssm-user.
  • Bug fix for sudoersFile permission to avoid "sudo" command warnings in Session Manager.
  • Disable hibernation on Windows platform if Cloudwatch configuration is present.

  • Enables the Session Manager capability that lets you manage your Amazon EC2 instance through an interactive one-click browser-based shell or through the AWS CLI.
  • Beginning this agent version, SSM Agent will create a local user "ssm-user" and either add it to /etc/sudoers (Linux) or to the Administrators group (Windows) every time the agent starts. The ssm-user is the default OS user when a Session Manager session is started, and the password for this user is reset on every session. You can change the permissions by moving the ssm-user to a less-privileged group or by changing the sudoers file. The ssm-user is not removed from the system when SSM Agent is uninstalled.

  • Bug fix for the SSM Agent service remaining in "Starting" state on Windows when unable to authenticate to the Systems Manager service.


NOTE: This build should not be installed for Windows since the SSM Agent service may remain in starting status if unable to authenticate to the Systems Manager service, which is fixed in the latest release.

  • Bug fix for missing cloudwatch.exe seen in SSM Agent version 2.2.902.0


NOTE: This build should not be installed for Windows since you might see the error - "Encountered error while starting the plugin: Unable to locate cloudwatch.exe" for Cloudwatch plugin. This bug has been fixed in SSM Agent version 2.2.916.0. Also SSM Agent service may remain in starting status if unable to authenticate to the Systems Manager service, which is fixed in the latest release.

  • Initial support for developer builds on macOS
  • Retry sending Run Command execution results for up to 2 hours
  • More detailed error messages are returned for inventory plugin failures during State Manager association executions


  • Bug fix to clean the orchestration directory
  • Streaming AWS Systems Manager Run Command output to CloudWatch Logs
  • Reducing number of retries for serial port opening
  • Add retry logic to installation verification


  • Various bug fixes


  • Various bug fixes


  • Bug fix to retry sending document results if they couldn't reach the service


NOTE: Downgrade to this version using AWS-UpdateSSMAgent is not permitted for agent installed using snap

  • Added support for Ubuntu Snap packaging
  • Bug fix so that aws:downloadContent does not change permissions of directories
  • Bug fix to Cloudwatch plugin where StartType has duplicated Enabled value


  • Added support for agent hibernation so that Agent backs off or enters hibernation mode if it does not have access to the service
  • Various bug fixes


  • Fix S3Download to download from cross regions.
  • Various bug fixes


  • Bug fix to change sourceHashType to be default sha256 on psmodule.
  • Various bug fixes

  • Bug fix to address an issue that can prevent the agent from processing associations after a restart

  • Various bug fixes.

  • Fix bug on windows agent (v2.2.103, v2.2.120.0) running into hung state with high volume of associations/runcommands
  • Execute "pwsh" on linux when using runPowershellScript plugin

NOTE: There is a known issue in this build that can cause Windows instances to stop processing commands and associations. The issue is resolved in build versions>

  • Various bug fixes.

NOTE: There is a known issue in this build that can cause Windows instances to stop processing commands and associations. The issue is resolved in build versions>

  • Various bug fixes.

NOTE: There is a known issue in this build that can cause Windows instances to stop processing commands and associations. The issue is resolved in build versions>

  • Various bug fixes.

  • Update to latest AWS SDK.
  • Various bug fixes.

  • Bug fix for proxy environment variables in Windows.

  • Various bug fixes.

  • Switching to use Birdwatcher distribution service for AWS packages.
  • Various bug fixes.

  • Adding versioning support for Parameter Store.
  • Added additional gatherers for inventory, including windows service gatherer, windows registry gatherer, file metadata gatherer, windows role gatherer.
  • Added support for aws:downloadContent plugin to download content from GitHub, S3 and documents from SSM documents.
  • Added support for aws:runDocument plugin to execute SSM documents.

  • Improved speed of initial association application on boot
  • Various aws:configurePackage service integration changes
  • Improved home directory detection in non-x64 linux platforms to address cases where shared AWS SDK credentials were not available in on-prem instances

  • Added exponential backoff in bucket region check for s3 upload
  • Fixed an issue with orchestration directory cleanup for RunCommand
  • Important Reminder: In an upcoming release, the RPM installer won't start the service by default after initial RPM installation. All customers should update any automation for RPM-based installs to start the agent after install if desired.

  • Increment major/minor version to 2.2
  • Bug fix on update to v2.1.10.0
  • Advance Notice: In an upcoming release, to align with the guidelines for RPM-based distros, the RPM installer won't start the service by default after initial RPM installation. It will start automatically after RPM update only if the service was running previously. The behavior of the Debian and MSI installer is unchanged.

  • Including SSM-CLI in Debian 386 packages
  • Bug fix for multi-step document output
  • Various bug fixes

  • Support for command execution out-of-process


  • Various bug fixes


  • Added Raspbian support for armv6 to support Raspberry Pi
  • Various bug fixes


  • Updated golang/sys dependency to the latest
  • Increased run command document maximum execution timeout to 48 hours
  • Various bug fixes


  • Added support for uploading agent logs to CloudWatch for SSM Agent diagnostics
  • Added additional gatherers for inventory
  • Added configuration compliance support for association
  • Various bug fixes


  • Add capability to configure custom s3 endpoint for the agent
  • Various bug fixes


  • Various bug fixes


  • Added rollback support in aws:configurePackage
  • Various bug fixes


  • Various bug fixes


  • [Bug] This version is not a valid update target from version 2.0.761.0.
  • Added support for using the OS proxy settings by default in Windows
  • Fixed issue preventing CloudWatch proxy settings from being retained on update
  • Various bug fixes


  • Added support for SLES (SuSE) (64-bit, v12 and above)
  • Various bug fixes


  • Linux platform version now based on os-release when available
  • Various bug fixes


  • Added support for step-level preconditions
  • Added support for rate/interval based schedule expressions for associations
  • Added Summary and PackageID fields to inventory's aws:application gatherer
  • Changed inventory's aws:application gatherer to use win32_processor: addressWidth to detect OS architecture to avoid localization based errors
  • Fixed CloudWatch issue with large configuration
  • Fixed S3 upload when instance and bucket are not in the same region
  • Fixed bug that prevented native language AMIs (Japanese AMI) from launching Cloudwatch
  • Various bug fixes


  • Returning longer StandardOutput and StandardError from RunShellScript and RunPowerShellScript which show up in the results of GetCommandInvocation and the detailed output of ListCommandInvocation
  • Added Document v2.0 support for Run Command, which includes support for multiple actions of same plugin type
  • Various bug fixes


  • Amazon-ssm-agent service automatically started after reboot on systemd platforms
  • Added Release notes to be available on linux packages
  • Various bug fixes


  • Fixed bugs that prevented CloudWatch from launching and allowed multiple instances of CloudWatch to launch on Windows
  • Various bug fixes


  • Fixed issues with agent starting before network is ready on systemd systems.


  • Pass proxy settings to domain join and CloudWatch
  • Various bug fixes


  • Various bug fixes


  • Added support for installing Docker on Linux
  • Removed the upper limit for the maximum number of parallel executing documents on the agent (previously the max was 10) You can configure this number by setting the “CommandWorkerLimit” attribute in amazon-ssm-agent.json file


  • Added bucket-owner-full-control ACL to S3 outputs to support cross-account upload
  • Various bug fixes


  • Various bug fixes
  • Standardized S3 result paths across plugins; commands append command-id/instance-id/plugin-name/step-id associations append instance-id/association-id/execution-date/plugin-name/step-id
    • step-id is the id field in plugin input if present and supported, otherwise the step name (in 2.0 schema documents), otherwise the plugin-name again
    • plugin-name and step-id have : characters removed
  • FreeBSD patches from external contributor


  • Added support for aws:softwareInventory plugin to upload inventory related log messages to S3
  • Fixed CloudWatch crash issue
  • Various bug fixes


  • Fixed Domain Join to support customized OU


  • Added support for running Powershell on Linux
  • Fixed CloudWatch doesn't work with creating association from Console
  • Various bug fixes


  • Various bug fixes


  • Fixed SSM Agent not able to start on Windows Server 2003
  • Various bug fixes


  • Various bug fixes


  • Added support for State Manager that automates the process of keeping your Amazon EC2 and hybrid infrastructure in a state that you define You can use State Manager to ensure that your instances are bootstrapped with specific software at startup, configured according to your security policy, joined to a Windows domain, or patched with specific software updates throughout their lifecycle
  • Added support for Systems Manager Inventory that allows you to specify the type of metadata to collect, the instances from where the metadata should be collected, and a schedule for metadata collection
  • Added support for installing, uninstalling, and updating AWS packages published by AWS
  • Added support for installing Docker on Windows and running Docker actions


  • Added support for Amazon EC2 Simple Systems Manager (SSM) Config feature to manage the configuration of your instances while they are running. You create an SSM document, which describes configuration tasks (for example, installing software), and then associate the SSM document with one or more running instances
  • Added support for Windows Server 2016
  • Added support for Windows Server Nano


  • Various bug fixes


  • Added support for Ubuntu Xenial (16.04 LTS)
  • Added support for region cn-north-1


  • Added support for allowing Amazon EC2 Run Command to work on any instance or virtual machine outside of AWS, including your own data centers or other clouds You now have a consistent experience to extend your scripts across locations and automate administrative tasks across instances, irrespective of location


  • Added addition platform (CentOS, Ubuntu) support
  • Added 32bits support


  • Initial SSM Agent release
You can’t perform that action at this time.