3.3. Scenario 3: Installing Satellite with External Database
- One Red Hat Enterprise Linux 6 host for the Satellite Server
- One host containing your External Database. This database must adhere to the requirements outlined in Section 3.3.1, “External Database Requirements”.
3.3.1. External Database Requirements
- PostgreSQL 9.5
- Oracle Database 12c Standard and Enterprise Edition
- Oracle Database 11g Standard and Enterprise Edition
- Oracle Database 10g Release 2 Standard and Enterprise Edition
Note
Important
3.3.1.1. PostgreSQL Database Requirements
- rh-postgresql95
- rh-postgresql95-postgresql
- rh-postgresql95-postgresql-contrib
- rh-postgresql95-postgresql-libs
- rh-postgresql95-postgresql-server
- rh-postgresql95-postgresql-pltcl
Note
# subscription-manager repos --enable=rhel-server-rhscl-6-rpms # yum install rh-postgresql95 rh-postgresql95-postgresql rh-postgresql95-postgresql-contrib rh-postgresql95-postgresql-libs rh-postgresql95-postgresql-server rh-postgresql95-postgresql-pltcl
# service rh-postgresql95-postgresql initdb # service rh-postgresql95-postgresql start # chkconfig rh-postgresql95-postgresql on
postgres user and run PostgreSQL through the Software Collections tool:
# su postgres bash-4.1$ scl enable rh-postgresql95 'psql'
plpgsql and pltclu languages:
postgres=# CREATE USER mydbuser WITH PASSWORD 'mydbpassword'; postgres=# ALTER USER mydbuser WITH SUPERUSER; postgres=# CREATE DATABASE mydb OWNER mydbuser; postgres=# \connect mydb mydb=# CREATE EXTENSION plpgsql; mydb=# CREATE EXTENSION pltclu; mydb=# \q
Important
root user and edit the /var/opt/rh/rh-postgresql95/lib/pgsql/data/pg_hba.conf file:
bash-4.1$ exit # vi /var/opt/rh/rh-postgresql95/lib/pgsql/data/pg_hba.conf
host mydb mydbuser 192.168.1.0/24 md5
mydb database using the mydbuser from any system on the 192.168.1.0/24 network. The accepted authentication must also use an MD5-encrypted password.
/var/opt/rh/rh-postgresql95/lib/pgsql/data/postgresql.conf.
listen_addresses = '*' bytea_output = 'escape'
listen_addresses parameter opens communication to the database from other systems. The bytea_output parameter sets the correct encoding for bytea datatypes. Without this parameter, Satellite's Taskomatic service fails.
# service rh-postgresql95-postgresql restart
3.3.1.2. Oracle Database Requirements
- ALTER SESSION
- CREATE SEQUENCE
- CREATE SYNONYM
- CREATE TABLE
- CREATE VIEW
- CREATE PROCEDURE
- CREATE TRIGGER
- CREATE TYPE
- CREATE SESSION
- CREATE OPERATOR
- SELECT ON V_$PARAMETER
Warning
- Security Identifier (SID)
- Listener Port
- Username
- UTF-8 character set
Important
- Uniform Extent Size
- Auto Segment Space Management
Important
3.3.2. Downloading the Installation Media
Procedure 3.14. Download the Installation Media
- Log on to the Customer Portal.
- Click Downloads.
- Click Red Hat Satellite.
- Select 5.8 for RHEL 6 from the Versions drop-down list.
- Select x86_64 or s390x from the Architecture list.
- Download the Red Hat Satellite 5.8 Binary DVD.
- Depending on your preferred installation source, either copy the DVD ISO image to the Satellite host, or burn it to DVD media.
- 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. - If you will be mounting a DVD and running the installation program from there, burn the DVD ISO image to DVD media.
3.3.3. Mounting the Installation Media
Procedure 3.15. Mounting from a disc
- Log into the machine as
root. - Insert the Red Hat Satellite Server CD or DVD containing the installation files.
- 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.16. Mounting from an ISO image
- Log into the host as
root. - Mount the ISO image to a location on your filesystem:
# mkdir /media/cdrom # mount -o loop iso_filename /media/cdrom
/media/cdrom/. Use this location to access the Red Hat Satellite installation program.
3.3.4. Generating a Manifest
Note
Procedure 3.17. Generate New Satellite 5.8 Manifest
- Log on to the Customer Portal and navigate to Subscriptions in the upper-left corner.
- Navigate to Subscription Allocations.
- Click New subscription allocation.
- Enter a name in the Name field, select Satellite 5.8 from the Type drop-down list, and click Create.
- Navigate to the Subscription tab and click .
- 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.
- Click and save the manifest file locally.
- Log out of the Customer Portal.
- Access the shell prompt on the host to which the manifest file was downloaded.Copy the manifest file to the Satellite host. In this example, the file is copied to the
/rootdirectory.# scp manifest_file.zip root@satellite.example.com:/root
3.3.5. Installing Behind a HTTP Proxy: Pre-Configuration (Optional)
Note
- This section only applies to networks behind a HTTP proxy.
- Satellite does not support NTLM as a HTTP access authentication method. Only Basic access authentication, and Digest access authentication methods are supported.
/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
3.3.6. Registering Host with Red Hat Content Delivery Network
# subscription-manager register
The system has been registered with ID: 541084ff2-44cab-4eb1-9fa1-7683431bcf9a
3.3.7. Activating the Satellite Repositories
Procedure 3.18. Activate the Satellite Repositories
- 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
lessormore, you can read the output one screenful at a time.# subscription-manager list --all --available | less
Note thePool IDas this is required to attach the subscription. - 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
- Disable all repositories.
# subscription-manager repos --disable "*"
- 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
3.3.8. Running the Installation Program
root user.
Warning
Procedure 3.19. Running Installation Program
- Run the installation program from the
/media/cdrom/directory. To install to an external PostgreSQL database:# ./install.pl --external-postgresql
Or to install to an external Oracle database:# ./install.pl --external-oracle
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.
- 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.
* 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: ###########################
3.3.9. Configuring the Satellite
/root/.gnupg/ directory, if required.
* Configuring tomcat. * Setting up users and groups. ** GPG: Initializing GPG and importing key.
You must enter an email address. Admin Email Address? admin@example.com * Performing initial configuration.
* Activating Red Hat Satellite. Where is your satellite manifest file? /path/manifest_file.zip ** Loading Red Hat Satellite Manifest. ** Verifying manifest locally. ** Activating Red Hat Satellite.
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.
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]?
* Restarting services. Installation complete. Visit https://satellite.example.com to create the satellite administrator account. `
/tftpboot directory.
setsebool -P cobbler_anon_write on
Note

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.