Upgrade Red Hat Satellite 5.6 to 5.7 - Red Hat

The process of upgrading Red Hat Satellite 5.6 to 5.7 is fairly simple if you follow the steps properly and have got enough space on the host while upgrading. There are many new features in Satellite 5.7 which includes integration of IDM for User Authentications and a major upgrade to the text editor which make it a hell of a lot easier to edit files PLUS the NEW User interface gives it a new life. 

NOTE: This guide is applicable only to Red Hat Enterprise Linux v6.x and above.

Some of the New features in Satellite 5.7 are given below.For more info on the new features visit Red Hat website.

  • Authentication through Identity Management (IdM) Servers - Red Hat Satellite 5.7 now contains a tool called spacewalk-setup-ipa-authentication, which configures your Satellite server to use an IdM/IPA server for authenticating users. See the Red Hat Satellite 5.7 Installation Guide for instructions for setting IdM authentication.
  • FIPS 140-2 support - The Federal Information Processing Standard (FIPS) 140-2 is a U.S. government security standard used to accredit cryptographic modules. This FIPS standard is enabled at an operating system level. Red Hat Satellite now uses the SHA-256 hashing method instead of MD5 to support the FIPS 140-2 standard. If you aim to upgrade from a non-FIPS Satellite server to FIPS-compliant Satellite 5.7 server, some additional configuration is required prior to enabling FIPS on the Satellite server. This involves updating user passwords and client certificates. See the upgrade instructions in the Red Hat Satellite 5.7 Installation Guide for configuration prior to enabling FIPS.
  • SSL support for Managed and External Database connections - Red Hat Satellite 5.7 now supports secure database communication in federated environments, such as Managed Database and External Database Satellite environments. See the Red Hat Satellite 5.7 Installation Guide for instructions on securing the database communication.
  • Enhanced Reporting in a Hosted Virtual Machine - Red Hat Satellite 5.7 now supports running a virtual machine on the Satellite server to host the Subscription Asset Manager server. See the Red Hat Satellite 5.7 Installation Guide for basic setup instructions.
  • Power Management - Red Hat Satellite 5.7 provides new features to control a client's power functions, such as Power On, Power Off, and Reboot. Clients require an IPMI interface for these function. See the system management instructions in the Red Hat Satellite 5.7 Getting Started Guide for configuration instructions.
  • Action Chaining - Red Hat Satellite 5.7 provides the ability to schedule a sequence of operations for systems.
  • New Client Architecture Support - Red Hat Satellite 5.7 now supports clients running on Power LE architectures.

New User Interface in Red Hat Satellite 5.7

So now lets get started with the process of upgrading Satellite from 5.6 to 5.7. 

Make sure these prerequisites are fulfilled before you proceed with the upgrade.

  • Plan downtime as it will require the Satellite to go offline during the process (assuming Red Hat Enterprise is mostly used in Production scenarios)
  • Take a snapshot of the VM before you make any changes  (we are not responsible for any loss or corruption of data during the upgrade process)
  • This guide is for embedded database only. If you are using external db please refer Red Hat upgrade guide.
  • Make sure you have got plenty of space on "/opt" partition as cited on Red Hat Website.
    • Due to an updated version of the PostgreSQL Embedded Database, the database location has changed from /var/lib/pgsql in Red Hat Satellite 5.6 to /opt/rh/postgresql92/root/var/lib/pgsql in Red Hat Satellite 5.7. Make sure to allocate enough hard disk space to this location.
  • You need to download a copy of Red Hat Satellite 5.7 iso image from your Red Hat Customer portal download section. You need to have an active account with Red Hat for it.

Now lets start with the upgrade process.

To start with 1st take a backup of the DB.

# db-control stop
# db-control backup $BACKUP_DIR


db-control backup /rhnsat/satellite-backup_5.6/

Once completed restart the db.

# db-control start

Now you need to install some packages via YUM for the upgrade to work.

# yum -y install OpenIPMI OpenIPMI-libs ipmitool

You also need to download RHN-upgrade package as its required as well. Click to download the package rhn-upgrade-

Now install the downloaded RPM.

# rpm -ivh rhn-upgrade-

Once we are done with installing all the packages mentioned above and backing up the db, we are now good to start with the upgrade process.

First you need to mount the Red Hat Satellite 5.7 ISO image downloaded from Red Hat. You can mount the ISO image in 2 ways.

1) If the ISO image is attached to a VM through vSphere.

# mkdir /mnt/satellite-5.7
# mount /dev/cdrom /mnt/satellite-5.7

2) If the ISO image has been downloaded on the host.

# mkdir /mnt/satellite-5.7
# mount -t iso9660 -o loop /home/user1/satellite-5.7.0-20150108-rhel-6-x86_64.iso /mnt/satellite_5.7/

** Assuming the ISO image is in the user1 directory

Before you start the upgrade first stop the Satellite services and then start the upgrade.

# /usr/sbin/rhn-satellite stop
# ./install.pl --upgrade

You can check logs for the upgrade progress in this location:

# view /var/log/rhn/rhn_installation.log

This process will take around 20-25 mins. depending on the hardware resources and db size.

Now upgrade the database schema.

# /usr/bin/spacewalk-schema-upgrade

Once completed please verify that the DB schema version is upgraded. It should be something similar as below.

# rhn-schema-version
# rpm -q --qf '%{version}-%{release}\n' satellite-schema

Now Activated Red Hat Satellite 5.7 with the certificate you generated from Red Hat customer portal.

# rhn-satellite-activate --rhn-cert /home/user1/satellite-cert.xml --ignore-version-mismatch

Rebuild the search indexes for the rhn-service and restart it.

# service rhn-search cleanindex

Enable Monitoring scout

# /usr/share/spacewalk/setup/upgrade/rhn-enable-monitoring.pl --enable-scout

Now ensure that the custom values, if you have given any in rhn.conf, is reflected in the new rhn.conf file. The backup of the rhn.conf can be found in "/etc/sysconfig/rhn/"

And then lastly restart the Red Hat Satellite Services.

# /usr/sbin/rhn-satellite restart

That should be it and you should be now up and running with Red Hat Satellite 5.7 version. If any issues please do Contact Us and we will try to help you out.