Red Hat Satellite 5.6

Installation Guide

Configuring, registering, and updating Red Hat Satellite Server

Edition 1

John Ha

Red Hat Engineering Content Services

Lana Brindley

Red Hat Engineering Content Services

Daniel Macpherson

Red Hat Engineering Content Services

Athene Chan

Red Hat Engineering Content Services

David O'Brien

Red Hat Engineering Content Services

Legal Notice

Copyright © 2013 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
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.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.


This guide provides requirements and instructions for installation and initial configuration of Red Hat Satellite.
1. About This Guide
2. Audience
3. Document Conventions
3.1. Typographic Conventions
3.2. Pull-quote Conventions
3.3. Notes and Warnings
4. Getting Help and Giving Feedback
4.1. Do You Need Help?
4.2. We Need Feedback!
1. Introduction
1.1. About Red Hat Satellite
1.2. System Overview
1.3. Terms to Understand
1.4. Summary of Steps
2. Requirements
2.1. Software Requirements
2.2. Red Hat Satellite Server Requirements
2.2.1. x86_64 Hardware Requirements
2.2.2. s/390x Hardware Requirements
2.3. Database Requirements
2.3.1. Database Sizing Requirements
2.3.2. Managed Database Requirements
2.3.3. External Database Requirements
2.4. Additional Requirements
2.4.1. Firewall
2.4.2. File Permissions
2.4.3. SELinux Policy
2.4.4. Caching
2.4.5. DMZ Proxy Solution
2.4.6. Synchronized System Times
2.4.7. Setting System Language and Locale
2.4.8. Fully Qualified Domain Name (FQDN)
2.4.9. Functioning Domain Name Service (DNS)
2.4.10. Entitlement Certificate
2.4.11. Red Hat Network Account
2.4.12. Backups of Login Information
2.4.13. Channel Content ISOs
2.4.14. Service Access
3. Installation
3.1. Prerequisites
3.1.1. Base Operation System
3.1.2. Mounting the Installation Media
3.1.3. Obtaining an Entitlement Certificate
3.2. Pre-Installation
3.2.1. Options for the Installation Script
3.2.2. Automated Red Hat Satellite Server Installation
3.2.3. Installing Behind a HTTP Proxy: Pre-Configuration
3.3. Installation Script Process
3.3.1. Running the Installer Script
3.3.2. Database Configuration
3.3.3. Initial Configuration
3.3.4. Entitlement Certificate Configuration
3.3.5. CA Certificate Configuration
3.4. Post-Installation
3.4.1. Installing Behind a HTTP Proxy: Post-Configuration
3.4.2. Create Administrator User
3.4.3. Finalize Configuration
3.4.4. Organizations
3.4.5. Restart
3.4.6. Cobbler Rebuild
3.4.7. Message Transfer Agent (MTA) Configuration
3.4.8. MySQL Installation for Monitoring
4. Entitlements
4.1. Red Hat Satellite Activate
4.2. Activate Red Hat Satellite with a New Entitlement Certificate
4.3. Entitlement Certificate Expiration
4.4. Enhanced Entitlements Reporting
4.4.1. Enhanced Entitlements Reporting Requirements
4.4.2. Summary of Enhanced Entitlement Reporting Configuration
4.4.3. Configuring Servers for Enhanced Entitlements Reporting
4.4.4. Downloading an Enhanced Entitlements Subscription Manifest
4.4.5. Uploading a Subscription Manifest to Subscription Asset Manager
4.4.6. Splitting Subscriptions between Organizations
4.4.7. Viewing Enhanced Entitlements Reports in Subscription Asset Manager
5. Content and Synchronization
5.1. Red Hat Satellite Synchronization Tool
5.2. Synchronization with Local Media
5.2.1. Preparing for Import from Local Media
5.2.2. Import from Local Media
5.3. Synchronization via Export
5.3.1. Performing an Export
5.3.2. Moving Exported Data
5.3.3. Performing an Import
5.4. Synchronization with Red Hat Network
6. Upgrades
6.1. Upgrade Requirements
6.2. Upgrading Red Hat Satellite to a New Version
7. Maintenance
7.1. Managing Red Hat Satellite with rhn-satellite
7.2. Performing Critical Updates to the Server
7.3. Changing the Red Hat Satellite Hostname
7.4. Conducting Red Hat Satellite-Specific Tasks
7.4.1. Deleting Users
7.4.2. Configuring Red Hat Satellite Search
7.5. Automating Synchronization
7.6. Implementing PAM Authentication
7.7. Enabling Push to Clients
A. Example Red Hat Satellite Installation Topologies
A.1. Single Red Hat Satellite Topology
A.2. Multiple Red Hat Satellite Horizontally Tiered Topology
A.3. Red Hat Satellite-to-Proxy Vertically Tiered Topology
B. Sample Red Hat Satellite Configuration File
C. Revision History