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

  1. Navigate to the node on which you wish to install RHEL.

  2. 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

  1. Navigate to the Red Hat Customer Portal.
  2. 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

  1. 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

  2. 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.

Note

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

  1. 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>
...

  2. 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.

Note

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

  1. 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>
...

  2. Attach a subscription using its pool ID. 

    # subscription-manager attach --pool=<pool-ID>
Successfully attached a subscription for: <Subscription-Name>