Upgrade Portworx in OCP GCP

caution

If you're upgrading OpenShift to 4.12 or newer, you must change Portworx before you can do so. See the OCP upgrade 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. In addition to managing a Portworx cluster, the Operator also manages the following other components in the Portworx platform:

• 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.

Prerequisites

Upgrade Portworx

note

• If using configmap, update the version manifest for Portworx Operator. Otherwise, you might not see the expected image versions.
• If you override the default PodDisruptionBudget, ensure that the storage-pdb-min-available value is greater than or equal to OCP's MCP maxUnavailable.

note

• If you override the default PodDisruptionBudget in OpenShift platforms, ensure that the storage-pdb-min-available value is greater than or equal to OCP's MCP maxUnavailable.
• If you override the default PodDisruptionBudget in GKE environments, ensure that the maxUnavailable is less than the storage-pdb-min-available value for a balanced speed and disruption. Portworx by Pure Storage recommends using the following configurations for surge upgrades:
  • maxSurge=1
  • maxUnavailable=0

1. Identify Your StorageCluster:

   Retrieve the name of your Portworx storage cluster within the appropriate namespace:

   oc get storagecluster -n <px-namespace>

   NAME                                            STATUS   VERSION   AGE
   px-cluster-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx Online   2.10.3    43d

   If your cluster is installed in a different namespace, specify it using the -n flag.

2. Edit the StorageCluster:

   Modify the StorageCluster resource to update Portworx to the desired version:

   oc edit storagecluster -n <px-namespace> <storagecluster-name>

   In the editor, change the spec.image field to your desired Portworx version:

   apiVersion: core.libopenstorage.org/v1
   kind: StorageCluster
   metadata:
      name: portworx
      namespace: <px-namespace>
   spec:
      image: portworx/oci-monitor:<desired-version>
   note

   • If there are any component images configured in the StorageCluster, such as the spec.stork.image or spec.autopilot.image fields, you need to update the image fields to the latest version.
   • To look up recent versions, refer to the following release notes:
     • Portworx release notes
     • Autopilot release notes
     • Stork release notes

3. Verify the Upgrade:

   Confirm the upgrade by checking the Portworx version on the nodes:

   oc get storagenodes -n <px-namespace> -l name=portworx

   NAME       ID                                     STATUS   VERSION          AGE
   node-1-1   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   Online   <desired-version>   10d