Chapter 2. Upgrading Red Hat Update Infrastructure

Procedure

1. On the RHUA node, update RHUI Installer.

   # dnf update rhui-installer

2. Run RHUI Installer:

   • If you are updating from RHUI 4.10 and you have already started using the on_demand synchronization policy, copy the relevant part of the configuration to the custom configuration file as described in Preserving Custom Configuration After RHUI Upgrade.

   • Run the rhui-installer command as follows:

     • If you are updating from RHUI 4.1.0 or older, you must specify your custom RHUI CA along with the rerun option:

       # rhui-installer --rerun --user-supplied-rhui-ca-crt <custom_RHUI_CA.crt> --user-supplied-rhui-ca-key <custom_RHUI_CA_key>

     • If you are updating from RHUI 4.1.1 or newer, run RHUI Installer with just the rerun option:

       # rhui-installer --rerun

     • If you are updating the version of PostgreSQL from 12 to 15 you must specify this using the --postgresql-version option along with the rerun option:

       # rhui-installer --postgresql-version 15 --rerun

3. Optional: In some environments, rhui-installer fails to rerun and displays the following error instead:

   There have been identified artifacts with forbidden checksum md5. Run pulpcore-manager handle-artifact-checksums first to unset forbidden checksums.

   To fix this error:

   1. Run the following command on the RHUA node:

      # env PULP_SETTINGS=/etc/pulp/settings.py pulpcore-manager handle-artifact-checksums

   2. Run rhui-installer with the rerun option.

4. Check if the rhui-installer installed updated packages.

   By default the rhui-installer will install any available RHEL package updates. RHUA must be rebooted if any package has been updated that requires rebooting. The command to check this is:

   # needs-restarting -r

   Note

   This command is part of the yum-utils package, which must be installed on the RHUA for the command to be available.

5. To apply updated templates and playbooks, reinstall all of the CDS nodes.

   This will also install any available RHEL package updates. To avoid that, run the below command with the --no_update flag.

   # rhui-manager --noninteractive cds reinstall --all

6. Check if updated packages were installed on the CDS nodes.

   If package updates were installed the CDS nodes may need to be rebooted. To check if your CDS nodes do need to be rebooted, log on to them and run this command:

   # needs-restarting -r

   Note

   This command is part of the yum-utils package, which must be installed on the CDS for the command to be available.

7. Log in to RHUI Manager.

   # rhui-manager