Red Hat Training

A Red Hat training course is available for Red Hat Satellite

5.2. Adding CNAME Records to the Satellite Proxy Server Configuration

This section describes how to add your Satellite Proxy server's CNAME records to the Satellite Proxy server configuration, and have those CNAMEs recognized as valid options within the Satellite Proxy web interface.

Note

This document does not cover how to set up DNS CNAME records for the machine where your Satellite Proxy server is installed. Contact your system or DNS administrator to ensure the required CNAME records are correctly set up.

Procedure 5.1. To Configure Your Satellite Proxy Server to Use CNAME Records:

  1. Determine the system ID of your proxy server. You can find this value in the /etc/sysconfig/rhn/systemid file on your proxy server. Locate the following stanza in this file (your system ID will be different from this example): 
    <member>
<name>system_id</name>
<value><string>ID-1036997498</string></value>
</member>
    The system ID is contained within <string> tags. Do not include "ID-" as part of the actual system ID.
  2. Add the following line to the /etc/rhn/rhn.conf file. Replace systemID with the value from the previous step: 
    valid_cnames_sytemID= cname1,cname2,cname3
  3. Run the following command to restart the Tomcat service: 
    # service rhn-proxy restart
After the Tomcat service has restarted, refresh the Satellite Proxy server web interface and you should see the CNAMEs listed on the Hardware tab of the System Details page.
Before you can use these CNAMEs, however, you need to create a new set of certificates, and configure the Satellite Proxy to use these certificates. This is because the original certificate is only valid for the canonical host name; you need to create new certificates that are valid for each CNAME. This is covered in Section 5.3, “Generating and Using Multi-host SSL Certificates”.