8.2. Upgrading a Satellite


Once you have obtained the required items for the Satellite upgrade, follow the next procedure to upgrade.

Important

The following is a basic procedure for upgrading Satellite from version 5.4 to 5.5. For comprehensive instructions, refer to the /etc/sysconfig/rhn/satellite-upgrade/README file in the rhn-upgrade package.

Procedure 8.2. Upgrade a 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

    Ensure to use additional options if your Red Hat Network Satellite is disconnected or using a Stand-Alone Database. For more information, read Section 4.2.1, “Options for the Installer Script”.
  2. Disable all services on the Satellite server:
    # /usr/sbin/rhn-satellite stop
    
    Copy to Clipboard Toggle word wrap

    Important

    The next step will upgrade the database schema. Ensure the database is running on your Stand-Alone Database. If using an Embedded Satabase, ensure the database is running via the following command:
    # service oracle 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

    It is recommended to backup your database before upgrading.
  4. Activate the 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 makes the rhn-search service clean search indexes and restart.
  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 Satellite services:
    # /usr/sbin/rhn-satellite restart
    
    Copy to Clipboard Toggle word wrap
The upgrade procedure is complete and the Satellite is ready to use again.
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