Red Hat Training

A Red Hat training course is available for Red Hat Satellite

11.2. Upgrading Red Hat Satellite to a New Version

Once you have obtained the required items for the Red Hat Satellite upgrade, follow the next procedure to upgrade.

Important

The following is a basic procedure for upgrading an Red Hat Satellite with Embedded Database to version 5.7. For comprehensive instructions and for other Satellite installations, see the /etc/sysconfig/rhn/satellite-upgrade/README file in the rhn-upgrade package.

Important

Due to an updated version of the PostgreSQL Embedded Database, the database location has changed from /var/lib/pgsql in Red Hat Satellite 5.6 to /opt/rh/postgresql92/root/var/lib/pgsql in Red Hat Satellite 5.7. Make sure to allocate enough hard disk space to this location.

Procedure 11.2. Upgrade Red Hat Satellite

  1. Create a backup of your database: 
    # db-control stop
# db-control backup $BACKUP_DIR
  2. Mount the ISO as specified in Section 4.1.2, “Mounting the Installation Media”
  3. Change your directory to the mounted ISO and run the installation program using the --upgrade and --disconnected options. 
    # cd /mount/cdrom
# ./install.pl --upgrade --disconnected

    Important

    Use additional options if your Red Hat Satellite is a Managed Database or External Database.
  4. Disable all Satellite services except for the database: 
    # /usr/sbin/rhn-satellite stop
# db-control start
  5. Upgrade the database with spacewalk-schema-upgrade: 
    # /usr/bin/spacewalk-schema-upgrade
  6. Verify the database upgrade. The following commands should output the same version: 
    # rhn-schema-version
5.7.0.11-1.el6sat
# rpm -q --qf '%{version}-%{release}\n' satellite-schema
5.7.0.11-1.el6sat
  7. Activate the Red Hat Satellite. If using a connected Satellite: 
    # rhn-satellite-activate --rhn-cert [PATH-TO-NEW-CERT] --ignore-version-mismatch
    If disconnected, run: 
    # rhn-satellite-activate --rhn-cert [PATH-TO-NEW-CERT] --disconnected --ignore-version-mismatch
  8. Rebuild search indexes with the following command: 
    # service rhn-search cleanindex
    This command cleans the search indexes for the rhn-search service and then restart it.
  9. Enable Monitoring and Monitoring Scout. To enable Monitoring without enabling Monitoring Scout, run the following command: 
    # /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl
    To enable both Monitoring and Monitoring Scout, run the following command: 
    # /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl --enable-scout
  10. The upgrade process saves a backup of rhn.conf and other configuration files to /etc/sysconfig/rhn/backup-$DATE-$TIME. Refer to the backup copy of the rhn.conf file and ensure any previous custom values are set in the new Red Hat Satellite's /etc/rhn/rhn.conf file. For example: 
    debug = 3
pam_auth_service = rhn-satellite
  11. Restart all Red Hat Satellite services: 
    # /usr/sbin/rhn-satellite restart
The upgrade procedure is complete and Red Hat Satellite is ready to use again.

Note

Perform a database vacuum to reclaim space from obsolete tuples. See Section 13.7, “Maintaining the Database” for more information.