Product SiteDocumentation Site

Red Hat Network Satellite 5.3.0

Installation Guide

Red Hat Network Satellite

Edition 2


Legal Notice

Copyright © 2010 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
All other trademarks are the property of their respective owners.


1801 Varsity Drive
RaleighNC 27606-2072 USA
Phone: +1 919 754 3700
Phone: 888 733 4281
Fax: +1 919 754 3701
PO Box 13588 Research Triangle ParkNC 27709 USA


1. Introduction
1.1. Red Hat Network
1.2. RHN Satellite
1.3. Terms to Understand
1.4. How it Works
1.5. Summary of Steps
1.6. Upgrades
1.6.1. Satellite Certificate
1.6.2. Satellite Upgrade Documentation Package (rhn-upgrade)
1.6.3. New Installation ISO
2. Requirements
2.1. Software Requirements
2.2. Hardware Requirements
2.2.1. x86 and x86_64 Hardware Requirements
2.2.2. s/390 Hardware Requirements
2.2.3. Additional Requirements
2.3. Database Requirements
2.4. Additional Requirements
3. Example Topologies
3.1. Single Satellite Topology
3.2. Multiple Satellite Horizontally Tiered Topology
3.3. Satellite-Proxy Vertically Tiered Topology
4. Installation
4.1. Base Install
4.2. RHN Satellite Installation Program
4.2.1. Options to the Satellite Installation Program
4.3. Automated RHN Satellite Server Installation
4.4. Sendmail Configuration
4.5. MySQL Installation
5. Entitlements
5.1. Receiving the Certificate
5.2. Uploading the RHN Entitlement Certificate
5.3. Managing the RHN Certificate with RHN Satellite Activate
5.3.1. Command Line Entitlement Options
5.3.2. Activating the Satellite
5.4. Satellite Entitlement Certificate Expiration
6. Importing and Synchronizing
6.1. Exporting with RHN Satellite Exporter
6.1.1. rhn-satellite-exporter
6.1.2. Exporting
6.2. Importing with RHN Satellite Synchronization Tool
6.2.1. satellite-sync
6.2.2. Preparing for Import from Local Media
6.2.3. Running the Import
6.3. Synchronizing
6.3.1. Synchronizing Errata and Packages Directly via RHN
6.3.2. Synchronizing Errata and Packages via Local Media
6.4. Inter-Satellite Sync
6.4.1. Recommended Models for Inter-Satellite Sync
6.4.2. Configuring the Master RHN Satellite Server
6.4.3. Configuring the Slave RHN Satellite Servers
6.5. Using Inter-Satellite Sync
6.5.1. Syncing between a Development Staging Server and a Production Satellite
6.5.2. Bi-directional sync
6.6. Synchronizing by Organization
7. Troubleshooting
7.1. Gathering information with spacewalk-report
7.2. Log Files
7.3. General Problems
7.4. Host Not Found/Could Not Determine FQDN
7.5. Connection Errors
7.6. SELinux Issues
7.7. Updated Software Components
7.8. Satellite Debugging by Red Hat
8. Maintenance
8.1. Managing the Satellite with rhn-satellite
8.2. Updating the Satellite
8.3. Backing Up the Satellite
8.4. Using RHN DB Control
8.4.1. DB Control Options
8.4.2. Backing up the Database
8.4.3. Verifying the Backup
8.4.4. Restoring the Database
8.5. Cloning the Satellite with Embedded DB
8.6. Establishing Redundant Satellites with Stand-Alone DB
8.7. Conducting Satellite-Specific Tasks
8.7.1. Using the Tools menu
8.7.2. Deleting Users
8.8. Automating Synchronization
8.9. Implementing PAM Authentication
8.10. Enabling Push to Clients
A. Sample RHN Satellite Configuration File
B. Revision History
Index