Installation guide

Chapter 5. Configuring Satellite Proxy to Use CNAME Records

One of the features of Red Hat Satellite Proxy is the ability to take advantage of CNAME records, or

aliases, instead of the canonical host name. This feature is useful if there are network issues that

prevent communication with Red Hat Satellite Proxy using its normal host name or configuration.

5.1. Prerequisit es

To use CNAME records with your Red Hat Satellite Proxy Server installation, you need to:

Ensure that the required CNAME records have been configured for the server.

Add the CNAME records to the Satellite Proxy server configuration.

Create a new multi-host certificate and install it on the Satellite Proxy.

5.2. Adding CNAME Records t o t he Sat ellit e Proxy Server

Configurat ion

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.

Pro ced u re 5.1. T o Co n f igu re Yo u r Sat ellite Proxy Server t o U se CN AME R ecord s:

1. Determine the system ID of your proxy server. You can find this value in the

/etc/sysco nfi g /rhn/systemi d file on your proxy server. Locate the following stanza in

this file (your system ID will be different from this example):

<name>system_id</name>

</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. co nf 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

Red Hat Sat ellit e 5.7 Proxy In st allat ion G uide