Installation guide

Chapter 5. Entitlements
The RHN Satellite, like RHN itself, provides all services to cus tomers through the setting of entitlements.
For RHN, entitlements are purchased by cus tomers as needed; however, for RHN Satellite, entitlements
are contractually agreed-upon beforehand, and they are set at installation time. All public channels are
automatically available; the private channels that s hould also be made available through the Satellite are
determined by the RHN Entitlement Certificate.
The RHN Entitlement Certificate, which contains the precise set of entitlements attributed to your
organization, is provided by your Red Hat representative. Red Hat reserves the right to compare the
contents of that RHN Entitlement Certificate with the databas e's entitlement settings at any time to
ensure compliance with the terms of the customer's contract with Red Hat.
The steps referenced in this section are typically carried out by the RHN Satellite Inst allat ion
Program itself and do not need to be repeated during initial installation. Instead, they are listed here for
use by customers who have received a new RHN Entitlement Certificate, such as one reflecting an
increase in the number of entitlements.
5.1. Receiving the Certificate
The RHN Entitlement Certificate is an XML document that looks something like this:
<?xml version="1.0" encoding="UTF-8"?>
<rhn-cert version="0.1">
<rhn-cert-field nam e="product">RHN-SATELLITE-001</rhn-cert-field>
<rhn-cert-field nam e="owner">Clay's Precious Satellite</rhn-cert-field>
<rhn-cert-field nam e="issued">2005-01-11 00:00:00</rhn-cert-field>
<rhn-cert-field nam e="expires">2005-03-11 00:00:00</rhn-cert-field>
<rhn-cert-field nam e="slots">30</rhn-cert-field>
<rhn-cert-field nam e="provisioning-slots">30</rhn-cert-field>
<rhn-cert-field nam e="nonlinux-slots">30</rhn-cert-field>
<rhn-cert-field nam e="channel-fam ilies" quantity="10" family="rhel-cluster"/>
<rhn-cert-field nam e="channel-fam ilies" quantity="30" family="rhel-ws-extras"/>
<rhn-cert-field nam e="channel-fam ilies" quantity="10" family="rhel-gfs"/>
<rhn-cert-field nam e="channel-fam ilies" quantity="10" family="rhel-es-extras"/>
<rhn-cert-field nam e="channel-fam ilies" quantity="40" family="rhel-as"/>
<rhn-cert-field nam e="channel-fam ilies" quantity="30" family="rhn-tools"/>
<rhn-cert-field nam e="satellite-version">5.2</rhn-cert-field>
<rhn-cert-field nam e="generation">2</rhn-cert-field>
<rhn-cert-signature>
-----BEGIN PGP SIGNATURE-----
Version: Crypt::OpenPGP 1.03
iQBGBAARAwAGBQJCAG7yAAoJEJ5yna8GlHkysOkAn07qmlUrkGKs7/5yb8H/nboG
mhHkAJ9wdm qOeKfcBa3IUDL53oNMEBP/dg==
=0Kv7
-----END PGP SIGNATURE-----
</rhn-cert-signature>
</rhn-cert>
Note
Do not try to us e this RHN Entitlement Certificate; it is just an example.
The initial RHN Entitlement Certificate is generated by a member of the RHN team and emailed to a
cons ultant or customer prior to installation. This process helps guarantee that we do not inadvertently
install any RHN Satellites that the RHN team does not know about.
Save the XML file to the Satellite machine in preparation for activation.
5.2. Uploading the RHN Entitlement Certificate
If your RHN Satellite is connected to the Internet, you have the option of uploading your new RHN
Entitlement Certificate through the RHN website. To do this:
1. Log into https://rhn.redhat.com with your organization's Satellite-entitled account.
2. Click System s in the top navigation bar and then the name of the RHN Satellite. You may also find
the Satellite through the Satellite line item within the Channels category.
3. In the System Details page, click the Satellite subtab and examine the existing certificate.
Ensure you have a backup of this file by copying and pasting its contents into a text editor.
4. Click Deactivate Satellite License at the bottom of the page. T hen click Confirm
Deactivation. You will receive a message describing the deactivation at the top of the page.
5. You may then browse to the location of your new RHN Entitlement Certificate or paste its contents
into the text field provided. When done, click Update Certificate.
Your Satellite now has access to additional channels and client entitlements outlined in the new
certificate. You may now synchronize it with the central RHN Servers. Refer to Chapter 6, Importing and
Synchronizing.
5.3. Managing the RHN Certificate with RHN Satellite Activate
For disconnected Satellites or customers who prefer to work locally, Red Hat provides a command line
tool for managing your RHN Entitlement Certificate and activating the Satellite using that certificate: RHN
Sat ellit e Activate (rhn-satellite-activate). This is included with the Satellite ins tallation as
part of the spacewalk-backend-tools package.
5.3.1. Command Line Entitlement Options
The rhn-satellite-activate tool offers a handful of command line options for activating a Satellite
using its RHN Entitlement Certificate:
Red Hat Network Satellite 5.4 Installation Guide
20