Chapter 2. Upgrading Red Hat Update Infrastructure

Red Hat Update Infrastructure (RHUI) is periodically upgraded to introduce bug fixes, enhancements, and fix common vulnerabilities and exposures.

Important

Red Hat recommends keeping your installation up to date by applying the latest RHUI updates when they are released.

2.1. Updating Red Hat Update Infrastructure

To update your instance of Red Hat Update Infrastructure (RHUI) to the latest version, you must update RHUI Manager and the associated packages and nodes.

Prerequisites

  • Root access to the RHUA node.
  • All of your RHUI nodes are subscribed and are using the correct repositories.
  • All previously released errata for Red Hat Enterprise Linux (RHEL) are applied. For more information, see How do I apply package updates to my RHEL system?
  • Repository synchronization tasks are scheduled to run after the update is complete. Tasks that run while the update is in progress might be aborted. For more information see Known Issues.

Procedure

  1. On the RHUA node, update RHUI Installer. 

    # dnf update rhui-installer

  2. Run RHUI Installer:

    • 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

  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

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

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

  6. Log in to RHUI Manager. 

    # rhui-manager

Verification

  • On the RHUA node, run the following command and verify whether the latest version of RHUI is installed. 

    # rpm -q rhui-tools