License operations using pxctl
This document explains how to manage your Portworx licenses with
pxctl license
. The CLI lets you add, activate, and transfer licenses. It also gives details about the installed licenses, and it shows what features are available within a given license.
Overview
Here’s how to get the list of the available subcommands:
pxctl license --help
Manage licenses
Usage:
pxctl license [flags]
pxctl license [command]
Available Commands:
activate Activate license from a license server
add Add a license from a file
list List available licenses
transfer Transfer license to remote PX cluster
Flags:
-h, --help help for license
Global Flags:
--ca string path to root certificate for ssl usage
--cert string path to client certificate for ssl usage
--color output with color coding
--config string config file (default is $HOME/.pxctl.yaml)
--context string context name that overrides the current auth context
-j, --json output in json
--key string path to client key for ssl usage
--raw raw CLI output for instrumentation
--ssl ssl enabled for portworx
Use "pxctl license [command] --help" for more information about a command.
Now, let’s have a closer look at these commands.
List available licenses
You can use pxctl license list
to list installed licenses as follows:
pxctl license list
DESCRIPTION ENABLEMENT ADDITIONAL INFO
Number of nodes maximum 1000
Number of volumes maximum 100000
Volume capacity [TB] maximum 40
Storage aggregation yes
Shared volumes yes
Volume sets yes
BYOK data encryption yes
Resize volumes on demand yes
Snapshot to object store [CloudSnap] yes
Cluster-level migration [Kubemotion] yes
Bare-metal hosts yes
Virtual machine hosts yes
Product SKU Trial expires in 6 days, 12:13
LICENSE EXPIRES: 2019-04-07 23:59:59 +0000 UTC
For information on purchase, upgrades and support, see
https://docs.portworx.com/knowledgebase/support.html
As you can see, the command gives details on the features allowed under the current licenses and it also lists the SKU.
Activate a license
The easiest way to activate a license is to get an activation id from Portworx. Next, run the following:
pxctl license activate <activation-id>
However, there are cases where the servers are configured without access to the Internet. Such customers should request an offline-activation license file, and install it like this:
pxctl license add <license file>