How to remove/unregister a System from Red Hat Satellite 5.x?
Environment
- Red Hat Enterprise Linux 5
- Red Hat Enterprise Linux 6
- Red Hat Enterprise Linux 7
- Red Hat Satellite 5.x
Issue
- A system needs to be unregistered from Red Hat Satellite 5.x.
- How to delete system using API on Red Hat Satellite 5.x?
Resolution
- Red Hat Satellite-5.x does not provide an option to unregister client.
- The only option available to remove a client from satellite server is to delete the client's profile from satellite server.
- To remove clients profile from satellite server perform these steps:
- Log in to the Satellite server's web-ui.
- Click on the
Systemstab in the top navigation bar and then click on the name of the system from the System List which you want to remove from the satellite. - Click the
Delete Systemlink in the top-right corner of the page. - Confirm system profile deletion by clicking the
Delete Systembutton. - Now go to the client system and execute below command to remove the associated systemid file:
# rm -rf /etc/sysconfig/rhn/systemid
-
How to Delete system from Red Hat Satellite Server using API?
- To delete a system from Satellite using
spacewalk-apirun the below command on satellite server:
- To delete a system from Satellite using
# spacewalk-api --server=localhost --user=admin --password=**** system.deleteSystem %session% <SYSTEM_ID>
- For eg:
# spacewalk-api --server=localhost --user=admin --password=mypassword system.deleteSystem %session% 100983563
- The above command would remove the system from satellite server, but the client system would still have stale information in order to remove the same please run below command on the Client system:
# rm -rf /etc/sysconfig/rhn/systemid
This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.
Welcome! Check out the Getting Started with Red Hat page for quick tours and guides for common tasks.
