11.2. Upgrading Red Hat Satellite to a New Version

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