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: Register the RHUA node Enable the required repositories on the RHUA node Include additional architectures on a registered RHUA node 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 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 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. On the RHUA node, enter the following command to register the system: Type your CCSP user name and password when prompted. Optional: If your system is already registered, you can override the subscription using the --force option. 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 Navigate to the Red Hat Hybrid Cloud Console . Verify that your system is available by locating it within the inventory. 6.2. Enabling the required repositories on the RHUA node 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 The base RHEL repositories are automatically enabled. Enable the RHUI 4 repository. Optional: If you are planning to use CephFS, enable the Ceph tools repository. 6.3. Including required architectures on a registered and already installed RHUA node 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 Create a override.facts file and add the required architectures. Override the subscription using the --force option. Delete the current RHUI cert and repository mapping cache. Enable the RHUI 4 repository again. Optional : If you were using CephFS, enable the Ceph tools repository again. Synchronize the subscription.

Commands:
echo '{ "supported_architectures": "x86_64,i386,aarch64" }' > /etc/rhsm/facts/override.facts
subscription-manager register --type=rhui
subscription-manager register --type=rhui --force
subscription-manager repos --enable rhui-4-for-rhel-8-x86_64-rpms
subscription-manager repos --enable rhceph-5-tools-for-rhel-8-x86_64-rhui-rpms
echo '{ "supported_architectures": "x86_64,i386,aarch64" }' > /etc/rhsm/facts/override.facts
subscription-manager register --type=rhui --force
rm /etc/pki/rhui/redhat/* /var/cache/rhui/ *
subscription-manager repos --enable rhui-4-for-rhel-8-x86_64-rpms
subscription-manager repos --enable rhceph-5-tools-for-rhel-8-x86_64-rhui-rpms
rhui-subscription-sync