Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 4. Installation Scenarios

This scenario details the steps for an Embedded Database Installation. You would use an Embedded Database Installation to contain the whole Red Hat Satellite infrastructure within a single host.
This scenario only requires a single host with Red Hat Enterprise Linux installed as the operating system.

4.1.1. Downloading the Installation Media
Copy link

The Satellite 5.7 installation media is available for download from the Red Hat Customer Portal in ISO format.

Procedure 4.1. Download the Installation Media

  1. Log on to the Red Hat Customer Portal.
  2. Click Downloads.
  3. Click Red Hat Satellite.
  4. Select 5.7 for RHEL 6 from the Version drop-down list.
  5. Select x86_64 or s390x from the Architecture list.
  6. Download the Satellite 5.7.0 Installer for RHEL-6.
  7. Depending on your installation requirements, either burn the DVD ISO image to DVD media, or copy it to the host on which Red Hat Satellite will be installed.
    Run the following command on the host containing the DVD ISO image to copy it to the Satellite host. In this example, the ISO image is copied to the directory /root. 
    # scp satellite.iso root@hostname:/root
    Copy to Clipboard Toggle word wrap
    If you will be installing Red Hat Satellite from a DVD, burn the download ISO image to a writeable DVD.

4.1.2. Mounting the Installation Media
Copy link

Once you have obtained a version of the Red Hat Satellite 5 installation media, mount the disc or ISO image on the Satellite host.

Procedure 4.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
    Copy to Clipboard Toggle word wrap

Procedure 4.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
    Copy to Clipboard Toggle word wrap
The installation media is mounted at /media/cdrom/. Use this location to access the Red Hat Satellite installation program.

Note

This section only applies to networks behind a HTTP proxy.
The registration of the Red Hat Enterprise Linux host requires communication between itself and the Red Hat Content Delivery Network. If there is an HTTP proxy between these two, Subscription Manager must be configured with the proxy server's details, and credentials.
Edit the configuration file /etc/rhsm/rhsm.conf, and edit the following lines, adding details of the HTTP proxy, and credentials. 
proxy_hostname = proxy_hostname
proxy_port = proxy_port
proxy_user = proxy_user
proxy_password = proxy_password
Copy to Clipboard Toggle word wrap
Registering the host to Red Hat Content Delivery Network enables the host to subscribe to and consume content for any subscriptions available to the user. This includes content such as Red Hat Enterprise Linux, Red Hat Software Collections (RHSCL), and Red Hat Satellite.
Register your system with the Red Hat Content Delivery Network, entering your Customer Portal user name and password when prompted: 
# subscription-manager register
Copy to Clipboard Toggle word wrap
The command displays output similar to the following: 
The system has been registered with ID: 541084ff2-44cab-4eb1-9fa1-7683431bcf9a
Copy to Clipboard Toggle word wrap
The installation of Red Hat Satellite 5.7 requires Red Hat Enterprise Linux repository to be enabled. The following instructions detail how to identify and attach the required subscription, and also how to enable the required repository. Note that at this stage, only the Red Hat Enterprise Linux repository needs to be enabled. The Red Hat Satellite repository needs to be enabled after the Satellite installation is complete.

Procedure 4.4. Activate the Red Hat Enterprise Linux Repository

  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
    Copy to Clipboard Toggle word wrap
    Note the Pool ID as this is required to attach the subscription.
  2. Attach the subscription to the Red Hat Satellite host. 
    # subscription-manager attach --pool=pool_id
    Copy to Clipboard Toggle word wrap
    The output should be similar to the following: 
    Successfully attached a subscription for: Red Hat Satellite
    Copy to Clipboard Toggle word wrap
  3. Disable all repositories. 
    # subscription-manager repos --disable "*"
    Copy to Clipboard Toggle word wrap
  4. Enable the Red Hat Enterprise Linux 6 repository.
    For ⁠AMD64 and Intel 64 
    # subscription-manager repos --enable=rhel-6-server-rpms
    Copy to Clipboard Toggle word wrap
    For IBM System z 
    # subscription-manager repos --enable=rhel-6-for-system-z-rpms
    Copy to Clipboard Toggle word wrap

4.1.6. Running the Installation Program
Copy link

The following procedure installs Red Hat Satellite with an Embedded Database. Ensure to run this procedure as the root user.

Warning

The installation program updates all required packages, possibly including the kernel.

Procedure 4.5. Running the Installation Program

  1. Run the installation program from the /media/cdrom/ directory: 
    # ./install.pl --disconnected
    Copy to Clipboard Toggle word wrap

    Note

    The --disconnected option is required to prevent the installation program attempting to connect to Red Hat Network.
  2. The script first verifies the prerequisites Chapter 2, Requirements are met before proceeding with the installation. 
    * Starting the Red Hat Satellite installer.
* Performing pre-install checks.
* Pre-install checks complete.  Beginning installation.
    Copy to Clipboard Toggle word wrap
  3. 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 installer prompts with the question, "Do you want the installer to resolve dependencies [y/N]?", reply y. 
    * RHN Registration.
** Registration: Disconnected mode.  Not registering with RHN.
* 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 RHN packages.
Warning: yum did not install the following packages:
	OpenIPMI
	OpenIPMI-libs
	lm_sensors-libs
	net-snmp-libs
* Now running spacewalk-setup.
* Setting up SELinux..
** Database: Setting up database connection for PostgreSQL backend.
** 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.
** Database: Populating database.
*** Progress: ####################################
    Copy to Clipboard Toggle word wrap

4.1.7. Configuring the Satellite
Copy link

The Installation Script performs some basic configuration tasks on your Red Hat Satellite environment.
The Red Hat Satellite installation program downloads and installs the Red Hat GPG key and sets up the /root/.gnupg/ directory, if required. 
* Configuring tomcat.
* Setting up users and groups.
** GPG: Initializing GPG and importing key.
Copy to Clipboard Toggle word wrap
To activate Red Hat Satellite, provide the location of your certificate, downloaded in Chapter 3, Entitlement Certificate. 
* Performing initial configuration.
* Activating Red Hat Satellite.
Where is your satellite certificate file? /root//root/certificate.xml
** Loading Red Hat Satellite Certificate.
** Verifying certificate locally.
** Activating Red Hat Satellite.
Copy to Clipboard Toggle word wrap
The next step is to create a CA certificate for SSL access. Answer y to the Apache SSL configuration question, then answer the CA certificate questions.
CA cert
Enter a password for the certificate.
Organization
Enter the name of your organization.
Organization Unit
Enter the name of your department within your organization.
Email Address
Enter an email address to be associated with this certificate, such as the admin email entered in the steps above.
City
Enter your city.
State
Enter your state.
Country
Enter your country. The country code must be exactly two letters, or the certificate generation fails. Type ? to see a list of country codes. 
* Configuring apache SSL virtual host.
Should setup configure apache's default ssl server for you (saves original ssl.conf) [Y]? 
** /etc/httpd/conf.d/ssl.conf has been backed up to ssl.conf-swsave
* Configuring jabberd.
* Creating SSL certificates.
CA certificate password? 
Re-enter CA certificate password? 
Organization? Red Hat
Organization Unit [satellite.example.com]? Sales
Email Address [admin@example.com]? admin@example.com
City? Raleigh
State? NC
Country code (Examples: "US", "JP", "IN", or type "?" to see a list)? US
** SSL: Generating CA certificate.
** SSL: Deploying CA certificate.
** SSL: Generating server certificate.
** SSL: Storing SSL certificates.
* Deploying configuration files.
* Update configuration in database.
Copy to Clipboard Toggle word wrap
After the CA certificate is created, you are asked if you want to enable the services required by Cobbler. If you will be using PXE provisioning functionality, reply y. 
* Setting up Cobbler..
cobblerd does not appear to be running/accessible
Cobbler requires tftp and xinetd services be turned on for PXE provisioning functionality. Enable these services [Y]?
Copy to Clipboard Toggle word wrap
After Cobbler is configured, the installation program restarts the associated services. 
* Restarting services.
Installation complete.
Visit https://satellite.example.com to create the Red Hat Satellite administrator account.
Copy to Clipboard Toggle word wrap
If you will be using Cobbler for provisioning hosts, grant Cobbler write access to the /tftpboot directory. 
# setsebool -P cobbler_anon_write on
Copy to Clipboard Toggle word wrap

4.1.8. Post-Installation Tasks
Copy link

Post-installation tasks include:
  • Activate the Satellite 5 repository.
  • Update packages and the database schema.
  • Switch Satellite to connected mode.

Procedure 4.6. Activate Satellite 5 Repository

  • Enable the Satellite 5 repository
    For ⁠AMD64 and Intel 64: 
    # subscription-manager repos --enable rhel-6-server-satellite-5.7-rpms
    Copy to Clipboard Toggle word wrap
    For IBM System z: 
    # subscription-manager repos --enable=rhel-6-system-z-satellite-5.7-rpms
    Copy to Clipboard Toggle word wrap

Procedure 4.7. Update Packages and the Database Schema

Procedure 4.8. Switch Satellite to Connected Mode

The installation was completed in disconnected mode, so must be switched to connected mode.
  1. Edit the Red Hat Network configuration file /etc/rhn/rhn.conf and make the following changes:
    1. Edit the server.satellite.rhn_parent line as follows. 
      # server.satellite.rhn_parent = satellite.rhn.redhat.com
      Copy to Clipboard Toggle word wrap
    2. Change the line disconnected=1 to disconnected=0. 
      disconnected=0
      Copy to Clipboard Toggle word wrap
  3. Validate the configuration changes. 
    1. # spacewalk-cfg-get get server disconnected
      Copy to Clipboard Toggle word wrap
      The expected output is 0, confirming that disconnected mode is not enabled. 
    2. # spacewalk-cfg-get get server.satellite rhn_parent
      Copy to Clipboard Toggle word wrap
      The expected output is satellite.rhn.redhat.com.
  4. Reactivate the Satellite Server. The rhn-satellite-activate command requires the entitlement certificate. In this example, the certificate Satellite-57.cert is used. 
    # rhn-satellite-activate -vvv --rhn-cert=Satellite-57.cert
RHN_PARENT: satellite.rhn.redhat.com
    Copy to Clipboard Toggle word wrap
Continue with the instructions in Chapter 5, Configuration.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat