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
   

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

   Copy to Clipboard Toggle word wrap

   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
   

   Copy to Clipboard Toggle word wrap
5. Upgrade the database with spacewalk-schema-upgrade:

   # /usr/bin/spacewalk-schema-upgrade
   

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

   Copy to Clipboard Toggle word wrap
7. Activate the Red Hat Satellite. If using a connected Satellite:

   # rhn-satellite-activate --rhn-cert [PATH-TO-NEW-CERT] --ignore-version-mismatch
   

   Copy to Clipboard Toggle word wrap
   If disconnected, run:

   # rhn-satellite-activate --rhn-cert [PATH-TO-NEW-CERT] --disconnected --ignore-version-mismatch
   

   Copy to Clipboard Toggle word wrap
8. Rebuild search indexes with the following command:

   # service rhn-search cleanindex
   

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

   Copy to Clipboard Toggle word wrap
   To enable both Monitoring and Monitoring Scout, run the following command:

   # /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl --enable-scout
   

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

    Copy to Clipboard Toggle word wrap
11. Restart all Red Hat Satellite services:

    # /usr/sbin/rhn-satellite restart
    

    Copy to Clipboard Toggle word wrap