Installation guide
Slave Satellite.
Figure 6.3. Slave Sa tellit es are ma int aine d e xactly as the mast er Sa te llit e
In this example, the master Satellite (for example, a software or Hardware vendor) provides data to its
customer. These changes are regularly synchronized to slave Satellites.
6.4.2. Configuring the Master RHN Satellite Server
To use the inter-satellite sync feature, you must first ensure that you have it enabled. Make sure that the
/etc/rhn/rhn.conf contains the following line:
disable_iss=0
In the same file is the variable:
allowed_iss_slaves=
By default, no slave Satellites are specified to sync from the master server, s o you must enter the
hostname of each slave Satellite server, separated by commas. For example:
allowed_iss_slaves=slave1.satellite.example.org,slave2.satellite.exam ple.org
Once you finished configuring the rhn.conf file, restart the httpd service by issuing the following
command:
service httpd restart
6.4.3. Configuring the Slave RHN Satellite Servers
To configure RHN Satellite s lave servers for Inter-Satellite Sync, ensure that you have the ORG-SSL
certificate from your master RHN Satellite s erver so you can securely transfer content. This can be
downloaded over http from the /pub/ directory of any Satellite. The file is called RHN-ORG-TRUST ED-
SSL-CERT , but can be renamed and placed anywhere on the slave Satellite, such as the
/usr/share/rhn/ directory.
For information about SSL configuration for use with RHN Satellite, refer to Chapter 3, "SSL
Infrastructure" in the RHN Satellite Client Configuration Guide
Once the SSL certificate is placed on the slave server, you can see the list of channels available to sync
from the master Satellite server by running the following command (replacing the
master.satellite.exam ple.com with the hostname of the master Satellite server):
satellite-sync --iss-parent=master.satellite.exam ple.com --ca-
cert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT --list-channels
This command lists both Red Hat Network Hos ted channels as well as any custom channels available
on the master Satellite server.
6.5. Using Inter-Satellite Sync
Now that Inter-Satellite Sync is configured, you can now us e it to synchronize channels from the master
Satellite to the s lave servers.
On the slave servers, configure the Master server hostname and SSL certificate file path in the following
lines of the /etc/rhn/rhn.conf file:
iss_parent = master.satellite.domain.com
iss_ca_chain = /usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT
Then run the satellite-sync command by typing:
satellite-sync -c your-channel
Note
Any command line options to the satellite-sync command will override any default or
customized settings in the /etc/rhn/rhn.conf file
6.5.1. Syncing between a Development Staging Server and a Production Satellite
There may be instances where an administrator wants to sync data from a staging server that has
custom channels that are ready for production use to a production Satellite s erver.
For example, a production Satellite Server normally syncs directly from RHN Hosted servers for content
updates, but will occasionally sync production-ready information from a RHN Satellite development
server.
Figure 6.4 . Syncing from RHN Hosted and a Sa te llit e St aging Serve r
Normally, the administrator runs:
satellite-sync -c your-channel
This command downloads directly from data from rhn_parent (usually RHN Hosted, rhn.redhat.com).
Then, to sync from the staging Satellite server address , the administrator runs:
Chapter 6. Importing and Synchronizing
27