Chapter 19. Changing a subscription service


To manage the subscriptions, you can register a RHEL system with either Red Hat Subscription Management Server or Red Hat Satellite Server. If required, you can change the subscription service at a later point. To change the subscription service under which you are registered, unregister the system from the current service and then register it with a new service.

To receive the system updates, register your system with either of the management servers.

This section contains information about how to unregister your RHEL system from the Red Hat Subscription Management Server and Red Hat Satellite Server.

Prerequisites

You have registered your system with any one of the following:

  • Red Hat Subscription Management Server
  • Red Hat Satellite Server version 6.17

To receive the system updates, register your system with either of the management servers.

19.1. Unregistering from Subscription Management Server

You can unregister a RHEL system from Red Hat Subscription Management Server by using a command line and the Subscription Manager user interface.

19.1.1. Unregistering using command line

Use the unregister command to unregister a RHEL system from Red Hat Subscription Management Server.

Procedure

  • Run the unregister command as a root user or sudo, without any additional parameters.

    # subscription-manager unregister
    Copy to Clipboard

The system is unregistered from the Subscription Management Server, and the status 'System Not Registered' is displayed with the Register System.. button enabled.

To continue uninterrupted services, re-register the system with either of the management services. If you do not register the system with a management service, you may fail to receive the system updates. For more information about registering a system, see Registering your system using the command line.

19.1.2. Unregistering by using Subscription Manager user interface

You can unregister a RHEL system from Red Hat Subscription Management Server by using the Subscription Manager user interface.

Procedure

  1. Log in to your system.
  2. From the top left-hand side of the window, click Activities.
  3. From the menu options, click the Show Applications icon.
  4. Click the Settings icon, or enter Settings Manager in the search.
  5. In the left side column, select the System options, then on the new screen select Registration.

    The Registration screen displays the current status of your Subscription.

  6. Click the Remove Registration… button and confirm your choice.
  7. Enter your administrator password in the Authentication Required dialog box. The system is unregistered from the Subscription Management Server, and the status System Not Registered is displayed with the Register System… button enabled.

To continue uninterrupted services, re-register the system with either of the management services. If you do not register the system with a management service, you may fail to receive the system updates. For more information, see Registering your system using the Subscription Manager User Interface.

19.2. Unregistering from Satellite Server

Removing a Red Hat Enterprise Linux (RHEL) system from Satellite Server updates the system’s status on the server side. However, the system’s local registration remains unchanged. To ensure a complete transition to Red Hat Subscription Management (RHSM), manually unregister the system and restore the default configuration in the /etc/rhsm/rhsm.conf file.

Procedure

  1. Remove the host from the Satellite server.
  2. Unregister the system:

    # subscription-manager unregister
    Copy to Clipboard
  3. Revert the /etc/rhsm/rhsm.conf configuration file to its default values:

    # cd /etc/rhsm/
    # mv rhsm.conf.bak rhsm.conf
    Copy to Clipboard
    Note

    You can restore this file only if the original content of the file was backed up earlier. Otherwise, you must manually restore the file from a non-modified RHEL machine.

  4. Verify that the /etc/rhsm/rhsm.conf file has been reverted to default values:

    # 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
    Copy to Clipboard
  5. Register the system:

    # subscription-manager register
    Username: <_redhat_portal_admin_username_>
    Password:
    Copy to Clipboard
  6. Enable the required repositories:

    # subscription-manager repos --disable "*"
    # subscription-manager repos
    # subscription-manager repos --enable=<repo-id>
    Copy to Clipboard
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat