This chapter explains how to uninstall Rudder.
Of course, uninstalling the agent means that the related server won’t be configured anymore by Rudder even if the node is still registered in Rudder server.
Uninstalling Rudder agent on node is done through OS package manager. Usually, these commands need
root rights. Commands are presented below for each supported OS family.
rudder-agent is uninstalled, you should check that:
rudderrelated services are correctly stopped. Check with the
ps aux | grep ruddercommand that none are still running or kill them.
rudderstatic and generated files were correctly deleted (especially for cron and init services)
For the second point, you can ensure that everything is deleted by removing these two directories:
rm -rf /opt/rudder rm -rf /var/rudder
You may want to also delete
rm -rf /var/log/rudder
On CentOS or RHEL (all supported versions):
yum remove rudder-agent
On Debian or Ubuntu (all supported versions):
apt-get remove rudder-agent
On SLES (all supported versions):
zypper remove rudder-agent
On AIX (all supported version):
rpm -e rudder-agent
slackpkg remove rudder-agent
On AIX, you will need to edit main crontab to remove
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /opt/rudder/bin/rudder agent check -q >> /var/log/rudder/agent-check/check.log 2>&1
rudder-agent package will let backup files of node identifying files (
UUID, node keys, etc) which allows to reinstall package and have Rudder server still know that it’s the same node than the one previously registered.
If you want to definitely uninstall that node, you need to delete these backup files
rm -rf /var/backups/rudder
This action is definitive and once done, you will need to reinstall and re-accept node as a new node in Rudder system.
rudder-agent package is uninstalled from a node, the corresponding node is still active in Rudder system: policies are still generated for it, etc. Of course, the node won’t send compliance reports anymore and so it will appear as a non answering node.
To delete a node from Rudder, you need to go to the node details page and click on the
|Uninstalling the Rudder server package will remove configuration data, that will be lost if you don’t have a backup. We advice to keep a backup of the server for future reference.|
You can uninstall the Rudder packages with your package manager, and follow the same cleanup steps as for the agent.
← Integrate Rudder thanks to its APIs Uninstall Rudder agent on a node →