Manually installing and uninstalling SSM Agent on EC2 instances for macOS - AWS Systems Manager

Manually installing and uninstalling SSM Agent on EC2 instances for macOS

Connect to your macOS instance and perform the following steps to install AWS Systems Manager Agent (SSM Agent). Perform these steps on each instance that will run commands using Systems Manager. The commands provided in this procedure can also be passed to Amazon EC2 instances as scripts through user data.

To install SSM Agent on macOS

  1. Download the agent installer file for x86_64 instances using the following command.

    In the following command, replace region with your own information. For a list of supported region values, see the Region column in Systems Manager service endpoints in the Amazon Web Services General Reference.

    sudo wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_amd64/amazon-ssm-agent.pkg

    For Apple silicon instances use the following command.

    sudo wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_arm64/amazon-ssm-agent.pkg

    Here is an example.

    sudo wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/darwin_amd64/amazon-ssm-agent.pkg

  2. Use the following command to run the SSM Agent installer.

    x86_64:

    sudo installer -pkg amazon-ssm-agent.pkg -target /

  3. Check the status of the agent.

    To determine if SSM Agent is running, check the agent log at /var/log/amazon/ssm/amazon-ssm-agent.log .

  4. Run the following command to start the service if the the agent log indicates that "amazon-ssm-agent is stopped."

    sudo launchctl load -w /Library/LaunchDaemons/com.amazon.aws.ssm.plist && sudo launchctl start com.amazon.aws.ssm
Important

An updated version of SSM Agent is released whenever new capabilities are added to Systems Manager or updates are made to existing capabilities. Failing to use the latest version of the agent can prevent your managed node from using various Systems Manager capabilities and features. For that reason, we recommend that you automate the process of keeping SSM Agent up to date on your machines. For information, see Automating updates to SSM Agent. Subscribe to the SSM Agent Release Notes page on GitHub to get notifications about SSM Agent updates.