Chapter 17. Upgrade Red Hat Update Infrastructure

The following steps describe how to migrate from Red Hat Update Infrastructure 2.1.3 to Red Hat Update Infrastructure 3.0. The current migration handles only Red Hat repositories; it does not handle custom repositories.

  1. Mount the downloaded ISO to the mnt directory on the RHUA by running the following commands. 

    [root@rhua mnt]# mkdir rhui
[root@rhua mnt]# mount -o loop <ISO> rhui

  2. Copy the migration script from rhui/migrate/migrate.py to the RHUI 2+ RHUA. 

    [root@rhua ~]# scp rhui/migrate/migrate.py rhua2:/directory/in/rhua2

  3. Log in to the Red Hat Update Infrastructure 2.1.3 RHUA and run the following script to generate the rhui-export-config-{timestamp}.tar. 

    [root@rhua2 ~]# python ./migrate.py -password <PASSWORD>
    Note

    Replace <PASSWORD> with the RHUI administrator’s password.

  4. Copy the rhui-export tarball to a Red Hat Update Infrastructure 3.0 directory. 

    [root@rhua2 ~]# scp rhui-export-config-{timestamp}.tar rhui3:
  5. Access a fully installed Red Hat Update Infrastructure 3.0.

  6. Unpack the rhui-export tarball. 

    [root@rhua ~]# tar xvf rhui-export-config-{timestamp}.tar

  7. Import data from Red Hat Update Infrastructure 2.1.3. 

    [root@rhua ~]# ./import-rhui2-data.sh
  8. Enter the RHUI password when prompted.

There are several steps you must perform to complete the migration from Red Hat Update Infrastructure 2.1.3 to Red Hat Update Infrastructure 3.0. For instance, you have to:

  • generate a new entitlement certificate for the migrated repositories on the Red Hat Update Infrastructure 3.0 RHUA.
  • create a client configuration RPM from that certificate.
  • copy and install the RPM on the client, replacing the previous Yum configuration for the Red Hat Update Infrastructure 2.1.3 RHUA.

To elaborate a little more, you must have created such an RPM on Red Hat Update Infrastructure 2.1.3 and installed it on a client, for example, the file name was example-rpm-1-1.noarch.rpm. On Red Hat Update Infrastructure 3.0, after migrating the repositories, you generate an entitlement and create an RPM named example-rpm-2-1.noarch.rpm.

The Red Hat Update Infrastructure Management Tool enables you specify the "Version of the configuration RPM." If you used "1" on Red Hat Update Infrastructure 2.1.3, use a higher number on Red Hat Update Infrastructure 3.0, for example, "2." Then you can use yum update example-rpm-2-1.noarch.rpm_ or rpm -U example-rpm-2-1.noarch.rpm on the client. The configuration gets replaced completely, and the client is ready to consume content from Red Hat Update Infrastructure 3.0. If you use a different name, you must remove the old configuration package (yum remove example-rpm or rpm -e example-rpm) and install the new one.

Report a bug