automated_upgrades.adoc

Performing Automated In-place Cluster Upgrades

• Overview
• Upgrading the EFK Logging Stack
• Upgrading Cluster Metrics
• Verifying the Upgrade

Overview

If you installed using the advanced installation and the inventory file that was used is available, you can use the upgrade playbook to automate the OpenShift cluster upgrade process.

The automated upgrade performs the following steps for you:

• Applies the latest configuration.

• Upgrades master and etcd components and restarts services.

• Upgrades node components and restarts services.

• Applies the latest cluster policies.

• Updates the default router if one exists.

• Updates the default registry if one exists.

• Updates default image streams and InstantApp templates.

Important

Ensure that you have met all prerequisites before proceeding with an upgrade. Failure to do so can result in a failed upgrade.

Upgrading the EFK Logging Stack

If you have previously deployed the EFK logging stack and want to upgrade to the latest logging component images, the steps must be performed manually as shown in Manual Upgrades.

Upgrading Cluster Metrics

If you have previously deployed cluster metrics, you must manually update to the latest metric components.

Verifying the Upgrade

To verify the upgrade:

1. First check that all nodes are marked as Ready:

   # oc get nodes
   NAME                        STATUS                     AGE
   master.example.com          Ready,SchedulingDisabled   165d
   node1.example.com           Ready                      165d
   node2.example.com           Ready                      165d

2. Then, verify that you are running the expected versions of the docker-registry and router images, if deployed.

3. After upgrading, you can use the diagnostics tool on the master to look for common issues:

   # oc adm diagnostics
   ...
   [Note] Summary of diagnostics execution:
   [Note] Completed with no errors or warnings seen.