How can I register Red Hat Enterprise Linux systems via Red Hat Satellite Proxy 5 server?

Solution Verified - Updated

Environment

  • Red Hat Enterprise Linux (RHEL)
  • Red Hat Satellite 5 and Satellite Proxy 5

Issue

  • How to register a RHEL system to Red Hat Satellite Proxy 5?
  • What is the process to subscribe a server to a Red Hat Satellite server through a Red Hat Satellite Proxy 5 server?
  • How can I register Red Hat Enterprise Linux systems to a Red Hat Satellite using Red Hat Proxy 5.x?
  • What is Red Hat Satellite Proxy and what is procedure for RHEL system subscription via Proxy?
  • Got new RHEL Satellite Proxy subscriptions, how I can register to Red Hat Satellite using Proxy 5 server?

Resolution

RHEL 7 NOTE: Red Hat Enterprise Linux 7 is only available through This content is not included.Red Hat Subscription Management tools or via Red Hat Satellite 5.6 or newer. Customers using Red Hat Network (RHN) Classic Hosted or stand-alone Red Hat Satelite Proxy (i.e. without Red Hat Satellite 5.6) cannot access RHEL 7.
*Red Hat Satellite Proxy server ‘Stand-Alone’ references a component of a Red Hat Satellite deployment which is used as a stand-alone (Satellite-less) offering, and as of October 31, 2017 is now end-of-life.

From the RHEL client system, do the following:

  • Edit "serverURL" and "sslCACert" in /etc/sysconfig/rhn/up2date file as follows:

    serverURL=https://<fqdn_or_IP_address_of_RHN_Proxy>/XMLRPC
    sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT
    
  • Copy the CACert from the Red Hat Satellite Proxy 5 server to the client:

    # curl -O http://<fqdn_or_IP_address_of_RHN_Proxy>/pub/RHN-ORG-TRUSTED-SSL-CERT
    

    Or:

    # wget http://<fqdn_or_IP_address_of_RHN_Proxy>/pub/RHN-ORG-TRUSTED-SSL-CERT
    
  • Or install the CA SSL public certificate RPM. For example, if it resides in the /pub directory of Red Hat Satellite Proxy 5 server, it can be installed on a client system directly:

    # rpm -Uvh http://<fqdn_or_IP_address_of_RHN_Proxy>/pub/rhn-org-trusted-ssl-cert-VER-REL.noarch.rpm
    
  • Confirm the actual name of the certificate or RPM before running these commands. For detailed information, please refer to
    Deploying the CA SSL Public Certificate to Clients

  • Copy the CA certificate to /usr/share/rhn/ with permission as below:

    -rw-r--r--.   1 root root  5245 Dec 11 15:09 RHN-ORG-TRUSTED-SSL-CERT
    
  • Register the system

    # rhn_register
    

For yum use the proxy please use following configuration

Add the following configuration to /etc/yum.conf

# The proxy server - proxy server:port number
proxy=http://proxy.mydomain.com:3128
# The account details for yum connections
proxy_username=proxy-user
proxy_password=password

RHEL Systems Registration Guide

  • This document is part of a collection covering RHEL System Registration.
    • If this is not the right solution for your registration needs or;
    • If you wish to make a different registration choice;

Red Hat Labs Registration Assistant


We also have an online tool to assist you in selecting the most appropriate registration technology for your system. If you would prefer to use this tool, please visit [https://access.redhat.com/labs/registrationassistant/](https://access.redhat.com/labs/registrationassistant/).
SBR
Category

This solution has been reviewed for technical accuracy, optimized for search, and integrated with Product Documentation and/or Red Hat Access Labs. Much like when a software package is accepted upstream, this content has moved from the general KCS editing workflow into the responsibility of Customer Content Services as maintainers.