Uninstall the AWS Systems Manager Agent
If you no longer want to manage a Greengrass core device with AWS Systems Manager, you can deregister the core device from Systems Manager and uninstall the AWS Systems Manager Agent (Systems Manager Agent) from the device.
You can reregister a core device again at any time. To do so, deploy the Systems Manager Agent component again, which registers the core device with Systems Manager when it installs. Systems Manager stores the command history for a deregistered core device for 30 days.
Topics
Step 1: Deregister the core device from Systems Manager
You can use the Systems Manager console or API to deregister the core device. For more information, see Deregistering managed nodes in the AWS Systems Manager User Guide.
Step 2: Uninstall the Systems Manager Agent component
After you deregister the core device, uninstall the Systems Manager Agent component from the device. To remove a component from a Greengrass core device, revise the deployment that installed the component, and remove the component from the deployment. The AWS IoT Greengrass Core software uninstalls a component when none of a core device's deployments specify that component. For more information, see Deploy AWS IoT Greengrass components to devices.
-
In the AWS IoT Greengrass console
navigation menu, choose Core devices. -
Choose the core device where you want to uninstall the Systems Manager Agent component.
-
On the core device details page, choose the Deployments tab.
-
Choose the deployment that deploys the Systems Manager Agent component to the core device.
-
On the deployment details page, choose Revise.
-
In the Revise deployment modal, choose Revise deployment.
-
In Step 1: Specify target, choose Next.
-
In Step 2: Select components, clear the selection for the aws.greengrass.SystemsManagerAgent component, and then choose Next.
-
In Step 3: Configure components, choose Next.
-
In Step 4: Configure advanced settings, choose Next.
-
In Step 5: Review, choose Deploy.
To uninstall the Systems Manager Agent component, revise the deployment that deploys it, and remove it from the deployment. For more information, see Revise deployments.
The deployment can take several minutes to complete. You can use the AWS IoT Greengrass service to check the status of the deployment. For more information, see Check deployment status.
Step 3: Uninstall the Systems Manager Agent software
The Systems Manager Agent software continues to run on the core device after you remove the Systems Manager Agent component. To remove the Systems Manager Agent software, you can run commands on the core device. For more information, see Uninstall Systems Manager Agent from Linux instances in the AWS Systems Manager User Guide.
