Chapter 5. Upgrading CodeReady Workspaces

This chapter describes how to upgrade a CodeReady Workspaces instance to CodeReady Workspaces 2.1.

5.1. Upgrading CodeReady Workspaces using OperatorHub

This section describes how to upgrade from CodeReady Workspaces 2.0 to CodeReady Workspaces 2.1 on OpenShift 4 using the OpenShift web console. This method is using the Operator from OperatorHub.

Prerequisites

  • An administrator account on an OpenShift 4 instance.
  • An instance of CodeReady Workspaces 2.0, running on the same instance of OpenShift 4, installed using an Operator from OperatorHub.

Procedure

  1. Open the OpenShift web console.
  2. Navigate to the Operators → Installed Operators section.
  3. Click Red Hat CodeReady Workspaces in the list of installed operators.

  4. Navigate to the Subscription tab and enable the following options:

    • Channel: latest
    • Approval: Automatic

Verification steps

  1. Log in to the CodeReady Workspaces instance.
  2. The 2.1 version number is visible at the bottom of the page.

5.2. Upgrading CodeReady Workspaces using CLI management tool on OpenShift 3

This section describes how to upgrade from CodeReady Workspaces 2.0 to CodeReady Workspaces 2.1 on OpenShift 3 using the CLI management tool.

Prerequisites

  • An administrative account on an OpenShift 3 instance.
  • A running instance of Red Hat CodeReady Workspaces running on OpenShift 3, installed using the CLI management tool.
  • The crwctl management tool installed.

Procedure

  1. In all running workspaces in the CodeReady Workspaces 2.0 instance, save and push changes to Git repositories.

  2. Run the following command: 

    $ crwctl server:update

Verification steps

  1. Log in to the CodeReady Workspaces instance.
  2. The 2.1 version number is visible at the bottom of the page.

5.3. Upgrading CodeReady Workspaces from previous major version

This sections describes how to perform an upgrade from the previous major version of Red Hat CodeReady Workspaces (1.2).

Procedure