Skip to main content
Version: 3.3

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.