Upgrade Portworx using the Operator

WARNING: If you’re upgrading OpenShift to 4.3, you must change Portworx before you can do so. See the Preparing Portworx to upgrade to OpenShift 4.3 page for details.

If you’re using the Portworx Operator, you can upgrade or change your Portworx version at any time by modifying the StorageCluster spec.

Prerequisites

You must already be running Portworx through the Operator, this method will not work for other Portworx deployments

Upgrade Portworx

Enter the oc edit command to modify your storage cluster:
```
  oc edit -n kube-system <storagecluster_name>
```

Change the spec.image value to the version you want to update Portworx to:

  apiVersion: core.libopenstorage.org/v1alpha1
  kind: StorageCluster
  metadata:
    name: portworx
    namespace: kube-system
  spec:
    image: portworx/oci-monitor:<your_desired_version>

Upgrade Portworx components

In addition to managing a Portworx cluster, the Operator also manages the following other components in the Portworx platform:

Lighthouse
Stork
Autopilot

For simplicity, the Portworx Operator handles the component upgrades without user intervention. When Portworx upgrades, the Operator upgrades the installed components to the recommended version as well.

The Portworx Operator refers to the release manifest to determine which recommended component version to install for a given Portworx version. This release manifest is regularly updated for every Portworx release.

NOTE: Portworx does not recommend you update individual component versions unless absolutely necessary.

Force upgrade Lighthouse

By default, the Portworx Operator reverts back to the Lighthouse version that is intended to be used with your installed Portworx version.

To override the default behavior and change the Lighthouse image, modify the StorageCluster object:

Edit the spec.userInterface.image field, entering your desired Lighthouse version
Set the spec.userInterface.lockImage field to true, forcing Portworx to update Lighthouse to your desired version

apiVersion: core.libopenstorage.org/v1alpha1
kind: StorageCluster
metadata:
  name: portworx
  namespace: kube-system
spec:
  userInterface:
    enabled: true
    lockImage: true
    image: portworx/px-lighthouse:<your_desired_lighthouse_version>

Force upgrade Stork

By default, the Portworx Operator reverts back to the Stork version that is intended to be used with your installed Portworx version.

To override the default behavior and change the Stork image, modify the StorageCluster object:

Edit the spec.stork.image field, entering your desired Stork version
Set the spec.stork.lockImage field to true, forcing Portworx to update Stork to your desired version

apiVersion: core.libopenstorage.org/v1alpha1
kind: StorageCluster
metadata:
  name: portworx
  namespace: kube-system
spec:
  stork:
    enabled: true
    lockImage: true
    image: openstorage/stork:<your_desired_stork_version>

Force upgrade Autopilot

By default, the Portworx Operator reverts back to the Autopilot version that is intended to be used with your installed Portworx version.

To override the default behavior and change the Autopilot image, modify the StorageCluster object:

Edit the spec.userInterface.image field, entering your desired Autopilot version
Set the spec.userInterface.lockImage field to true, forcing Portworx to update Autopilot to your desired version

apiVersion: core.libopenstorage.org/v1alpha1
kind: StorageCluster
metadata:
  name: portworx
  namespace: kube-system
spec:
  userInterface:
    enabled: true
    lockImage: true
    image: portworx/autopilot:<your_desired_autopilot_version>

Deploy Portworx using the Operator

Preparing Portworx to upgrade to OpenShift 4.3 using the Operator