In this blog, we will show you the steps to registering on-premise Windows VM in Simple Systems Manager.
ENVIRONMENT OVERVIEW
- We have created a windows 2012 R2 server in our Hyper-V environment for this demo.
CREATING ACTIVATIONS
- Go to the services page and search for systems manager.
- Click on Hybrid Activations link under Instances & Nodes menu.
- Click on Create an Activation button.
- Provide a description for this activation and set the number of on-premise machines you are planning to add in systems manager.
- Set the expiration date for the on-premise machines to be available in the systems manager and click on create activation.
- Activation created successfully. Please make a note of the activation code and activation ID for future reference.
INSTALLING SSM AGENT
- Access your on-premise VM through RDP and download the SSM agent from this URL https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/windows_amd64/AmazonSSMAgentSetup.exe
- Once its downloaded, double click on the setup file and accept the license agreement then click on the install button.
- It will take a few seconds to complete the installation process.
REGISTERING THE VM
- Open the windows services snap-in and make sure the Amazon SSM agent is in stop state.
- Open the command prompt and goto C:\Program Files\Amazon\SSM folder.
Note: Make sure that you are accessing the command prompt in administrator mode.
- Use the below command to register the VM with AWS Systems Manager.
Syntax: amazon-ssm-agent -register -code “<your activation code>” -id “<activation ID>” -region “<region where you registering your on-premise VMs>
Example: amazon-ssm-agent -register -code “7zUVhzNNKZ0qoL/fqecV” -id “2d4a2885-b742-4a30-806c-35f0870a1675” -region “ap-south-1”
- Command executed successfully.
- Now start the Amazon SSM agent service.
- Go to systems manager and click on Managed instances.
- You will able to see your on-premise VM in the managed list.
Thanks for reading this blog. We hope it was useful for you to learn about registering on-premise Windows VM in AWS Systems Manager.
