Upgrade Portworx CSI license to Portworx Enterprise license

Upgrading your Portworx CSI license to a Portworx Enterprise license allows you to unlock additional features and capabilities. This guide provides step-by-step instructions for upgrading the license on a Portworx cluster, either connected to the internet or air-gapped without causing downtime on your clusters.

important

You cannot roll back to PX-CSI after upgrading to Portworx Enterprise.

Prerequisite

• Ensure you have an installed Portworx cluster, using either a FlashArray or a FlashBlade as Direct Access volumes.

Check the current cluster status

1. Connect to one of the Portworx nodes.

2. Check the current cluster status:

   pxctl status

From the output, verify that the current license is Portworx CSI for FA/FB.

Switch from Portworx CSI to Enterprise

1. Modify the StorageCluster object by removing the --oem esse annotation from the StorageCluster object to disable the OEM Essentials mode.

   kind: StorageCluster
   apiVersion: core.libopenstorage.org/v1
   metadata:
     annotations:
       portworx.io/misc-args: "--oem esse"  # Remove this line

2. Save and apply the changes to the cluster. The system will initiate a gradual, node-by-node transition to Portworx Enterprise.

3. Once the transition begins, Portworx will automatically switch to the Portworx Enterprise container image (docker.io/portworx/px-enterprise). This process will activate a 30-day Trial License for Portworx Enterprise.

Activate license

Activate the Enterprise license using an activation ID

If your cluster is connected to the internet, you can activate the license using an activation ID.

1. Activate the license:

   pxctl license activate <your-activation-id>

2. Check the current cluster status again:

   pxctl status

Activate the license on an air-gapped cluster using cluster UUID

For air-gapped clusters, you need to use the cluster UUID to activate the license.

1. Get the cluster UUID and contact Portworx:

   pxctl cluster list

2. Upon providing the cluster UUID, you will receive a license file. Upload this file to one of the Portworx nodes and activate the license by running:

   pxctl license add license_file.bin

By following these steps, you can successfully upgrade your Portworx CSI license to a Portworx Enterprise license, enabling advanced features and enhanced performance for your cluster.