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
    

    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
    

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

    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
    
    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 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
    
    To enable both Monitoring and Monitoring Scout, run the following command:
    # /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl --enable-scout
    
  7. Restart Satellite services:
    # /usr/sbin/rhn-satellite restart
    
The upgrade procedure is complete and the Satellite is ready to use again.