Chapter 3. Installation Scenarios

Procedure 3.1. Download the Installation Media

1. Log on to the Customer Portal.
2. Click Downloads.
3. Click Red Hat Satellite.
4. Select 5.8 for RHEL 6 from the Versions drop-down list.
5. Select x86_64 or s390x from the Architecture list.
6. Download the Red Hat Satellite 5.8 Binary DVD.
7. Depending on your preferred installation source, either copy the DVD ISO image to the Satellite host, or burn it to DVD media.
   1. If you will be mounting the ISO image and running the installation program from there, copy the ISO image to the Satellite host.

      # scp satellite.iso root@hostname:/root
      

      Note

      If you will be installing a Managed DB instance, also copy the ISO image to that host.
   2. If you will be mounting a DVD and running the installation program from there, burn the DVD ISO image to DVD media.

Procedure 3.2. Mounting from a disc

1. Log into the machine as root.
2. Insert the Red Hat Satellite Server CD or DVD containing the installation files.
3. Red Hat Enterprise Linux might automount the disc. If so, it mounts the disc to the /media/cdrom/ directory. If Red Hat Enterprise Linux does not automount the disc, manually mount it to the /media/cdrom/ directory with the following command:

   # mkdir /media/cdrom
   # mount /dev/cdrom /media/cdrom
   

Procedure 3.3. Mounting from an ISO image

1. Log into the host as root.
2. Mount the ISO image to a location on your filesystem:

   # mkdir /media/cdrom
   # mount -o loop iso_filename /media/cdrom
   

Procedure 3.4. Generate New Satellite 5.8 Manifest

1. Log on to the Customer Portal and navigate to Subscriptions in the upper-left corner.
2. Navigate to Subscription Allocations.
3. Click New subscription allocation.
4. Enter a name in the Name field, select Satellite 5.8 from the Type drop-down list, and click Create.
5. Navigate to the Subscription tab and click Add subscriptions.
6. For each product to be attached to the manifest, specify the desired quantity in the Entitlements field, and click Submit. It may take several minutes for the subscriptions to be attached.
7. Click Export Manifest and save the manifest file locally.
8. Log out of the Customer Portal.
9. Access the terminal on the host to which the manifest file was downloaded.
   If the Satellite server is available via the network, copy the manifest file to the Satellite host. In this example, the file is copied to the /root directory.

   # scp manifest_file.zip root@satellite.example.com:/root
   

   If the Satellite server is disconnected, copy the manifest file to portable media, and on the Satellite server, copy the manifest file from the portable media.

Procedure 3.5. Activate the Satellite Repositories

1. List all available subscriptions, and identify the Red Hat Satellite 5 subscription.
   The list of available subscriptions may be long, but if you pipe the output into a pager utility, such as less or more, you can read the output one screenful at a time.

   # subscription-manager list --all --available | less
   

   Note the Pool ID as this is required to attach the subscription.
2. Attach the subscription to the host.

   # subscription-manager attach --pool=pool_id

   The output should be similar to the following:

   Successfully attached a subscription for: Red Hat Satellite
   

3. Disable all repositories.

   # subscription-manager repos --disable "*"
   

4. Enable the Red Hat Enterprise Linux 6 repository. The Red Hat Satellite 5.8 repository will be enabled automatically by the installation program.
   For ⁠AMD64 and Intel 64

   # subscription-manager repos --enable=rhel-6-server-rpms
   

   For IBM System z

   # subscription-manager repos --enable=rhel-6-for-system-z-rpms
   

Procedure 3.6. Running Installation Program

1. Run the installation program from the /media/cdrom/ directory:

   # ./install.pl
   

   The installation program first verifies the requirements in Chapter 2, Requirements are met before proceeding.

   * Starting the Red Hat Satellite installer.
   * Performing pre-install checks.
   * Pre-install checks complete.  Beginning installation.
   

2. The script performs host registration with Red Hat Subscription Manager (if not already done), installs and updates all required packages, and populates the database on the Managed Database Host.
   If the installation program prompts with the question, "Do you want the installer to resolve dependencies [y/N]?", reply y (Yes).

   * RHSM Registration.
   ** Registration: System is already registered with RHSM.  Not re-registering.
   * RHSM Subscriptions.
   ** Subscriptions: Subscription providing 'Red Hat Satellite' already attached.
   ** Subscriptions: Subscription providing 'Red Hat Enterprise Linux Server' already attached.
   ** Subscriptions: Disabling all RHSM repositories (rhel-6-server-rpms).
   ** Subscriptions: All repositories disabled.
   ** Subscriptions: Enabling RHEL repository.
   ** Subscriptions: RHEL repository enabled.
   * Checking for uninstalled prerequisites.
   ** Checking if yum is available ...
   There are some packages from Red Hat Enterprise Linux that are not part
   of the @base group that Satellite will require to be installed on this
   system. The installer will try resolve the dependencies automatically.
   However, you may want to install these prerequisites manually.
   Do you want the installer to resolve dependencies [y/N]? y
   * Installing Satellite packages.
   Warning: yum did not install the following packages:
   	libXt
   * Now running spacewalk-setup.
   * Setting up SELinux..
   ** Database: Setting up database connection for PostgreSQL backend.
   Database "rhnschema" does not exist
   ** Database: Installing the database:
   ** Database: This is a long process that is logged in:
   ** Database:   /var/log/rhn/install_db.log
   *** Progress: #
   ** Database: Installation complete.
   ** Database: Populating database.
   *** Progress: ###########################