How to unregister a system from Red Hat Satellite 6 and register to the Red Hat Customer Portal

Solution Verified - Updated -

Environment

  • Red Hat Enterprise Linux(RHEL) 5.7 and newer
  • Red Hat Enterprise Linux(RHEL) 6.1 and newer
  • Red Hat Enterprise Linux(RHEL) 7.0 and newer
  • Red Hat Satellite 6.0 and newer
  • Red Hat Subscription Management
  • Red Hat Subscription-Manager
  • Red Hat Customer Portal

Issue

  • How to un-register a Red Hat Enterprise Linux system from Red Hat Satellite using Red Hat Subscription-Manager
  • How to register a Red Hat Enterprise Linux system to the Customer Portal using Red Hat Subscription-Manager

Resolution

Unregister From Red Hat Satellite

  1. Un-register from the Red Hat Satellite server

    # yum clean all
    # rm -rf /var/cache/yum/*
    # subscription-manager remove --all
    # subscription-manager unregister
    # subscription-manager clean
    
  2. Remove the host from Red Hat Satellite WebUI.

    Satellite WebUI -> Hosts -> Content Hosts -> (click on the hostname) -> Unregister the host
    

    Else if Satellite is 6.11+ remove the host by below steps

    Satellite WebUI -> Hosts -> Content Hosts -> (click on the hostname) -> In Top Right click on 3 dots ->  Click on 
    Legacy Content Host UI -> Click on Un-register Host from top left -> Select any Option out of two.
    
  3. Revert the rhsm configuration file (/etc/rhsm/rhsm.conf) to default values using any one of the following methods:
    Method 1: Remove the Satellite certificates(katello-ca-consumer package)

    # rpm -qa | grep katello-ca
    # rpm -e <Package>
    

    Method 2: Take a backup of the current rhsm.conf file and then rename the rhsm.conf.kat-backup file to rhsm.conf:

    # cd /etc/rhsm/
    # mv rhsm.conf rhsm.conf.bak
    # mv rhsm.conf.kat-backup rhsm.conf
    
  4. Verify whether the /etc/rhsm/rhsm.conf file has been reverted to default values. Type this command to see current settings:

    # subscription-manager config --list
    [server]
       hostname = [subscription.rhsm.redhat.com]
       insecure = [0]
       no_proxy = []
       port = [443]
       prefix = [/subscription]
       proxy_hostname = []
       proxy_password = []
       proxy_port = []
       proxy_scheme = [http]
       proxy_user = []
       server_timeout = [180]
       ssl_verify_depth = [3]
    
    [rhsm]
       auto_enable_yum_plugins = [1]
       baseurl = [https://cdn.redhat.com]
       ca_cert_dir = [/etc/rhsm/ca/]
       consumercertdir = [/etc/pki/consumer]
       entitlementcertdir = [/etc/pki/entitlement]
       full_refresh_on_yum = [0]
       inotify = [1]
       manage_repos = [1]
       package_profile_on_trans = [0]
       pluginconfdir = [/etc/rhsm/pluginconf.d]
       plugindir = [/usr/share/rhsm-plugins]
       productcertdir = [/etc/pki/product]
       repo_ca_cert = /etc/rhsm/ca/redhat-uep.pem
       repomd_gpg_url = []
       report_package_profile = [1]
    
    [rhsmcertd]
       auto_registration = [0]
       auto_registration_interval = [60]
       autoattachinterval = [1440]
       certcheckinterval = [240]
       disable = [0]
       splay = [1]
    
    [logging]
       default_log_level = [INFO]
    
    [] - Default value in use
    
    

    The values shown in the above example are the default settings.

Register to Red Hat Customer Portal

  1. Register the RHEL system to the Portal and attach a subscription.

    # subscription-manager register
    Username: <redhat_portal_admin_username>
    Password:
    
  2. Enable the required repositories

    # subscription-manager repos --disable "*"
    # subscription-manager repos 
    # subscription-manager repos --enable=<repo-id>
    

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.

Comments