Migration from RHSM to RHN Classic

Solution Verified - Updated -


  • Red Hat Enterprise Linux 5.6 or later
  • Red Hat Enterprise Linux 6.1 or later


Registering a system to Red Hat Network (RHN) instead of RHSM is not recommended because RHN will be decommisionned on July the 31st, 2017.

The following information has been provided by Red Hat, but is outside the scope of our posted Service Level Agreements ( https://www.redhat.com/support/service/sla/ ) and support procedures. The information is provided as-is and any  configuration settings or installed applications made from the  information in this article could make your Operating System unsupported  by Red Hat Support Services. The intent of this article is to provide  you with information to accomplish your system needs. Use the  information in this article at your own risk.

  • How to move a system from RHSM to RHN Classic.


1) Only the following plugins should be listed if the system is registered to RHSM:

[root@localhost ~]# yum check update
Loaded plugins: refresh-packagekit, subscription-manager, product-id

2) Check to see if the rhn plugins are installed, or install plugins needed for RHN Classic:
To check:

[root@localhost ~]#  rpm -qa rhn-setup

To install:

[root@localhost ~]# yum install rhn-setup

3) Unregister and remove any local traces from RHSM as necessary:

[root@localhost ~]# subscription-manager unregister
[root@localhost ~]# subscription-manager clean

4) Change directory to edit plugins:

[root@localhost ~]# cd /etc/yum/pluginconf.d

5) List current plugins:

[root@localhost pluginconf.d]# ls
product-id.conf          rhnplugin.conf
refresh-packagekit.conf  subscription-manager.conf

6) Edit plugins on system, enable plugins needed for RHN Classic:

[root@localhost pluginconf.d]# vim rhnplugin.conf 

enabled = 1 
gpgcheck = 1 

[root@localhost pluginconf.d]# vim product-id.conf 

enabled = 0 
gpgcheck = 1 

[root@localhost pluginconf.d]# vim subscription-manager.conf 

enabled = 0 
gpgcheck = 1
  • RHN Classic Plugins:
    • rhnplugin.conf
    • refresh-package.conf
  • RHSM Plugins

    • product-id.conf
    • refresh-package.conf
    • subscription-manager.conf
  • Enabled = 1

  • Disabled = 0

7) Clean yum cache:

[root@localhost pluginconf.d]# yum clean all
Loaded plugins: refresh-packagekit, rhnplugin
Cleaning up Everything

8) Register system to RHN Classic via command-line:

[root@localhost pluginconf.d]# rhnreg_ks --username=<your RHN ID> --password=<your RHN password>

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.