Quick setup steps for fresh Red Hat Update Infrastructure 2.1 installation

Solution Verified - Updated -


  • Red Hat Update Infrastructure 2.1


  • How to setup Red Hat Update Infrastructure 2.1?

  • Quick guide for fresh Red Hat Update Infrastructure 2.1 installation.

  • How to install Red Hat Update Infrastructure 2.1 in an environment.


Below steps are to be followed to setup fresh Red Hat Update Infrastructure 2.1 setup :

  • Go to the below link and click on "Register a RHUI"

  • Enter the profile name and the desired version then click on "Register". Note the "UUID" of the profile created.

  • Click on "Attach a subscription", this will pop-up a list of available subscription. Tick on "Red Hat Update Infrastructure and RHEL Add-Ons for Providers" subscription and click "Attach Selected".

  • Download the "Entitlement Certificate" and "Red Hat Public CA Certificate" which is available for the profile you have just created. Both the certificates can be downloaded from the profile page itself and will be used in later stage of the installation process for which please follow the installation guide.

  • Now come to the RHUA system and run the below command to register the system to the profile. Please use the UUID which you have noted in Step 2.

    # subscription-manager register --type=RHUI --consumerid=UUID
    # subscription-manager list --consumed   // To Confirm whether Red Hat Update Infrastructure subscription is attached or not.
    # subscription-manager repos --disable=*
    # subscription-manager repos --enable=rhel-6-server-rhui-rpms --enable=rhel-x86_64-6-rhui-2-rpms
    # yum repolist
  • Download the RHUI ISO from portal using wget.

  • After downloading the RHUI ISO, please perform the below steps:

    # mount -o loop RHEL-6-RHUI-2-LATEST-Server-x86_64-DVD.iso /media/
    # cd /media/
    # ./install_RHUA.sh

    NOTE : "install_RHUA.sh" will successfully install Red Hat Update Infrastructure Tools packages. Manual installation of any packages are not required.

  • Create the SSL certificates :

    # cd /root/
    # /usr/share/rh-rhua/rhui_certs/create_rhui_ssl_certs.sh  rhua.example.com  cds1.example.com cds2.example.com

    NOTE : "create_rhui_ssl_certs.sh" will create the SSL chains and answers file. Need to enter a passphrase which will be used later as well.

    IMP : If you don't need a proxy, please don't edit the answers file.

  • Execute rhui-installer with the answers file that was created.

    # rhui-installer /root/rhui-certs/answers
  • On RHUA :

    # cd /etc/rhui/
    # rpm -ivh rh-rhua-config-2.1-2.el6.noarch.rpm   <-- this is a sample rpm name
  • Copy the respective CDS configuration RPMS on the respective server.

  • Install the created RPM's on the CDS servers.

    On CDS1 :

    # rpm -ivh rh-cds1-cds1.example.com-config-2.1-2.el6.noarch.rpm

    On CDS2 :

    # rpm -ivh rh-cds2-cds2.example.com-config-2.1-2.el6.noarch.rpm 
  • Execute the rhui-manager and configure it like the first time.

    # rhui-manager 
    An entitlement signing CA certificate is required to use RHUI Tools
    but was not found.
    Full path to the new signing CA certificate:
    Full path to the new signing CA certificate private key:
  • Upload the entitlement certificate which was downloaded from the Red Hat Customer Portal.

    # rhui-manager cert upload --cert /path/to/entitlement_certificate.pem
  • Go to RHUA and run the below and thereafter follow the instructions :

    # rhui-manager -> r -> a -> 3
  • Then enter the repos that needs to be enabled. After that select option "sr" to sync the repos.

  • To get the sysnc status use: "dr"

  • Copy the RHUI installation ISO from RHUA server to the CDS server

  • On CDS server, perform the below to enable the required repository and install CDS.

    # mount -o loop RHEL-6-RHUI-2-LATEST-Server-x86_64-DVD.iso /media/
    # subscription-manager register --auto-attach
    # subscription-manager repos --disable=*
    # subscription-manager repos --enable=rhel-6-server-rpms
    # cd /media/
    # ./install_CDS.sh
  • Install CDS configuration rpm on the respective CDS servers.

    # rpm -ivh rh-cds1.cds1.example.com-config-2.1-2.el6.noarch.rpm
  • Add CDS server on the RHUA using rhui-manager. Follow document.

  • Generate client entitlement certificate and client configuration rpm. Follow document.

  • Install the client configuration RPM's to the client systems.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.


For RHUI 3 I believe steps will be. - ensure all hosts have FQDN set i.e. # hostname; hostname -f should be same

yum remove rhui-installer
rm -rf /etc/puppet/
rm -rf /root/.rhui/
rm -rf /opt/rhui/
yum install rhui-installer
install using FQDN