Install SSM Agent on CentOS 7.x
The Amazon Machine Images (AMIs) for CentOS 7 that are provided by Amazon do not come with Amazon Systems Manager Agent (SSM Agent) preinstalled by default. Use the information on this page to help you install or reinstall the agent on CentOS 7 instances.
Topics
Quick installation commands for SSM Agent on CentOS 7
Use the following steps to manually install SSM Agent on a single instance. This procedure uses globally available installation files.
To install SSM Agent on CentOS 7.x
-
Connect to your CentOS 7 instance using your preferred method, such as SSH.
-
Copy the command for your instance’s architecture and run it on the instance.
Note
Even though URLs in the following commands include an
ec2-downloads-windows
directory, these are the correct global installation files for CentOS 7.- x86_64 instances
-
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
- ARM64 instances
-
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
-
(Recommended) Run the following command to verify that the agent is running.
sudo systemctl status amazon-ssm-agent
In most cases, the command reports that the agent is running, as shown in the following example.
● amazon-ssm-agent.service - amazon-ssm-agent Loaded: loaded (/etc/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: disabled) Active: active (running) since Tue 2022-04-19 15:57:27 UTC; 6s ago --truncated--
In rare cases, the command reports that the agent is installed but not running, as shown in the following example.
● amazon-ssm-agent.service - amazon-ssm-agent Loaded: loaded (/etc/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: disabled) Active: inactive (dead) since Tue 2022-04-19 15:58:44 UTC; 2s ago --truncated--
To activate the agent in these cases, run the following commands.
sudo systemctl enable amazon-ssm-agent
sudo systemctl start amazon-ssm-agent
Create custom agent installation commands for CentOS 7 in your Region
When you install SSM Agent on multiple instances using a script or template, we recommend using installation files that are stored in the Amazon Web Services Region you're working in.
For the following commands, we provide examples that use a publicly
accessible S3 bucket in the US East (Ohio) Region (us-east-2
).
Tip
You can also replace a global URL in the procedure Quick installation commands for SSM Agent on CentOS 7 earlier in this topic with a custom Regional URL you construct.
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.
- x86_64
-
sudo yum install -y https://s3.
region
.amazonaws.com/amazon-ssm-region
/latest/linux_amd64/amazon-ssm-agent.rpmSee the following example.
sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
- ARM64
-
sudo yum install -y https://s3.
region
.amazonaws.com/amazon-ssm-region
/latest/linux_arm64/amazon-ssm-agent.rpmSee the following example.
sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm