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 Podman Installation Instructions.
skopeo version 1.6 or higher. See Installing Skopeo.
An active skopeo session with administrative access to the private Docker registry. Authenticating to a registry, and Mirroring images for a disconnected installation.
chectl for Che version 7.84. See Installing 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 \
  --devworkspace_operator_index quay.io/devfile/devworkspace-operator-index:release-digest\
  --devworkspace_operator_version "v0.26.0" \
  --prod_operator_index "registry.access.redhat.com/redhat/community-operator-index:v4.12" \
  --prod_operator_package_name "eclipse-che" \
  --prod_operator_bundle_name "eclipse-che" \
  --prod_operator_version "v7.84.0" \
  --my_registry "<my_registry>" (1)

1	The private Docker registry where the images will be mirrored

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.84 version number is visible at the bottom of the page.

Additional resources