Installation guide

Important
Red Hat strongly recommends that clients connected to a Satellite Proxy server be running the
latest update of Red Hat Enterprise Linux to ensure proper connectivity.
Clients that access a Red Hat Satellite Proxy are still authenticated by Red Hat Satellite but in this
case the Satellite Proxy provides both authentication and route information to Red Hat Satellite. After
a successful authentication, the Red Hat Satellite Server informs the Satellite Proxy server that it is
permitted to execute a specific action for the client. The Satellite Proxy server downloads all of the
updated packages (if they are not already present in its cache) and delivers them to the client system.
Requests from the Red Hat Update Agent or Package Updater on the client systems are still
authenticated on the server side, but package delivery is significantly faster because the packages
are cached in the HTTP Proxy Caching Server or the Satellite Proxy server (for local packages). The
Satellite Proxy server and client system are connected over the LAN and transfer speeds are limited
only by the speed of the local network.
The authentication process proceeds as follows:
1. The client performs a login action at the beginning of a client session. This login is passed
through one or more Satellite Proxy Servers until it reaches a Red Hat Satellite server.
2. The Red Hat Satellite server attempts to authenticate the client. If authentication is successful,
the server returns a session token through the chain of Satellite Proxy Servers. This token,
which has a signature and expiration time, contains user information, such as channel
subscriptions, username, and so on.
3. Each Satellite Proxy Server caches this token on its local file system in the
/var/cache/rhn/ directory. Caching reduces some of the overhead of authenticating with
Red Hat Satellite servers and greatly improves the performance of Red Hat Satellite.
4. This session token is sent to the client machine and is used in subsequent actions on
Red Hat Satellite.
From the client's perspective, there is no difference between a Satellite Proxy Server and a Red Hat
Satellite server. From the Red Hat Satellite server's perspective, a Satellite Proxy Server is a special
type of Red Hat client. Clients are thus not affected by the route that a request takes to reach a
Red Hat Satellite server. All of the logic is implemented in the Satellite Proxy Servers and Red Hat
Satellite servers.
The Custom Channel Package Manager can also be installed and configured to serve custom
packages. Any package that is not an official Red Hat package, including custom packages written
specifically for an organization, can only be served from a private software channel (also referred to
as a custom software channel). After creating a private Red Hat Satellite channel, the custom RPM
packages are associated with that channel by uploading the package headers to the Red Hat
Satellite servers. Only the headers are uploaded, not the actual package files. The headers are
required because they contain crucial RPM information, such as software dependencies, that allows
Red Hat Satellite to automate package installation. The actual custom RPM packages are stored on
the Satellite Proxy Server and sent to the client systems from inside the organization's local area
network.
Configuring a computer network to use Satellite Proxy Servers is straightforward. The Red Hat
Satellite applications on the client systems must be configured to connect to the Satellite Proxy
Server instead of a Red Hat Satellite server. See the Client Configuration Guide for details. On the proxy
side, you need to specify the next proxy in the chain (which eventually ends with a Red Hat Satellite
Red Hat Sat ellit e 5.7 Proxy In st allat ion G uide
4