第1章 Upgrade Overview

This chapter details the prerequisites and available upgrade paths to Red Hat Satellite 6.8. Review this information before upgrading your current Red Hat Satellite 6 installation.

In this guide, the terms update, upgrade, and migrate have the following meanings:

Upgrading
The process of advancing your Satellite Server and Capsule Server installations from a y-stream release to the next, for example Satellite 6.7 to Satellite 6.8.
Updating
The process of advancing your Satellite Server and Capsule Server installations from a z-stream release to the next, for example Satellite 6.8.0 to Satellite 6.8.1.
Migrating
The process of moving an existing Satellite installation to another Red Hat Enterprise Linux server.

For interactive upgrade instructions, you can also use the Red Hat Satellite Upgrade Helper on the Red Hat Customer Portal. This application provides you with an exact guide to match your current version number. You can find instructions that are specific to your upgrade path, as well as steps to prevent known issues. For more information, see Satellite Upgrade Helper on the customer portal.

Note that you can upgrade Capsules separately from Satellite. For more information, see 「Upgrading Capsules Separately from Satellite」.

1.1. Prerequisites

Upgrading to Satellite 6.8 affects your entire Satellite infrastructure. Before proceeding, complete the following:

  • Read the Red Hat Satellite 6.8 Release Notes.
  • Review this guide so that you are aware of the upgrade process and its impact.
  • Plan your upgrade path. For more information, see 「Upgrade Paths」.

  • Plan for the required downtime. Satellite services are shut down during the upgrade. The upgrade process duration might vary depending on your hardware configuration, network speed, and the amount of data that is stored on the server.

    Upgrading Satellite takes approximately 1 - 2 hours.

    Upgrading Capsule takes approximately 10 - 30 minutes.

  • Before the upgrade, create the /var/opt/rh/rh-postgresql12/ volume of the size not smaller than the existing /var/lib/pgsql/ volume. This is required because Satellite 6.8 installs PostgreSQL 12 with the rh-postgresql12-postgresql-server package from the Software Collection repository. This changes the working directory of PostgreSQL to /var/opt/rh/rh-postgresql12/.

    If an upgrade successfully completes, content of the /var/lib/pgsql directory becomes redundant because it contains a database snapshot prior the upgrade. Until there is a specific need, you can remove the directory content and the logical volume after the successful upgrade.

  • Ensure that you have sufficient storage space on your server. For more information, see Storage Requirements in Installing Satellite Server from a Connected Network and Storage Requirements in Installing Capsule Server.
  • Back up your Satellite Server and all Capsule Servers. For more information, see Backing Up Satellite Server and Capsule Server in the Administering Red Hat Satellite 6.7 guide.
  • Plan for updating any scripts you use that contain Satellite API commands because some API commands differ between versions of Satellite. For more information about changes in the API, see the Knowledgebase article API Changes Between Satellite Versions on the Red Hat Customer Portal.
警告

If you customize configuration files, manually or use a tool such as Hiera, these customizations are overwritten when the installation script runs during upgrading or updating. You can use the --noop option with the satellite-installer script to test for changes. For more information, see the Red Hat Knowledgebase solution How to use the noop option to check for changes in Satellite config files during an upgrade.