How to remove/unregister a System from Red Hat Satellite 5.x?

Solution Verified - Updated -

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:
    1. Log in to the Satellite server's web-ui.
    2. Click on the Systems tab 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.
    3. Click the Delete System link in the top-right corner of the page.
    4. Confirm system profile deletion by clicking the Delete System button.
    5. 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-api run the below command on satellite server:
    # 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.

Close

Welcome! Check out the Getting Started with Red Hat page for quick tours and guides for common tasks.