Chapter 4. Installing Satellite Server

Procedure

1. Go to Red Hat Customer Portal and log in.
2. Click DOWNLOADS.
3. Select Red Hat Enterprise Linux.
4. Click All Red Hat Enterprise Linux Downloads.

5. Ensure that you have the correct product and version for your environment.

   • Product Variant is set to Red Hat Enterprise Linux for x86_64.
   • Version is set to the latest minor version of the product you plan to use as the base operating system.
   • Architecture is set to the 64 bit version.
6. On the Product Software tab, download the Binary DVD image for the latest Red Hat Enterprise Linux for x86_64 version.
7. Click DOWNLOADS and select Red Hat Satellite.

8. Ensure that you have the correct product and version for your environment.

   • Product Variant is set to Red Hat Satellite.
   • Version is set to the latest minor version of the product you plan to use.
9. On the Product Software tab, download the Binary DVD image for the latest Red Hat Satellite version.

10. Copy the ISO files to /var/tmp on the Satellite base operating system or other accessible storage device.

    # scp localfile username@hostname:remotefile

Procedure

1. Create a directory to serve as the mount point for the ISO file corresponding to the version of the base operating system.

   # mkdir /media/rhel

2. Mount the ISO image for Red Hat Enterprise Linux to the mount point.

   # mount -o loop rhel-DVD.iso /media/rhel

3. To copy the ISO file’s repository data file and change permissions, enter:

   # cp /media/rhel/media.repo /etc/yum.repos.d/rhel.repo
   # chmod u+w /etc/yum.repos.d/rhel.repo

4. Edit the repository data file and add the baseurl directive.

   [RHEL-BaseOS]
   name=Red Hat Enterprise Linux BaseOS
   mediaid=None
   metadata_expire=-1
   gpgcheck=0
   cost=500
   baseurl=file:///media/rhel/BaseOS/
   
   [RHEL-AppStream]
   name=Red Hat Enterprise Linux AppStream
   mediaid=None
   metadata_expire=-1
   gpgcheck=0
   cost=500
   baseurl=file:///media/rhel/AppStream/

5. Verify that the repository has been configured.

   # yum repolist

6. Create a directory to serve as the mount point for the ISO file of Satellite Server.

   # mkdir /media/sat6

7. Mount the ISO image for Satellite Server to the mount point.

   # mount -o loop sat6-DVD.iso /media/sat6

Procedure

1. Ensure the ISO images for Red Hat Enterprise Linux Server and Red Hat Satellite are mounted:

   # findmnt -t iso9660

2. Import the Red Hat GPG keys:

   # rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release

3. Ensure the base operating system is up to date with the Binary DVD image:

   # dnf upgrade

4. Change to the directory where the Satellite ISO is mounted:

   # cd /media/sat6/

5. Run the installation script in the mounted directory:

   # ./install_packages

   If you have successfully installed the Satellite packages, the following message is displayed: Install is complete. Please run satellite-installer --scenario satellite.

Procedure

1. Go to the Red Hat Customer Portal and log in.
2. Click DOWNLOADS.
3. Click the product that contains the package that you want to download.
4. Ensure that you have the correct Product Variant, Version, and Architecture for your environment.
5. Click the Packages tab.
6. In the Search field, enter the name of the package.
7. Click the package.
8. From the Version list, select the version of the package.
9. At the bottom of the page, click Download Now.
10. Copy the package to the Satellite base operating system.

11. On Satellite Server, change to the directory where the package is located:

    # cd /path-to-package/

12. Install the package locally:

    # dnf install package_name

13. Change to the directory where the Satellite ISO is mounted:

    # cd /media/sat6/

14. Verify that you have resolved the package dependency errors by installing Satellite Server packages. If there are further package dependency errors, repeat this procedure.

    # ./install_packages

    If you have successfully installed the Satellite packages, the following message is displayed: Install is complete. Please run satellite-installer --scenario satellite.

Procedure

1. Depending on what type of database you want to use on your Satellite deployment, do one of the following:

   Note

   Specify a meaningful value for the option: --foreman-initial-organization. This can be your company name. An internal label that matches the value is also created and cannot be changed afterwards. If you do not specify a value, an organization called Default Organization with the label Default_Organization is created. You can rename the organization name but not the label.

   • To install Satellite Server with the default local database, enter the following command with any additional options that you want to use:

     # satellite-installer --scenario satellite \
     --foreman-initial-organization "My_Organization" \
     --foreman-initial-location "My_Location" \
     --foreman-initial-admin-username admin_user_name \
     --foreman-initial-admin-password admin_password

   • To install Satellite Server with an external PostgreSQL server, enter the following command:

     # satellite-installer --scenario satellite \
     --foreman-initial-organization "My_Organization" \
     --foreman-initial-location "My_Location" \
     --foreman-initial-admin-username admin_user_name \
     --foreman-initial-admin-password admin_password \
     --katello-candlepin-manage-db false \
     --katello-candlepin-db-host postgres.example.com \
     --katello-candlepin-db-name candlepin \
     --katello-candlepin-db-user candlepin \
     --katello-candlepin-db-password Candlepin_Password \
     --foreman-proxy-content-pulpcore-manage-postgresql false \
     --foreman-proxy-content-pulpcore-postgresql-host postgres.example.com \
     --foreman-proxy-content-pulpcore-postgresql-db-name pulpcore \
     --foreman-proxy-content-pulpcore-postgresql-user pulp \
     --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
     --foreman-db-manage false \
     --foreman-db-host postgres.example.com \
     --foreman-db-database foreman \
     --foreman-db-username foreman \
     --foreman-db-password Foreman_Password

     To also enable encrypted connections for these external databases, use the following command instead:

     # satellite-installer --scenario satellite \
     --foreman-initial-organization "My_Organization" \
     --foreman-initial-location "My_Location" \
     --foreman-initial-admin-username admin_user_name \
     --foreman-initial-admin-password admin_password \
     --katello-candlepin-manage-db false \
     --katello-candlepin-db-host postgres.example.com \
     --katello-candlepin-db-name candlepin \
     --katello-candlepin-db-user candlepin \
     --katello-candlepin-db-password Candlepin_Password \
     --katello-candlepin-db-ssl true \
     --katello-candlepin-db-ssl-ca My_CA_Certificate \
     --katello-candlepin-db-ssl-verify true \
     --foreman-proxy-content-pulpcore-manage-postgresql false \
     --foreman-proxy-content-pulpcore-postgresql-host postgres.example.com \
     --foreman-proxy-content-pulpcore-postgresql-db-name pulpcore \
     --foreman-proxy-content-pulpcore-postgresql-user pulp \
     --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
     --foreman-proxy-content-pulpcore-postgresql-ssl true \
     --foreman-proxy-content-pulpcore-postgresql-ssl-root-ca My_CA_Certificate \
     --foreman-db-manage false \
     --foreman-db-host postgres.example.com \
     --foreman-db-database foreman \
     --foreman-db-username foreman \
     --foreman-db-password Foreman_Password \
     --foreman-db-root-cert My_CA_Certificate \
     --foreman-db-sslmode verify-full

   The script displays its progress and writes logs to /var/log/foreman-installer/satellite.log.

2. Unmount the ISO images:

   # umount /media/sat6
   # umount /media/rhel

Procedure

1. In the Satellite web UI, navigate to Administer > Settings.
2. Click the Content tab.
3. Set the Subscription Connection Enabled value to No.