Skip to main content
Version: 3.1

Add licenses to a license server using lsctl

The Portworx license server initially contains no licenses. You must add licenses to it before you can associate them with your Portworx cluster. You can activate licenses using lsctl; how you do that depends on whether your license server is capable of accessing the internet.

Prerequisites

License server must be installed before you can add licenses to it.

Add licenses to a license server using lsctl

Choose one of the following methods for adding licenses depending on whether or not your environment has access to the internet:

Activate licenses over the internet

If your license server is connected to the internet, you can add licenses by entering the activation ID provided in your onboarding materials.

Enter the lsctl license activate command, specifying your <activation-id>:

/opt/pwx-ls/bin/lsctl license activate <activation-id>
INFO[0013] Successfully activated licenses.

Add licenses using an offline activation file

If your license server is air-gapped or otherwise unable to connect to the internet, you can add licenses by obtaining an offline activation file from Portworx support and uploading and adding it to your license server:

  1. Enter one of the following lsctl commands on your main license server, depending on whether or not you're running a standalone license server, or license servers in high availability:

    • If you're running a standalone license server, enter the lsctl info hostids command:

      /opt/pwx-ls/bin/lsctl info hostids
    • If you're running license servers in high availability:

      /opt/pwx-ls/bin/lsctl ha info

    Save the output and send it to Portworx Support to obtain an offline activation file.

  2. Copy the offline activation file onto your license server.

  3. Enter the lsctl license add command, specifying your <license-file>:

    /opt/pwx-ls/bin/lsctl license add license-file.bin

Verify licenses

Once you've added your licenses, verify them by entering the /opt/pwx-ls/bin/lsctl license ls command:

/opt/pwx-ls/bin/lsctl license ls
NAME                COUNT  USED  EXPIRY
Nodes 5 2 in 78 days
DisasterRecovery 5 0 in 78 days
EnablePlatformBare 5 0 in 78 days