Upgrading Che using the CLI management tool in a restricted environment

This section describes how to upgrade Eclipse Che and perform minor version updates by using the CLI management tool in a restricted environment.

Prerequisites

The Che instance was installed on OpenShift using the chectl --installer operator method in the eclipse-che project. See Installing Che in a restricted environment on OpenShift.

The OpenShift cluster has at least 64 GB of disk space.
The OpenShift cluster is ready to operate on a restricted network, and the OpenShift control plane has access to the public internet. See About disconnected installation mirroring and Using Operator Lifecycle Manager on restricted networks.

An active oc session with administrative permissions to the OpenShift cluster. See Getting started with the OpenShift CLI.
An active oc registry session to the registry.redhat.io Red Hat Ecosystem Catalog. See: Red Hat Container Registry authentication.

opm. See Installing the opm CLI.
jq. See Downloading jq.
podman. See Installing Podman.
An active skopeo session with administrative access to the <my_registry> registry. See Installing Skopeo, Authenticating to a registry, and Mirroring images for a disconnected installation.
chectl for Che version 7.56. See Install the chectl management tool.

Procedure

Download and execute the mirroring script to install a custom Operator catalog and mirror the related images: prepare-restricted-environment.sh.

$ bash prepare-restricted-environment.sh \
  --ocp_ver "4.10" \
  --devworkspace_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.10" \
  --devworkspace_operator_version "v0.15.2" \
  --prod_operator_index "registry.access.redhat.com/redhat/community-operator-index:v4.10" \
  --prod_operator_package_name "eclipse-che" \
  --prod_operator_version "v7.56.0" \
  --my_registry "<my_registry>" \
  --my_catalog "<my_catalog>"

In all running workspaces in the Che previous minor version instance, save and push changes back to the Git repositories.
Stop all workspaces in the Che previous minor version instance.

Run the following command:

$ chectl server:update --che-operator-image="$TAG" -n eclipse-che --k8spodwaittimeout=1800000

Verification steps

Navigate to the Che instance.
The 7.56 version number is visible at the bottom of the page.

Additional resources