Red Hat NETWORK PROXY SERVER 3.6 - Installation Manual

Copyright © 2001 - 2004 by Red Hat, Inc. RHNproxy(EN)-3.6-RHI (2004-12-07T20:09) Copyright © 2001 - 2004 by Red Hat, Inc. Red Hat, Red Hat Network, the Red Hat "Shadow Man" logo, RPM, Maximum RPM, the RPM logo, Linux Library, PowerTools, Linux Undercover, RHmember, RHmember More, Rough Cuts, Rawhide and all Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc. in the United States and other countries. Linux is a registered trademark of Linus Torvalds. All other trademarks and copyrights referred to are the property of their respective owners.

1. Introduction..................................................................................................................................... 1 1.1. Red Hat Network ............................................................................................................... 1 1.2. RHN Proxy Server............................................................................................................. 1 1.3. Terms to Understand.......................................................................................................... 2 1.4. How it Works ..................................................................................................................... 2 2. Requirements................................................................................................................................... 5 2.1. Software Requirements...................................................................................................... 5 2.2. Hardware Requirements..................................................................................................... 5 2.3. Disk Space Requirements .................................................................................................. 6 2.4. Additional Requirements ................................................................................................... 6 3. Example Topologies ........................................................................................................................ 9 3.1. Single Proxy Topology ...................................................................................................... 9 3.2. Multiple Proxy Horizontally Tiered Topology .................................................................. 9 3.3. Multiple Proxy Vertically Tiered Topology..................................................................... 10 3.4. Proxies with RHN Satellite Server .................................................................................. 11 4. Installation..................................................................................................................................... 13 4.1. Base Install....................................................................................................................... 13 4.2. RHN Proxy Server Installation Process........................................................................... 13 5. RHN Package Manager................................................................................................................ 21 5.1. Creating a Private Channel .............................................................................................. 21 5.2. Uploading Packages......................................................................................................... 21 5.3. Command Line Options................................................................................................... 22 6. Troubleshooting............................................................................................................................. 25 6.1. Managing the Proxy Service............................................................................................ 25 6.2. Log Files .......................................................................................................................... 25 6.3. Questions and Answers.................................................................................................... 25 6.4. General Problems............................................................................................................. 26 6.5. Host Not Found/Could Not Determine FQDN................................................................ 26 6.6. Connection Errors............................................................................................................ 27 6.7. Caching Issues ................................................................................................................. 27 6.8. Proxy Debugging by Red Hat.......................................................................................... 28 A. Sample RHN Proxy Server Configuration File ......................................................................... 31 Index................................................................................................................................................... 33

Red Hat Network (RHN) is the environment for system-level support and management of Red Hat systems and networks of systems. Red Hat Network brings together the tools, services, and informa- tion repositories needed to maximize the reliability, security, and performance of their systems. To use RHN, system administrators register the software and hardware profiles, known as System Profiles, of their client systems with Red Hat Network. When a client system requests package updates, only the applicable packages for the client are returned (based upon the software profile stored on the RHN Servers). Advantages of using Red Hat Network include: • Scalability — with Red Hat Network, a single system administrator can set up and maintain hun- dreds or thousands of Red Hat systems more easily, accurately, and quickly than that same admin- istrator could maintain a single system without Red Hat Network. • Standard Protocols — standard protocols are used to maintain security and increase capability. For example, XML-RPC gives Red Hat Network the ability to do much more than merely download files. • Security — all communication between registered systems and Red Hat Network takes place over secure Internet connections. • View Errata Alerts — easily view Errata Alerts for all your client systems through one website. • Scheduled Actions — use the website to schedule actions, including Errata Updates, package in- stalls, and software profile updates. • Simplification — maintaining Red Hat systems becomes a simple, automated process. 1.2. RHN Proxy Server An RHN Proxy Server is a service deployed within a corporate network with advanced Red Hat Network functionality, such as a package-caching mechanism for reduced bandwidth usage and cus- tomizable channels enabling custom package deployment. This service allows a business or corporation to cache RPM Updates on an internal, centrally located RHN Proxy Server and have the client systems download the updates from that server instead of from one of the RHN Servers 1 over the Internet. The clients’ System Profiles and user information are stored on the secure, central RHN Servers, which also serve the RHN website (rhn.redhat.com). The Proxy does not serve the website itself; It acts as a go-between for client systems and Red Hat Network. Only the RPM files are stored on the RHN Proxy Server. Every transaction is authenticated, and the Red Hat Update Agent checks the GPG signature of each package retrieved from the local RHN Proxy Server. In addition to storing official Red Hat packages, the RHN Proxy Server can be configured to deliver an organization’s own custom RPM packages from private RHN channels, using the RHN Package Manager. For instance, an organization could develop its own software, package it in an RPM, sign it 1. Throughout this document,replace RHN Server with RHN Satellite Server if the RHN Proxy Server connects to a RHN Satellite Server instead.