Installation guide

9. Use the RHN Sa te llit e Synchronization Tool to import the channels and associated packages
into the Satellite.
10. Register a representative machine for each distribution type, or channel (such as Red Hat
Enterprise Linux 5 or 6), to the Satellite.
11. Copy (us ing SCP) the rhn_register and up2date configuration files from the
/etc/sysconfig/rhn/ directory of each machine individually to the /pub/ directory on the
Satellite. The rhn-org-trusted-ssl-cert-*.noarch.rpm will already be there.
12. Download and install from the Satellite the configuration files and rhn-org-trusted-ssl-
cert-*.noarch.rpm on the remaining client sys tems of the same distribution type. Repeat this
and the previous step until all distribution types are complete.
13. Through the Satellite's website, create an Activation Key for each distribution aligned to the
appropriate base channel. At this point, system groups and child channels may also be
predefined.
14. Run the Activation Key from the command line (rhnreg_ks) of each client system. Note that this
step can be scripted to batch register and reconfigure all remaining client systems in a
distribution.
15. Record all relevant usernames, passwords and other login information and store in multiple
secure places.
16. Now that the Satellite is populated with standard Red Hat channels and packages and all clients
are connected to it, you may begin creating and serving custom channels and packages. Once the
custom RPMs are developed, you can import them into the Satellite using RHN Push and add
custom channels in which to s tore them through the Satellite's website. Refer to the RHN Channel
Management Guide for details.
1.6. Upgrades
To upgrade a Satellite from one version to another, the following items are required:
Satellite Certificate
Satellite Upgrade Documentation Package (rhn-upgrade)
New Installation ISO
1.6.1. Satellite Certificate
To obtain a Satellite certificate, visit Red Hat s upport at http://s upport.redhat.com.
1.6.2. Satellite Upgrade Documentation Package (rhn-upgrade)
To install the rhn-upgrade package, ensure the satellite is registered to RHN and to the Red Hat
Network Satellite Channel, then using the package updating tool for your version of Red Hat Enterprise
Linux to install the rhn-upgrade package with the following commmand (on Red Hat Enterprise Linux 5
and 6):
yum install rhn-upgrade
You may also download the package directly from Red Hat Network by performing the following steps:
1. Log into the RHN Hosted web interface at https://rhn.redhat.com/.
2. Click the Channels tab.
3. Under Filter by Product Channel select Red Hat Network Products, then your
current version of RHN Satellite, and finally your Satellite server's architecture from the drop-down
menus.
4. Press the Filter button.
5. Click to expand the Red Hat Enterprise Linux tree for your version of the base operating
system.
6. Click the link in the Architecture column corresponding to Red Hat Network Satellite.
7. Click on the Packages subtab.
8. In the Filter by Package text box, type rhn-upgrade and press Go.
9. Click on the latest rhn-upgrade package release for the version of Satellite to which you are
upgrading.
10. Click the Download Package link.
11. Copy the package to the Satellite server.
12. On the Satellite server run the following command:
rpm -Uvh rhn-upgrade-version.rpm
1.6.3. New Installation ISO
This ISO can be downloaded by performing the following steps:
1. Log into RHN
2. Click on Software Downloads on the left-hand side of the screen
3. Navigate to the version of Red Hat Enterprise Linux you are currently using
4. Click on the latest vers ion of RHN Satellite
5. Then choose if you want the embedded Oracle Database ISO or the non-embedded version
Once you have followed all steps, refer to the instructions for a Satellite upgrade within the
/etc/sysconfig/rhn/satellite-upgrade/README file in the rhn-upgrade package.
Important
If you perform an upgrade from RHN Satellite 5.2 or previous to RHN Satellite 5.3 or newer, be
aware that kickstart files created in previous versions need to be updated to work on your
upgraded Satellite.
For example, if your RHN Satellite 5.2 kickstart file pointed to the following URL:
http://satellite.example.com/kickstart/dist/ks-rhel-i386-server-5
You must change the URL to the following once you have upgraded to RHN Satellite 5.3 or newer:
http://satellite.example.com/ks/dist/ks-rhel-i386-server-5
Chapter 1. Introduction
7