Show Table of Contents
7.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 Red Hat Satellite to version 5.6. For comprehensive instructions, see the
/etc/sysconfig/rhn/satellite-upgrade/README file in the rhn-upgrade package.
Procedure 7.2. Upgrade Red Hat Satellite
- Mount the ISO as specified in Section 4.1.2, “Mounting the Installation Media”
- Change your directory to the mounted ISO and run the Installer Program using the
--upgradeoption.# cd /mount/cdrom # ./install.pl --upgrade
Important
Use additional options if your Red Hat Satellite is disconnected or using a Managed Database or External Database. For more information, read Section 4.2.1, “Options for the Installation Script”. - Disable all services on the Red Hat Satellite server:
# /usr/sbin/rhn-satellite stop
Important
The next step upgrades the database schema. Ensure the database is running on your Managed Database or External Database. If using an Embedded Database, ensure the database is running via the following command:# service postgresql start
- Upgrade the database with
spacewalk-schema-upgrade:# /usr/bin/spacewalk-schema-upgrade
Important
Make sure to backup your database before upgrading. - 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
- Rebuild search indexes with the following command:
# service rhn-search cleanindex
This command cleans the search indexes for therhn-searchservice and then restart it. - 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
- 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 8.8, “Maintaining the Database” for more information.

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.