Appendix A. Using Entitlement Mode
Simple Content Access (SCA) is now the default mode for subscription management. Should your CCSP account still use the old entitlement mode, take the following steps to make sure your RHUI nodes are subscribed correctly; otherwise, you would not be able to install RHUI RPM packages on them.
A.1. Registering the RHUA node Copy linkLink copied to clipboard!
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.
NoteYou 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.factsfile and add the required architectures.# echo '{ "supported_architectures": "x86_64,i386,aarch64" }' > /etc/rhsm/facts/override.factsOn the RHUA node, enter the following command to register the system:
# subscription-manager register --type=rhuiType your CCSP user name and password when prompted.
Optional: If your system is already registered, you can override the subscription using the
--forceoption.# subscription-manager register --type=rhui --forceThe 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.
A.2. Registering the CDS node Copy linkLink copied to clipboard!
The following instructions explain how to register your Content Delivery Server (CDS) nodes.
On the CDS nodes you do not need to use the --type=rhui flag that was required on the RHUA node.
Prerequisites
- Latest version of RHEL 8 is installed.
- Ensure you have root access to each of the CDS nodes.
Procedure
On the CDS nodes, enter the following command:
# subscription-manager registerType your CCSP user name and password when prompted.
Optional: If your system is already registered, you can override the subscription using the
--forceoption.# subscription-manager register --forceThe new system will be available on the Red Hat Customer Portal, and the new CDS 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.
A.3. Registering the HAProxy node Copy linkLink copied to clipboard!
The following instructions explain how to register your HAProxy nodes.
On the HAProxy node you do not need to use the --type=rhui flag that was required on the RHUA node.
Prerequisites
- Latest version of RHEL 8 is installed.
- Ensure you have root access to the HAProxy nodes.
Procedure
On the HAProxy node, enter the following command:
# subscription-manager registerType your CCSP user name and password when prompted.
Optional: If your system is already registered, you can override the subscription using the
--forceoption.# subscription-manager register --forceThe new system will be available on the Red Hat Customer Portal, and the new HAProxy 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.
A.4. Attaching a subscription to the RHUA node Copy linkLink copied to clipboard!
The following instructions explain how to attach a subscription to your Red Hat Update Appliance (RHUA) node.
Prerequisites
- Ensure you have root access to the RHUA node.
Procedure
On the RHUA node, check for available subscriptions that you can attach.
# subscription-manager list --available +-------------------------------------------+ Available Subscriptions +-------------------------------------------+ Subscription Name: Red Hat Enterprise Linux Atomic Host for Certified Cloud and Service Providers (via Red Hat Update Infrastructure) Provides: Red Hat Enterprise Linux Atomic Host Beta from RHUI Red Hat Enterprise Linux Atomic Host from RHUI SKU: RH00731 Contract: 11312089 Pool ID: 8a85f15a71f0bd015a72445adf0223 Provides Management: No Available: 19 Suggested: 1 Service Level: Premium Service Type: L1-L3 Subscription Type: Standard Ends: 02/22/2018 System Type: Physical Subscription Name: Red Hat Update Infrastructure and RHEL Add-Ons for Providers Provides: dotNET on RHEL (for RHEL Server) from RHUI Red Hat Enterprise Linux Server from RHUI Red Hat Software Collections (for RHEL Server) from RHUI Red Hat Enterprise Linux for SAP from RHUI Red Hat Enterprise Linux Resilient Storage (for RHEL Server) from RHUI Red Hat Enterprise Linux Scalable File System (for RHEL Server) from RHUI Red Hat Enterprise Linux Server - Extended Update Support from RHUI dotNET on RHEL Beta (for RHEL Server) from RHUI Red Hat Enterprise Linux for SAP Hana from RHUI RHEL Software Test Suite (for RHEL Server) from RHUI Red Hat Enterprise Linux High Availability (for RHEL Server) from RHUI Red Hat Update Infrastructure Red Hat Enterprise Linux Load Balancer (for RHEL Server) from RHUI SKU: RC1116415 Contract: 1134314 Pool ID: 8a85f15a71f0bd015a72445adf0223 Provides Management: No Available: 20 Suggested: 1 Service Level: Premium Service Type: L1-L3 Subscription Type: Standard Ends: 02/23/2018 System Type: PhysicalAttach a subscription using its
pool ID.For example, the following command attaches the Red Hat Update Infrastructure and RHEL Add-Ons for Providers subscription.
# subscription-manager attach --pool=8a85f9815a71f0bd015a72445adf0223 Successfully attached a subscription for: Red Hat Update Infrastructure and RHEL Add-Ons for Providers
A.5. Attaching a subscription to the CDS node Copy linkLink copied to clipboard!
The following instructions explain how to attach a subscription to your content delivery server (CDS) node.
Prerequisites
- Ensure you have root access to the CDS node.
Procedure
On the CDS node, check for available subscriptions that you can attach.
# subscription-manager list --available +-------------------------------------------+ Available Subscriptions +-------------------------------------------+ ... Subscription Name: <Subscription-Name> Pool ID: <pool-ID> ...Attach a subscription using its
pool ID.# subscription-manager attach --pool=<pool-ID> Successfully attached a subscription for: <Subscription-Name>
A.6. Attaching a subscription to the HAProxy node Copy linkLink copied to clipboard!
The following instructions explain how to attach a subscription to your HAProxy node.
Prerequisites
- Ensure you have root access to the HAProxy node.
Procedure
On the HAProxy node, check for available subscriptions that you can attach.
# subscription-manager list --available +-------------------------------------------+ Available Subscriptions +-------------------------------------------+ ... Subscription Name: <Subscription-Name> Pool ID: <pool-ID> ...Attach a subscription using its
pool ID.# subscription-manager attach --pool=<pool-ID> Successfully attached a subscription for: <Subscription-Name>
A.7. Enabling the required repositories on the RHUA node Copy linkLink copied to clipboard!
To install RHUI on your system, you must first enable certain repositories on your nodes which contain the required packages. The following instructions explain how to enable the rhel-8-for-x86_64-baseos-rhui-rpms and rhel-8-for-x86_64-appstream-rhui-rpms repositories on the RHUA node.
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.
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
Navigate to the RHUA node, list the enabled repositories, and verify that your system is correctly subscribed.
# subscription-manager list --consumed +-------------------------------------------+ Consumed Subscriptions +-------------------------------------------+ Subscription Name: Red Hat Update Infrastructure and RHEL Add-Ons for Providers Provides: JBoss Enterprise Application Platform from RHUI JBoss Enterprise Web Server from RHUI JBoss Operations Network from RHUI RHEL for SAP - Update Services for SAP Solutions from RHUI Red Hat Developer Tools from RHUI (for RHEL Server) Red Hat Enterprise Linux Server - Extended Update Support from RHUI RHEL for SAP HANA - Update Services for SAP Solutions from RHUI Red Hat Developer Tools Beta from RHUI (for RHEL Server) Red Hat Enterprise Linux High Availability (for RHEL Server) from RHUI Red Hat JBoss Core Services from RHUI Red Hat Enterprise Linux for x86_64 from RHUI Red Hat Enterprise Linux for x86_64 Beta from RHUI Red Hat Enterprise Linux Load Balancer (for RHEL Server) from RHUI Red Hat Enterprise Linux Resilient Storage (for RHEL Server) from RHUI Red Hat Enterprise Linux Scalable File System (for RHEL Server) from RHUI Red Hat Enterprise Linux High Performance Networking (for RHEL Server) from RHUI Red Hat Enterprise Linux for SAP from RHUI Red Hat CodeReady Linux Builder for x86_64 from RHUI Red Hat Enterprise Linux for SAP Hana from RHUI Red Hat CodeReady Linux Builder for ARM 64 from RHUI RHEL Software Test Suite (for RHEL Server) from RHUI Red Hat Gluster Storage Server for On-premise from RHUI Red Hat Single Sign-On from RHUI Red Hat Enterprise Linux High Availability for x86_64 from RHUI Red Hat Enterprise Linux Resilient Storage for x86_64 from RHUI Red Hat Enterprise Linux High Availability (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux Server - Extended Life Cycle Support (from RHUI) Red Hat Enterprise Linux Load Balancer (for RHEL Server) - Extended Update Support from RHUI RHEL for SAP HANA - Extended Update Support (from RHUI) RHEL for SAP - Extended Update Support (from RHUI) Red Hat Enterprise Linux Resilient Storage (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux High Performance Networking (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux for ARM 64 from RHUI Red Hat Enterprise Linux Server - Update Services for SAP Solutions from RHUI Red Hat Software Collections (for RHEL Server) from RHUI Red Hat Enterprise Linux Server for ARM from RHUI Red Hat Enterprise Linux High Availability - Update Services for SAP Solutions from RHUI Red Hat CodeReady Linux Builder for x86_64 - Extended Update Support from RHUI Red Hat Software Collections (for RHEL Server for ARM) from RHUI Red Hat Ansible Engine from RHUI Red Hat Software Collections Beta (for RHEL Server for ARM) from RHUI Red Hat Enterprise Linux for ARM 64 Beta from RHUI Red Hat Developer Tools (for RHEL Server for ARM) from RHUI Red Hat Developer Tools Beta (for RHEL Server for ARM) from RHUI dotNET on RHEL (for RHEL Server) from RHUI dotNET on RHEL Beta (for RHEL Server) from RHUI Red Hat Update Infrastructure Red Hat Enterprise Linux Server from RHUI SKU: RC11164 Contract: 126839 Account: 5401 Serial: 5744492009337488 Pool ID: 8a85f9a1790fb0ed017961af515b7 Provides Management: No Active: True Quantity Used: 1 Service Type: L1-L3 Roles: Service Level: Premium Usage: Add-ons: Status Details: Subscription is current Subscription Type: Standard Starts: 05/12/2021 Ends: 05/11/2022 Entitlement Type: Physical ---------------------------------------------------------------------------------Disable all repositories.
# subscription-manager repos --disable=*Enable the relevant repositories.
# subscription-manager repos --enable=rhel-8-for-x86_64-baseos-rhui-rpms --enable=rhel-8-for-x86_64-appstream-rhui-rpmsOptional: 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-rpmsEnable the RHUI 4 repository.
# subscription-manager repos --enable=rhui-4-for-rhel-8-x86_64-rpms
A.8. Enabling the required repositories on the CDS node Copy linkLink copied to clipboard!
To install RHUI on your system, you must first enable certain repositories on your nodes which contain the required packages. The following instructions explain how to enable the rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms repositories on the CDS node.
If you are planning to use Ceph File System (CephFS) as your shared storage, then you must also enable the rhceph-5-tools-for-rhel-8-x86_64-rpms repository.
CDS nodes require RHEL installations with base packages and with all repositories disabled except for the rhel-8-for-x86_64-baseos-rpms, rhel-8-for-x86_64-appstream-rpms, and, optionally, rhceph-5-tools-for-rhel-8-x86_64-rpms repositories. This requirement means that you cannot install any third-party configurations or softwares that are not necessary for the direct operation of the server. This restriction includes hardening or other non-Red Hat security software.
Prerequisites
- Ensure that you have root access to all the CDS nodes you plan to use.
Procedure
Navigate to a CDS node, list the enabled repositories, and verify that your system is correctly subscribed.
# subscription-manager list --consumed +-------------------------------------------+ Consumed Subscriptions +-------------------------------------------+ Subscription Name: Red Hat Update Infrastructure and RHEL Add-Ons for Providers Provides: JBoss Enterprise Application Platform from RHUI JBoss Enterprise Web Server from RHUI JBoss Operations Network from RHUI RHEL for SAP - Update Services for SAP Solutions from RHUI Red Hat Developer Tools from RHUI (for RHEL Server) Red Hat Enterprise Linux Server - Extended Update Support from RHUI RHEL for SAP HANA - Update Services for SAP Solutions from RHUI Red Hat Developer Tools Beta from RHUI (for RHEL Server) Red Hat Enterprise Linux High Availability (for RHEL Server) from RHUI Red Hat JBoss Core Services from RHUI Red Hat Enterprise Linux for x86_64 from RHUI Red Hat Enterprise Linux for x86_64 Beta from RHUI Red Hat Enterprise Linux Load Balancer (for RHEL Server) from RHUI Red Hat Enterprise Linux Resilient Storage (for RHEL Server) from RHUI Red Hat Enterprise Linux Scalable File System (for RHEL Server) from RHUI Red Hat Enterprise Linux High Performance Networking (for RHEL Server) from RHUI Red Hat Enterprise Linux for SAP from RHUI Red Hat CodeReady Linux Builder for x86_64 from RHUI Red Hat Enterprise Linux for SAP Hana from RHUI Red Hat CodeReady Linux Builder for ARM 64 from RHUI RHEL Software Test Suite (for RHEL Server) from RHUI Red Hat Gluster Storage Server for On-premise from RHUI Red Hat Single Sign-On from RHUI Red Hat Enterprise Linux High Availability for x86_64 from RHUI Red Hat Enterprise Linux Resilient Storage for x86_64 from RHUI Red Hat Enterprise Linux High Availability (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux Server - Extended Life Cycle Support (from RHUI) Red Hat Enterprise Linux Load Balancer (for RHEL Server) - Extended Update Support from RHUI RHEL for SAP HANA - Extended Update Support (from RHUI) RHEL for SAP - Extended Update Support (from RHUI) Red Hat Enterprise Linux Resilient Storage (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux High Performance Networking (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux for ARM 64 from RHUI Red Hat Enterprise Linux Server - Update Services for SAP Solutions from RHUI Red Hat Software Collections (for RHEL Server) from RHUI Red Hat Enterprise Linux Server for ARM from RHUI Red Hat Enterprise Linux High Availability - Update Services for SAP Solutions from RHUI Red Hat CodeReady Linux Builder for x86_64 - Extended Update Support from RHUI Red Hat Software Collections (for RHEL Server for ARM) from RHUI Red Hat Ansible Engine from RHUI Red Hat Software Collections Beta (for RHEL Server for ARM) from RHUI Red Hat Enterprise Linux for ARM 64 Beta from RHUI Red Hat Developer Tools (for RHEL Server for ARM) from RHUI Red Hat Developer Tools Beta (for RHEL Server for ARM) from RHUI dotNET on RHEL (for RHEL Server) from RHUI dotNET on RHEL Beta (for RHEL Server) from RHUI Red Hat Update Infrastructure Red Hat Enterprise Linux Server from RHUI SKU: RC11164 Contract: 126839 Account: 5401 Serial: 5744492009337488 Pool ID: 8a85f9a1790fb0ed017961af515b7 Provides Management: No Active: True Quantity Used: 1 Service Type: L1-L3 Roles: Service Level: Premium Usage: Add-ons: Status Details: Subscription is current Subscription Type: Standard Starts: 05/12/2021 Ends: 05/11/2022 Entitlement Type: Physical ---------------------------------------------------------------------------------Disable all repositories.
# subscription-manager repos --disable=*Enable the relevant repositories.
# subscription-manager repos --enable rhel-8-for-x86_64-appstream-rpms --enable rhel-8-for-x86_64-baseos-rpmsOptional: If you are planning to use CephFS, enable the Ceph tools repository.
# subscription-manager repos --enable rhceph-5-tools-for-rhel-8-x86_64-rpms- Repeat the steps on all the CDS nodes you plan to use.
Verification
List the enabled repositories and verify whether the relevant repositories appear on the list.
# yum repolist enabled Updating Subscription Management repositories. repo id repo name rhel-8-for-x86_64-appstream-rpms Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) rhel-8-for-x86_64-baseos-rpms Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
A.9. Enabling the required repositories on the HAProxy node Copy linkLink copied to clipboard!
To install RHUI on your system, you must first enable certain repositories on your nodes which contain the required packages. The following instructions explain how to enable the rhel-8-for-x86_64-baseos-rpms and rhel-8-for-x86_64-appstream-rpms repositories on the HAProxy node.
Prerequisites
- Ensure you have root access to the HAProxy node.
Procedure
Navigate to a HAProxy node, list the enabled repositories, and verify that your system is correctly subscribed.
# subscription-manager list --consumed +-------------------------------------------+ Consumed Subscriptions +-------------------------------------------+ Subscription Name: Red Hat Update Infrastructure and RHEL Add-Ons for Providers Provides: JBoss Enterprise Application Platform from RHUI JBoss Enterprise Web Server from RHUI JBoss Operations Network from RHUI RHEL for SAP - Update Services for SAP Solutions from RHUI Red Hat Developer Tools from RHUI (for RHEL Server) Red Hat Enterprise Linux Server - Extended Update Support from RHUI RHEL for SAP HANA - Update Services for SAP Solutions from RHUI Red Hat Developer Tools Beta from RHUI (for RHEL Server) Red Hat Enterprise Linux High Availability (for RHEL Server) from RHUI Red Hat JBoss Core Services from RHUI Red Hat Enterprise Linux for x86_64 from RHUI Red Hat Enterprise Linux for x86_64 Beta from RHUI Red Hat Enterprise Linux Load Balancer (for RHEL Server) from RHUI Red Hat Enterprise Linux Resilient Storage (for RHEL Server) from RHUI Red Hat Enterprise Linux Scalable File System (for RHEL Server) from RHUI Red Hat Enterprise Linux High Performance Networking (for RHEL Server) from RHUI Red Hat Enterprise Linux for SAP from RHUI Red Hat CodeReady Linux Builder for x86_64 from RHUI Red Hat Enterprise Linux for SAP Hana from RHUI Red Hat CodeReady Linux Builder for ARM 64 from RHUI RHEL Software Test Suite (for RHEL Server) from RHUI Red Hat Gluster Storage Server for On-premise from RHUI Red Hat Single Sign-On from RHUI Red Hat Enterprise Linux High Availability for x86_64 from RHUI Red Hat Enterprise Linux Resilient Storage for x86_64 from RHUI Red Hat Enterprise Linux High Availability (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux Server - Extended Life Cycle Support (from RHUI) Red Hat Enterprise Linux Load Balancer (for RHEL Server) - Extended Update Support from RHUI RHEL for SAP HANA - Extended Update Support (from RHUI) RHEL for SAP - Extended Update Support (from RHUI) Red Hat Enterprise Linux Resilient Storage (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux High Performance Networking (for RHEL Server) - Extended Update Support from RHUI Red Hat Enterprise Linux for ARM 64 from RHUI Red Hat Enterprise Linux Server - Update Services for SAP Solutions from RHUI Red Hat Software Collections (for RHEL Server) from RHUI Red Hat Enterprise Linux Server for ARM from RHUI Red Hat Enterprise Linux High Availability - Update Services for SAP Solutions from RHUI Red Hat CodeReady Linux Builder for x86_64 - Extended Update Support from RHUI Red Hat Software Collections (for RHEL Server for ARM) from RHUI Red Hat Ansible Engine from RHUI Red Hat Software Collections Beta (for RHEL Server for ARM) from RHUI Red Hat Enterprise Linux for ARM 64 Beta from RHUI Red Hat Developer Tools (for RHEL Server for ARM) from RHUI Red Hat Developer Tools Beta (for RHEL Server for ARM) from RHUI dotNET on RHEL (for RHEL Server) from RHUI dotNET on RHEL Beta (for RHEL Server) from RHUI Red Hat Update Infrastructure Red Hat Enterprise Linux Server from RHUI SKU: RC11164 Contract: 126839 Account: 5401 Serial: 5744492009337488 Pool ID: 8a85f9a1790fb0ed017961af515b7 Provides Management: No Active: True Quantity Used: 1 Service Type: L1-L3 Roles: Service Level: Premium Usage: Add-ons: Status Details: Subscription is current Subscription Type: Standard Starts: 05/12/2021 Ends: 05/11/2022 Entitlement Type: Physical ---------------------------------------------------------------------------------Disable all repositories.
# subscription-manager repos --disable=*Enable the relevant repositories.
# subscription-manager repos --enable rhel-8-for-x86_64-appstream-rpms --enable rhel-8-for-x86_64-baseos-rpms
Verification
List the enabled repositories and verify whether the relevant repositories appear on the list.
# yum repolist enabled Updating Subscription Management repositories. repo id repo name rhel-8-for-x86_64-appstream-rpms Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs) rhel-8-for-x86_64-baseos-rpms Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
Having followed these procedures, continue reading at Chapter 9, Generating a cryptographic key pair.