RedHat Update Infrastructure (version 2) has been discontinued by RedHat and a new MCP RHUI architecture has been created using RHUI version 3. The architecture is described in Introducing the Red Hat Update Infrastructure v3.

All Cloud Servers deployed from OS Images from June 2019 forward are configured to use RHUI version 3. However, due to the differences between architectures, servers deployed prior to that time may need to follow a migration process to convert to the new architecture.  This document describes how to perform this action and what to expect during the migration process.

The process of moving customer VMs from RHUI v2 to RHUI v3 is initiated via a standard 'yum update' command.  Once launched, the process is fully automated and no user interaction is required; however, users should be aware of what to expect during the migration process.

Important Note

The update process can be initiated via a general 'yum update'; however, to ensure a successful migration to the new architecture, updating only the MCP client is highly recommended. 

Content / Solution:

  1. Check the existing MCP client version (this example shows the "rhel7" version of the MCP client)

    # rpm -qa mcp-client-rhel7
  2. To initiate the migration process, simply instruct YUM to update the MCP Client (replace "rhel7" with the version of the RedHat server being migrated.  i.e. "rhel5", "rhel6" or "rhel7").  This will initiate the YUM update process and install an intermediate MCP client RPM.  This intermediate RPM will install the proper MCP Client RPM based on the GEO and RHEL version running on the VM. The new client RPM contains everything necessary for the customer VM to start using the new RedHat Update Infrastructure.

     # yum update -y mcp-client-rhel7
    |   Starting RHUI Client installation.                         |
    |   Please see /var/log/rhui-client-install for details        |
  3. The upgrade runs as a detached process and will take approximately 5 minutes to complete.  During this time, no terminal output will be displayed; however, the progress can be monitored by running "tail" in follow-mode on the log file:

     # tail -f /var/log/rhui-client-install[02/05/19 18:35:44] Starting RHUI Client Installation.
    [02/05/19 18:35:44]     Distro: rhel7
    [02/05/19 18:35:44]     URL:
    [02/05/19 18:35:45]     Client RPM: mcp-client-rhel7-3.1-1.noarch.rpm
    [02/05/19 18:35:45]     YUM is not locked.  Continuing install...
    [02/05/19 18:35:46]     Removing old MCP client...(mcp-client-rhel7-3.0-1.noarch)
    [02/05/19 18:35:47]     mcp-client-rhel7-3.0-1.noarch removed successfully
    [02/05/19 18:35:47]     Installing new MCP client...
    [02/05/19 18:35:49]     Rebuilding YUM cache...(This will take about 5 minutes)
    [02/05/19 18:38:06]     Done.
    [02/05/19 18:38:07] MCP Client has been successfully updated.
  4. To verify the process succeeded, simply inspect the MCP Client version:

     # rpm -q mcp-client-rhel7
  5. Notice the MCP client version is now 3.1-1.  This indicates the update/migration was successful.


    It is extremely rare for the migration process to fail; however, if this version number did not change, this indicates something went wrong. Please contact support and provide the details of the /var/log/rhui-client-install log file.  This file contains information necessary to troubleshoot any issue and provide a solution. 

    After successfully upgrading the MCP client, the server will begin receiving RedHat software package content from the RHUI v3 architecture.

Recently Updated