Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 6. Setting up RHUA nodes

To access the RHUI interface and manage various RHUI functionalities, you must first set up the RHUA node.

The following process explains how to:

Important

The following procedures assume that your CCSP account uses Simple Content Access (SCA). If that is not the case, refer to Appendix A, Using Entitlement Mode instead.

6.1. Registering the RHUA node
Copy link

The following instructions explain how to register your Red Hat Update Appliance (RHUA) node.

Prerequisites

  • Latest version of RHEL 8 is installed.
  • Ensure you have root access to the RHUA node.

Procedure

  1. Optional: Enable all the required architectures.

    By default, only the architecture on which the RHUA node is running, for example, x86_64, will be available in the RHUI content listings. However, if you want to provide content to ARM64 virtual machines (VMs), in addition to x86_64 VMs, then you must enable the respective architecture.

    Note

    You must enable the required architectures before you register the RHUA node. If you have already registered the node, see Section 6.3, “Including required architectures on a registered and already installed RHUA node”.

    To enable architectures on an unregistered RHUA node, create a override.facts file and add the required architectures. 

    # echo '{ "supported_architectures": "x86_64,i386,aarch64" }' > /etc/rhsm/facts/override.facts

  2. On the RHUA node, enter the following command to register the system: 

    # subscription-manager register --type=rhui

    Type your CCSP user name and password when prompted.

  3. Optional: If your system is already registered, you can override the subscription using the --force option. 

    # subscription-manager register --type=rhui --force

    The new system will be available on the Red Hat Customer Portal, and the new RHUA instance will not have any subscriptions attached to it.

Verification

  1. Navigate to the Red Hat Hybrid Cloud Console.
  2. Verify that your system is available by locating it within the inventory.

To install RHUI on your system, you must first enable certain repositories on your nodes which contain the required packages.

If you are planning to use Ceph File System (CephFS) as your shared storage, you must also enable the rhceph-5-tools-for-rhel-8-x86_64-rhui-rpms repository.

Note

RHUA nodes require RHEL installations with base packages, and with all repositories disabled except for the rhel-8-for-x86_64-baseos-rhui-rpms, rhel-8-for-x86_64-appstream-rhui-rpms, and, optionally, rhceph-5-tools-for-rhel-8-x86_64-rhui-rpms repositories. This requirement means that you cannot install any third-party configurations or software that are not necessary for the direct operation of the server. This restriction includes hardening or other non-Red Hat security software.

Prerequisites

  • Ensure you have root access to the RHUA node.

Procedure

  1. The base RHEL repositories are automatically enabled.

  2. Enable the RHUI 4 repository. 

    # subscription-manager repos --enable rhui-4-for-rhel-8-x86_64-rpms

  3. Optional: If you are planning to use CephFS, enable the Ceph tools repository. 

    # subscription-manager repos --enable rhceph-5-tools-for-rhel-8-x86_64-rhui-rpms
Note

The following procedure is applicable only if you have installed RHUI before but did not enable ARM64 support. Skip it if you are installing RHUI on the RHUA node for the first time and you have completed the procedure above.

Prerequisites

  • Ensure you have root access to the RHUA node.
  • RHUI has been installed without support for ARM64 repositories, but now you want to start supporting them.

Procedure

  1. Create a override.facts file and add the required architectures. 

    # echo '{ "supported_architectures": "x86_64,i386,aarch64" }' > /etc/rhsm/facts/override.facts

  2. Override the subscription using the --force option. 

    # subscription-manager register --type=rhui --force

  3. Delete the current RHUI cert and repository mapping cache. 

    # rm /etc/pki/rhui/redhat/* /var/cache/rhui/*

  4. Enable the RHUI 4 repository again. 

    # subscription-manager repos --enable rhui-4-for-rhel-8-x86_64-rpms

  5. Optional: If you were using CephFS, enable the Ceph tools repository again. 

    # subscription-manager repos --enable rhceph-5-tools-for-rhel-8-x86_64-rhui-rpms

  6. Synchronize the subscription. 

    # rhui-subscription-sync
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top