2.2. Installing the Migration Tools

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.
An automatic virt-who configuration tool is available on Customer Portal for systems running RHEL 6 and RHEL 7.
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.
  1. The migration tools and data are usually in the main channels for Red Hat Enterprise Linux 5 or 6, but they may be located in optional or supplementary channels. Do a simple yum search to make sure that the packages are available. For example:
    [root@server ~]# yum search subscription-manager-migration -v
    Not loading "rhnplugin" plugin, as it is disabled
    Loading "product-id" plugin
    Loading "refresh-packagekit" plugin
    Loading "security" plugin
    Loading "subscription-manager" plugin
    Updating certificate-based repositories.
    
    ================= N/S Matched: subscription-manager-migration ==================
    subscription-manager-migration.x86_64 : Migration scripts for moving to
                                          : certificate based subscriptions
    Repo        : rhel-6-server-rpms
    
    subscription-manager-migration-data.noarch : RHN Classic to RHSM migration data
    Repo        : rhel-6-server-rpms
    If necessary, enable the supplementary repositories which contain the migration RPMs.
    [root@server ~]# subscription-manager repos --enable rhel-6-server-optional-rpms
  2. Install the migration tool packages.
    [root@server ~]# yum install subscription-manager-migration subscription-manager-migration-data