---
name: openshift-storage-portworx-update
title: Updating Portworx in your cluster
description: When you update a worker node in a VPC cluster, the worker node is removed from your cluster and replaced with a new worker node. If Portworx volumes are attached to the worker node that you replaced, you must attach the volumes to the new worker node.
last-updated: 2026-04-07
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/openshift?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Updating Portworx in your cluster
{: #storage_portworx_update}

If you use Portworx in a classic cluster, see [Updating Classic worker nodes](https://cloud.ibm.com/docs/openshift?topic=openshift-update&interface=ui&format=markdown#worker_node). The following steps focus on VPC worker node updates.


## VPC: Updating worker nodes with Portworx volumes
{: #portworx_vpc_up}

[Virtual Private Cloud]{: tag-vpc} 

When you update a worker node in a VPC cluster, the worker node is removed from your cluster and replaced with a new worker node. If Portworx volumes are attached to the worker node that you replaced, you must attach the volumes to the new worker node.
{: shortdesc}

Update only one worker node at a time. After the worker node update is complete, reattach your Block Storage for VPC volume and restart the Portworx pod.
{: important}


1. [Enter maintenance mode on the worker nodes that you want to update](https://docs.portworx.com/portworx-enterprise/operations/troubleshooting/enter-maintenance-mode){: external}.

2. [Update your VPC worker nodes](https://cloud.ibm.com/docs/openshift?topic=openshift-update&format=markdown#vpc_worker_node).

3. [Attach raw Block Storage for VPC to your worker nodes](https://cloud.ibm.com/docs/openshift?topic=openshift-utilities&format=markdown#vpc_api_attach).

4. Verify that your storage is attached by running the following command.
    ```sh
    oc get pv -o yaml | grep "attachstatus"
    ```
    {: pre}

5. Restart the Portworx pod on the new worker node.
    ```sh
    oc delete pod <portworx_pod> -n <portworx_namespace>
    ```
    {: pre}

6. Exit maintenance mode.
    ```sh
    pxctl service maintenance --exit
    ```
    {: pre}

7. [Mount the volume to your app](https://cloud.ibm.com/docs/openshift?topic=openshift-storage_portworx_deploy&format=markdown#mount_pvc).