Product SiteDocumentation Site

Red Hat Network Satellite 5.3.0

Reference 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


Introduction to the Guide
1. More to Come
1.1. Send in Your Feedback
1. Red Hat Network Overview
1.1. Update
1.2. Management
1.3. Provisioning
1.4. Monitoring
1.5. Errata Notifications and Scheduled Package Installations
1.6. Security, Quality Assurance, and Red Hat Network
1.7. Before You Begin
2. The rhn_register Client
2.1. Using rhn_register
2.1.1. Command-line version of rhn_register
3. Package Updater
3.1. Using the Package Updater
3.2. The Package Updater Applet
3.3. Updating Packages from the Command Line with yum
3.3.1. yum Commands
4. Red Hat Update Agent
4.1. Starting the Red Hat Update Agent
4.2. Registration
4.2.1. Registering a User Account
4.2.2. Activate
4.2.3. Channels
4.2.4. Packages Flagged to be Skipped
4.2.5. Available Package Updates
4.2.6. Retrieving Packages
4.2.7. Installing Packages
4.3. Command Line Version
4.3.1. Installing the Red Hat GPG key
4.3.2. Manual Package Installation
4.3.3. Synchronizing Your System Profile
4.3.4. Log File
4.4. Configuration
4.4.1. Using the Red Hat Update Agent Configuration Tool
4.4.2. Command Line Version
4.5. Registering with Activation Keys
4.6. Registering a System to an Organization
5. Red Hat Network Daemon
5.1. Configuring
5.2. Viewing Status
5.3. Disabling
5.4. Troubleshooting
6. Red Hat Network Alert Notification Tool
6.1. Configuring the Applet
6.2. Notification Icons
6.3. Viewing Updates
6.4. Applying Updates
6.5. Launching the RHN Website
7. Red Hat Network Website
7.1. Navigation
7.1.1. Entitlement Views
7.1.2. Categories and Pages
7.1.3. Errata Alert Icons
7.1.4. Quick Search
7.1.5. Systems Selected
7.1.6. Lists
7.2. Logging into the RHN Website
7.3. Overview
7.3.1. Your Account
7.3.2. Your Preferences
7.3.3. Locale Preferences
7.3.4. Subscription Management
7.3.5. Organization Trusts
7.4. Systems
7.4.1. Overview —
7.4.2. Systems
7.4.3. System Groups —
7.4.4. System Set Manager —
7.4.5. Advanced Search —
7.4.6. Activation Keys —
7.4.7. Stored Profiles —
7.4.8. Custom System Info —
7.4.9. Kickstart —
7.5. Errata
7.5.1. Relevant Errata
7.5.2. All Errata
7.5.3. Advanced Search
7.6. Channels
7.6.1. Software Channels
7.6.2. Package Search
7.6.3. Manage Software Channels
7.7. Configuration
7.7.1. Preparing Systems for Config Management
7.7.2. Overview
7.7.3. Configuration Channels
7.7.4. Configuration Files
7.7.5. Locally-Managed Files
7.7.6. Systems
7.8. Schedule
7.8.1. Pending Actions
7.8.2. Failed Actions
7.8.3. Completed Actions
7.8.4. Archived Actions
7.8.5. Actions List
7.9. Users —
7.9.1. User List ⇒ Active —
7.9.2. User List ⇒ Deactivated —
7.9.3. User List ⇒ All —
7.10. Monitoring —
7.10.1. Probe Status —
7.10.2. Notification —
7.10.3. Probe Suites
7.10.4. Scout Config Push —
7.10.5. General Config —
7.11. Admin
7.11.1. Admin ⇒ Organizations
7.11.2. Admin ⇒ RHN Satellite Configuration
7.12. Help
7.12.1. Reference Guide
7.12.2. Satellite Installation Guide
7.12.3. Proxy Guide
7.12.4. Client Configuration Guide
7.12.5. Channel Management Guide
7.12.6. Release Notes
7.12.7. API
7.12.8. Search
8. Monitoring
8.1. Prerequisites
8.2. Red Hat Network Monitoring Daemon (rhnmd)
8.2.1. Probes requiring the daemon
8.2.2. Installing the Red Hat Network Monitoring Daemon
8.2.3. Configuring SSH
8.2.4. Installing the SSH key
8.3. mysql package
8.4. Notifications
8.4.1. Creating Notification Methods
8.4.2. Receiving Notifications
8.4.3. Redirecting Notifications
8.4.4. Filtering Notifications
8.4.5. Deleting Notification Methods
8.5. Probes
8.5.1. Managing Probes
8.5.2. Establishing Thresholds
8.5.3. Monitoring the RHN Server
8.6. Troubleshooting
8.6.1. Examining Probes with rhn-catalog
8.6.2. Viewing the output of rhn-runprobe
9. Multiple Organizations
9.1. Recommended Models for Using Multiple Organizations
9.1.1. Centrally-Managed Satellite for A Multi-Department Organization
9.1.2. Decentralized Management of Multiple Third Party Organizations
9.1.3. General Tips for Multi-Org Usage
9.2. Admin ⇒ Organizations
9.2.1. Admin ⇒ Organizations ⇒ Details
9.3. Creating an Organization
9.4. Managing Entitlements
9.4.1. Admin ⇒ Subscriptions ⇒ Software Channel Entitlements
9.4.2. Admin ⇒ Subscriptions ⇒ System Entitlements
9.5. Configuring Systems in an Organization
9.6. Organizational Trusts
9.6.1. Establishing an Organizational Trust
9.6.2. Sharing Content Channels between Organizations in a Trust
9.6.3. Migrating Systems from One Trusted Organization to Another
9.7. Admin ⇒ Users
9.7.1. Admin ⇒ Organizations ⇒ Details ⇒ Users
10. Virtualization
10.1. Setting Up the Host System for Your Virtual Systems
10.1.1. Create a Kickstart Profile for the Guest Systems
10.1.2. Kickstart Your Host System
10.2. Setting Up Your Virtual Systems
10.2.1. Create a Kickstart Profile for the Guest Systems
10.2.2. Provision Your Guest Systems
10.3. Working With Your Virtual Systems
10.3.1. Logging into Virtual Systems Directly via SSH
10.3.2. Gaining Console Access Via the Host
10.3.3. Installing Software Via the Satellite Web Interface
10.3.4. Installing Software Via Yum From the Virtual System
10.3.5. Restarting Guests when Host Reboots
10.3.6. Deleting Virtual Systems
11. Cobbler
11.1. Cobbler Requirements
11.1.1. Using cobbler check
11.1.2. Configuring Cobbler with /etc/cobbler/settings
11.1.3. Cobbler and DHCP
11.1.4. Xinetd and TFTP
11.1.5. Configuring SELinux and IPTables for Cobbler Support
11.1.6. Syncing and Starting the Cobbler Service
11.2. Adding a Distribution to Cobbler
11.3. Adding a Profile to Cobbler
11.4. Adding a System to Cobbler
11.5. Cobbler Templates
11.5.1. Using Templates
11.5.2. Kickstart Snippets
11.6. Using Koan
11.6.1. Using Koan to Provision Virtual Systems
11.6.2. Using Koan to Re-install Running Systems
12. UNIX Support Guide
12.1. Introduction
12.1.1. Supported UNIX Variants
12.1.2. Prerequisites
12.1.3. Included Features
12.1.4. Differences in Functionality
12.1.5. Excluded Features
12.2. Satellite Server Preparation/Configuration
12.3. Client System Preparation
12.3.1. Download and Install Additional Packages
12.3.2. Deploying Client SSL Certificates
12.3.3. Configuring the clients
12.4. Registration and Updates
12.4.1. Registering Systems
12.4.2. Obtaining Updates
12.5. Remote Commands
12.5.1. Enabling Commands
12.5.2. Issuing Commands
A. Red Hat Network Registration Client
A.1. Configuring the Red Hat Network Registration Client
A.2. Starting the Red Hat Network Registration Client
A.3. Registering a User Account
A.4. Registering a System Profile
A.4.1. Hardware System Profile
A.4.2. Software System Profile
A.5. Finishing Registration
A.6. Entitling Your System
A.7. Text Mode RHN Registration Client
B. Command Line Config Management Tools
B.1. Red Hat Network Actions Control
B.1.1. General command line options
B.2. Red Hat Network Configuration Client
B.2.1. Listing Config Files
B.2.2. Getting a Config File
B.2.3. Viewing Config Channels
B.2.4. Differentiating between Config Files
B.2.5. Verifying Config Files
B.3. Red Hat Network Configuration Manager
B.3.1. Creating a Config Channel
B.3.2. Adding Files to a Config Channel
B.3.3. Differentiating between Latest Config Files
B.3.4. Differentiating between Various Versions
B.3.5. Downloading All Files in a Channel
B.3.6. Getting the Contents of a File
B.3.7. Listing All Files in a Channel
B.3.8. Listing All Config Channels
B.3.9. Removing a File from a Channel
B.3.10. Deleting a Config Channel
B.3.11. Determining the Number of File Revisions
B.3.12. Updating a File in a Channel
B.3.13. Uploading Multiple Files at Once
C. RHN API Access
C.1. Using the auth Class and Getting the Session
C.2. Obtaining the system_id
C.3. Determining the sid
C.4. Viewing the cid
C.5. Getting the sgid
C.6. Channel Labels
C.7. Sample API Script
D. Probes
D.1. Probe Guidelines
D.2. Apache 1.3.x and 2.0.x
D.2.1. Apache::Processes
D.2.2. Apache::Traffic
D.2.3. Apache::Uptime
D.3. BEA WebLogic 6.x and higher
D.3.1. BEA WebLogic::Execute Queue
D.3.2. BEA WebLogic::Heap Free
D.3.3. BEA WebLogic::JDBC Connection Pool
D.3.4. BEA WebLogic::Server State
D.3.5. BEA WebLogic::Servlet
D.4. General
D.4.1. General::Remote Program
D.4.2. General::Remote Program with Data
D.4.3. General::SNMP Check
D.4.4. General::TCP Check
D.4.5. General::UDP Check
D.4.6. General::Uptime (SNMP)
D.5. Linux
D.5.1. Linux::CPU Usage
D.5.2. Linux::Disk IO Throughput
D.5.3. Linux::Disk Usage
D.5.4. Linux::Inodes
D.5.5. Linux::Interface Traffic
D.5.6. Linux::Load
D.5.7. Linux::Memory Usage
D.5.8. Linux::Process Counts by State
D.5.9. Linux::Process Count Total
D.5.10. Linux::Process Health
D.5.11. Linux::Process Running
D.5.12. Linux::Swap Usage
D.5.13. Linux::TCP Connections by State
D.5.14. Linux::Users
D.5.15. Linux::Virtual Memory
D.6. LogAgent
D.6.1. LogAgent::Log Pattern Match
D.6.2. LogAgent::Log Size
D.7. MySQL 3.23 - 3.33
D.7.1. MySQL::Database Accessibility
D.7.2. MySQL::Opened Tables
D.7.3. MySQL::Open Tables
D.7.4. MySQL::Query Rate
D.7.5. MySQL::Threads Running
D.8. Network Services
D.8.1. Network Services::DNS Lookup
D.8.2. Network Services::FTP
D.8.3. Network Services::IMAP Mail
D.8.4. Network Services::Mail Transfer (SMTP)
D.8.5. Network Services::Ping
D.8.6. Network Services::POP Mail
D.8.7. Network Services::Remote Ping
D.8.8. Network Services::RPCService
D.8.9. Network Services::Secure Web Server (HTTPS)
D.8.10. Network Services::SSH
D.8.11. Network Services::Web Server (HTTP)
D.9. Oracle 8i, 9i, and 10g
D.9.1. Oracle::Active Sessions
D.9.2. Oracle::Availability
D.9.3. Oracle::Blocking Sessions
D.9.4. Oracle::Buffer Cache
D.9.5. Oracle::Client Connectivity
D.9.6. Oracle::Data Dictionary Cache
D.9.7. Oracle::Disk Sort Ratio
D.9.8. Oracle::Idle Sessions
D.9.9. Oracle::Index Extents
D.9.10. Oracle::Library Cache
D.9.11. Oracle::Locks
D.9.12. Oracle::Redo Log
D.9.13. Oracle::Table Extents
D.9.14. Oracle::Tablespace Usage
D.9.15. Oracle::TNS Ping
D.10. RHN Satellite
D.10.1. RHN Satellite::Disk Space
D.10.2. RHN Satellite::Execution Time
D.10.3. RHN Satellite::Interface Traffic
D.10.4. RHN Satellite::Latency
D.10.5. RHN Satellite::Load
D.10.6. RHN Satellite::Probe Count
D.10.7. RHN Satellite::Process Counts
D.10.8. RHN Satellite::Processes
D.10.9. RHN Satellite::Process Health
D.10.10. RHN Satellite::Process Running
D.10.11. RHN Satellite::Swap
D.10.12. RHN Satellite::Users
Glossary
E. Revision History
Index