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
    

    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
    

    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
    
  3. Upgrade the database with spacewalk-schema-upgrade:
    # /usr/bin/spacewalk-schema-upgrade
    

    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
    
    If disconnected, run:
    # rhn-satellite-activate --rhn-cert [PATH-TO-NEW-CERT] --disconnected --ignore-version-mismatch
    
  5. 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.
  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
    
    To enable both Monitoring and Monitoring Scout, run the following command:
    # /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl --enable-scout
    
  7. 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.
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.

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.

© 2024 Red Hat, Inc.