Transition from RHN to RHSM

Red Hat is transitioning from the Red Hat Network (RHN) hosted interface to the Red Hat Subscription Management (RHSM) interface in July 2017. Red Hat has invested in and seen success from RHN for many years, and has used that experience to build more robust technologies like RHSM.

RHSM will provide solutions that are easier to navigate and scale, and tooling to manage your subscription assignments via the Red Hat Customer Portal. Systems registered as clients to Red Hat Network Hosted either directly or indirectly with Red Hat Proxy need to migrate to RHSM interface tools.

If you are using legacy technologies, you need to shift to RHSM by July 2017.


RHN Hosted UI will sunset in:

Please migrate to RHSM prior to this date to continue receiving support for your subscriptions.

Red Hat Subscription Management Info

Product Feature Highlights

RHSM manages your contracts, subscriptions, and utilization in a simplified user interface and helps you:

Contract Management

View a summary of contracts including a view of the systems using subscriptions purchased with each contract.

Simplified Interface

View subscription and entitlement information in one place in the user interface.

Usage Summaries

View a summary of subscription utilization, making the renewal decision easier.

RHSM System Compliance

View system compliance with RHSM on a system-by-system basis.

Errata Display

View a list of errata affecting a system.


Apply labels to organize systems and subscriptions, as well as take actions such as assigning permissions.

Get Started with Red Hat Subscription Management

Register a System

To begin using the interface, you must first register your systems to RHSM. Once registered, systems can be managed through the Customer Portal to receive bug fixes, manage updates, view system information and track individual subscriptions and entitlements.

Open Terminal to register and subscribe your system using the script:
# subscription-manager register --username <username> --password <password> --auto-attach
If the one-step registration process does not work, manually register and subscribe:
  1. Open Terminal.
  2. Register the system:
# subscription-manager register
If you would like further assistance for registering systems, use the Registration Assistant .

Attach a Subscription through Customer Portal

Once registered, systems can be managed through the following steps:

  1. Go to Red Hat Subscription Management
  2. Under Manage, click Systems.
  3. Click on the name of the system you want to modify.
  4. Click Attach a Subscription.
  5. Select the desired subscriptions, and click Attach Selected.

Migrating to RHSM

RHSM will provide solutions that are easier to navigate and scale, and tooling to manage your subscription assignments via the Red Hat Customer Portal. Systems registered as clients to Red Hat Network Hosted either directly or indirectly with Red Hat Proxy need to migrate to RHSM interface tools.

The user interface for RHN is shutting down July, 2017 and will no longer be supported. Staying on RHN is not recommended. RHSM contains the functionality you need to continue managing your systems.

You will no longer receive updates if the system was not registered prior to the shut down or if there were problems with the system. Satellite systems will no longer be able to register, activate, or sync to RHN Hosted and will need to use RHSM to do so.

  • Following the web shut down, you can no longer access the web UI , view system details , edit properties, or update from the Web UI.
  • Following the API shut down, you can no longer Register to RHN or Utilize APIs for any system management functions. All other feature shutdowns apply.
  • Following the datastore shut down, there will be no more updates, either.

However, as long as you have a registered system that is checking in, you can receive system updates from the command line or system GUI in RHEL as long as there are no problems with the system. Do you need help determining the systems you use with RHN? Try our new RHN System List Exporter lab app.

Choose one of the three options below:

Virt-who information

If you have a virt-limit=unlimited subscription (e.g., a data center), you need to set up virt-who before migrating to RHSM from RHN. If you don’t set up virt-who prior to the migration, repositories and/or subscriptions may fall off of any system that is using a virt-who required subscription.

  1. Decide on a configuration that suits your environment.
  2. Review the virt-who daemon’s prerequisites and ensure that all have been met.
  3. Install an instance of Red Hat Enterprise Linux for the purpose of running virt-who.
  4. Install the virt-who daemon.
    # yum install virt-who
  5. Establish connections between the virt-who daemon and your hypervisors.

Note: virt-who setup needs to be completed within 24 hours after the process is initiated.

RHN Hosted to RHSM Hosted

Beginning with RHEL versions 5.8 and 6.2, you can run an automatic script that migrates systems registered to RHN to RHSM. This is the supported method for migrating systems.

Note: Before you begin, the system you are migrating needs the subscription-manager-migration and subscription-manager-migration-data packages installed. These packages enable the RHN channels to the Customer Portal Subscription Management product certificates to be mapped during migration. If you do not have these packages installed beforehand, you need to install them manually:

Run the command:

# yum search subscription-manager-migration -v
If necessary, enable the supplementary repositories which contain the migration RPMS:
# subscription-manager repos --enable rhel-6-server-optional-rpms
Install the migration tool packages:
# yum install subscription-manager-migration subscription-manager-migration-data
Once the migration packages are installed, you can migrate from RHN to Subscription Management. The rhn-classic-to-rhsm script uses this syntax:

After running the migration, RHEL displays the script used for migration from the previous system.
# subscription-manager facts --list | grep migr
migration.classic_system_id: 09876
migration.migrated_from: rhn_hosted_classic
migration.migration_date: 2012-09-14T14:55:29.280519

Run the migration script in Terminal to migrate:
# yum install subscription-manager-migration subscription-manager-migration-data

# rhn-migrate-classic-to-rhsm

Satellite 5 to RHSM

If you are using Red Hat Satellite 6, changes planned for RHN subscription services in July, 2017 will not impact you, and no action is needed.

If you wish to continue using Red Hat Satellite 5, we highly recommend upgrading to the recently released Satellite 5.8 version as soon as possible. Satellite 5.8 has the ability to both register via Red Hat Subscription Manager (RHSM) and retrieve content from the Content Delivery Network (CDN). Additionally, Satellite 5.8 will offer Extended Lifecycle Support beginning in early 2019, if you wish to continue using Satellite 5 after that date. All other versions of Satellite 5 will end-of-life after January 31, 2019.

If you do wish to stay on Satellite 5.6 & 5.7 for a period of time, your servers will need to be migrated from Red Hat Network (RHN) to Red Hat Subscription Management (RHSM). Special care needs to be taken with Satellite 5.6 & 5.7 servers to ensure the systems will work properly. Red Hat has released an erratum on this topic with instructions for allowing a Satellite 5.6 or 5.7 system registered via RHSM to continue to sync via satellite-sync. Additionally, reference the following article Prepare Satellite 5 systems for Red Hat Network’s End of Life’ which walks you through the steps of migrating your systems.

As always, you can reference the Red Hat Satellite Lifecycle Support page to help you plan, deploy, and support your systems management infrastructure.

Proxy Server Standalone

Red Hat Satellite Proxy Server Stand-Alone is a component of Red Hat Satellite which uses the Proxy server as a stand-alone (Satellite-less) offering.

  • We recommend that you transition from Red Hat Stand-Alone to Satellite 6. Work with your Red Hat Account Manager to determine what Satellite subscriptions are best suited to your organization. Review the steps you need to take to migrate systems registered to RHN Classic via Satellite Proxy to Satellite 6.
  • Following the RNH UI shut down, you can run the Proxy server from the command line. We highly recommend you transition before this happens, however. It can be challenging to manage the Proxy Server and attach new clients from the command line.

Important: Proxy Server Stand-Alone shuts down on October 31, 2017. Please reference the Satellite and Proxy Server Lifecycle page for more information.  

Additional Migration Resources

Browse Red Hat Subscription Management Knowledge


Red Hat Subscription Management

RHSM First Boot

In this demo, Bryan Kearney walks through registering a new machine with Red Hat Subscription Management via first boot, as well as shows how to check your current entitlements within the Subscription Management tooling.

How can we help you?

Support Cases

Get answers quickly by opening a support case with us.

View Open Cases

Open New Case

Live Chat

Directly access our support engineers during weekday business hours.

Learn more

Call or Email

Speak directly with a Red Hat support expert by phone or through email.

Contact Us


Red Hat Security Updates

Red Hat Security Labs

Product Policies and Support Programs

Red Hat Life Cycles

Red Hat offers subscription services for each major release of products throughout four life-cycle phases—called Production 1, 2, and 3, and an Extended Life Phase.