Chapter 3. Registering your system and attaching subscriptions
To use RHUI efficiently and gain access to Red Hat repositories and support, you must register RHUI and attach the relevant subscriptions to your RHUA, CDS, and HAProxy nodes.
3.1. Installing Red Hat Enterprise Linux
To register and attach the subscriptions to your nodes, you must install Red Hat Enterprise Linux (RHEL) on each of them.
Procedure
- Navigate to the node on which you wish to install RHEL.
Install RHEL.
For detailed instructions on how to install RHEL, see Performing a standard RHEL installation.
3.2. Registering nodes
To use RHUI on your system, you must register each node with Red Hat.
Procedure
On the RHUA node, enter the following command to register the system:
# subscription-manager register --type=rhui --username <admin-example> --password <secret> Registering to: subscription.rhsm.redhat.com:443/subscription The system has been registered with ID: <a12b34c5-6d78-9ef1-2345-ghi678jk91l2m>
On the CDS and HAProxy nodes, enter the following command:
# subscription-manager register --username <admin-example> --password <secret> Registering to: subscription.rhsm.redhat.com:443/subscription The system has been registered with ID: <a1b2c3-d4e5-f6g7-2345-hij890klm123>
Optional: If your system is already registered, you can override the subscription using the
--force
option.# subscription-manager register --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
- Navigate to the Red Hat Customer Portal.
- Verify that your system is available by locating it within the Customer Portal.
3.3. Attaching a subscription to the RHUA node
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: 8a85f9815a6c4c9d015a6c6acb373ed9 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: 11314314 Pool ID: 8a85f9815a71f0bd015a72445adf0223 Provides Management: No Available: 20 Suggested: 1 Service Level: Premium Service Type: L1-L3 Subscription Type: Standard Ends: 02/23/2018 System Type: Physical
Attach 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
3.4. Attaching a subscription to the CDS node
The following instructions explain how to attach a subscription to your content delivery server (CDS) node.
You do not need to perform the following steps if you are using Simple Content Access.
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>
3.5. Attaching a subscription to the HAProxy node
The following instructions explain how to attach a subscription to your HAProxy node.
You do not need to perform the following steps if you are using Simple Content Access.
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>