Transition from RHN Classic 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 Classic 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 Manager 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.

Additional Features:

With RHSM, you can also expect regular feature updates including:

  • Coming Soon: Errata display: View a list of errata affecting a system.
  • Coming Soon: Labeling: Apply labels to organize systems and subscriptions, as well as take actions such as assigning permissions.

Get Started with Red Hat Subscription Manager

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 Customer Portal to receive bug fixes and updates.

  1. Click Subscriptions from the menu in the top left of your screen.
  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 Classic 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.

Choose one of the three options below:

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 Classic to RHSM. This is the supported method for migrating systems.

Open Terminal, and run the migration script:

# yum install subscription-manager-migration subscription-manager-migration-data
# rhn-migrate-classic-to-rhsm

RHN Hosted to RHSM Hosted (Alternative Migration Path)

The migration tools are contained in the subscription-manager-migration package. An additional package, subscription-manager-migration-data, is required to map the RHN Classic channels to Customer Portal Subscription Management product certificates.

Make sure the necessary migration packages are available on your system. Install the migration tools and mapping data in:

# 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 Classic 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


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 further action is needed.

If you are using Red Hat Satellite 5, your Satellite server(s) will still function and be supported similarly as before. However, you should anticipate a modest configuration and account level management change in July, 2017 in order to take advantage of the new RHSM platform. Red Hat will provide you with specific guidance in early 2017 to help you prepare for making these updates to your Satellite 5 server(s). Our goal is to make these changes as seamless as possible, so you can quickly continue using your Satellite 5 servers without issue.

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

Satellite Proxy

To ensure a successful transition as RHN is shut down, Satellite Proxy customers have a few options:

  • You can transition to Satellite 6. The migration to Satellite 6 can be requested from Red Hat directly .
  • You can run RHN Proxy from the command line. Be advised that running Satellite Proxy from the command line can be challenging when managing the proxy, as well as attaching new clients.

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.