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

  1. Change your directory to the mounted ISO and run the Installer Program using the --upgrade option.
    # cd /mount/cdrom
    # ./install.pl --upgrade
    
    Copy to Clipboard Toggle word wrap

    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”.
  2. Disable all services on the Red Hat Satellite server:
    # /usr/sbin/rhn-satellite stop
    
    Copy to Clipboard Toggle word wrap

    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
    
    Copy to Clipboard Toggle word wrap
  3. Upgrade the database with spacewalk-schema-upgrade:
    # /usr/bin/spacewalk-schema-upgrade
    
    Copy to Clipboard Toggle word wrap

    Important

    Make sure to backup your database before upgrading.
  4. 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
  5. 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.
  6. 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
  7. Restart all Red Hat Satellite services:
    # /usr/sbin/rhn-satellite restart
    
    Copy to Clipboard Toggle word wrap
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.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat