Application Delivery Management

NetScaler virtual CPU licensing

Data center administrators like you are moving to newer technologies that simplify network functions while offering lower costs and greater scalability. Newer data center architecture must include the following features in the least:

  • Software-defined networking (SDN)
  • Network function virtualization (NFV)
  • Network virtualization (NV)
  • Micro-services  

Such a movement also needs the software requirements to be dynamic, flexible, and agile to meet the ever-changing business needs. Licenses are also expected to be managed by a central management tool with full visibility into the usage.

Virtual CPU licensing for NetScaler VPX

Earlier, NetScaler VPX licenses were allocated based on the bandwidth consumption by the instances. A NetScaler VPX is restricted to use a specific bandwidth and other performance metrics based on the license edition that it is bound to. To increase the available bandwidth, you must upgrade to a license edition that provides more bandwidth. In certain scenarios, the bandwidth requirement might be less, but the requirement is more for other L7 performance such as SSL TPS and compression throughput. Upgrading the NetScaler VPX license might not be suitable in such cases. But you might still have to buy a license with large bandwidth to unlock the system resources required for CPU-intense processing. NetScaler Console now supports allocating licenses to NetScaler instance based on the virtual CPU requirements.

In the virtual CPU-usage-based licensing feature, the license specifies the number of CPUs that a particular NetScaler VPX is entitled to. So, NetScaler VPX can check out licenses for only the number of virtual CPUs running on it from the license server. NetScaler VPX checks out licenses depending on the number of CPUs running in the system. NetScaler VPX does not consider the idle CPUs while checking out the licenses.

Similar to Pooled license capacity and CICO licensing functionalities, the NetScaler Console license server manages a separate set of virtual CPU licenses. Here also, the three editions managed for virtual CPU licenses are Standard, Advanced, and Premium. These editions unlock the same set of features as those unlocked by the editions for bandwidth licenses.

There might be a change in the number of virtual CPUs or when there is a change in the license edition. In such a case, you must always shut down the instance before you initiate a request for a new set of licenses. Restart NetScaler VPX after checking out the licenses.

To configure licensing server in NetScaler VPX using GUI:

  1. In NetScaler VPX, navigate to System > Licenses and click Manage Licenses.

  2. On the License page, click Add New License.

  3. On the Licenses page, select the Use remote licensing option.

  4. Select CPU licensing from the Remote Licensing Mode list.

  5. Type the IP address of the license server and the port number.

  6. Click Continue.

    Virtual CPU licensing-1


    You must always register the NetScaler VPX instance with NetScaler Console. If not done already, enable Register with NetScaler Console and type NetScaler Console login credentials.

  7. In the Allocate licenses window, select the type of license. The window displays the total and the available virtual CPUs and also the CPUs that can be allocated. Click Get Licenses.

  8. Click Reboot on the next page to apply for the license.

    Virtual CPU licensing-3


    You can also release the current license and check out from a different edition. For example, you are already running a Standard edition license on your instance. You can release that license and then check out from Advanced edition.

Configuring a licensing server in NetScaler VPX license using CLI

In the NetScaler VPX console, type the following commands for the following two tasks:

  1. To add the licensing server to NetScaler VPX:

    add licenseserver <IP address of the license server>
  2. To apply for the licenses:

    set capacity -vcpu - edition premium

    When prompted, reboot the instance by typing the following command:

    reboot -w

Update a licensing server IP address

You can update the licensing server IP address in the NetScaler VPX instance, without any impact on the allocated license bandwidth on the instance and data loss. To update the licensing server IP address, type the following command on the NetScaler VPX instance:

add licenseserver <licensing server IP address> -forceUpdateIP

This command connects to the new server and releases the resources associated with the previous licensing server.

Managing virtual CPU licenses on NetScaler Console

  1. In NetScaler Console, navigate to Infrastructure > Pooled Licensing > Pooled VCPU.

  2. The page displays the licenses allocated for each type of license edition.

  3. Click the number within each donut to view the NetScaler instances that are using this license.


Virtual CPU licensing for NetScaler CPX

While provisioning the NetScaler CPX instance, you can configure the NetScaler CPX instance to check out licenses from the license server depending on the CPU usage on the instance.

NetScaler CPX relies on the license server, running on NetScaler Console, to manage the licenses. NetScaler CPX checks out the licenses from the license server when it is starting up. The licenses are checked in back to the license server when NetScaler CPX shuts down.

You can download the NetScaler CPX image from the Quay container registry using the ‘docker pull’ command and deploy it on your environment.

There are three license types available for NetScaler CPX licensing:

  1. Virtual CPU subscription licenses supported for NetScaler CPX and VPX

  2. Pooled Capacity licenses

  3. CP1000 licenses that support single to multiple vCPUs for NetScaler CPX only

To configure vCPU subscription licenses while provisioning the NetScaler CPX instance:

Specify the number of vCPU licenses that the NetScaler CPX instance uses.

  • This value is entered as an environment variable through Docker, Kubernetes, or Mesos/Marathon.

  • The target variable is “CPX_CORES.” NetScaler CPX can support from 1 to 16 cores.

To specify 2 cores, you can perform the docker run command as follows:

docker run -dt -P --privileged=true --ulimit core=-1 -v<host_dir>:/cpx -e EULA=yes -e CPX_CORES=2

While provisioning a NetScaler CPX instance, define the NetScaler licensing server as an environmental variable in the docker run command as shown below:

docker run -dt -P --privileged=true --ulimit core=-1 -v<host_dir>:/cpx -e EULA=yes -e CPX_CORES=2 -e LS_IP=<LS_IP_ADDRESS> -e LS_PORT=<LS_PORT> cpx:11.1


  • <LS_IP_ADDRESS> is the IP address of the NetScaler licensing server.

  • <LS_PORT> is the port of the NetScaler licensing server. By default, the port is 27000.


By default, the NetScaler CPX instance checks out the license from the vCPU subscription pool. The NetScaler CPX instance checks out an “n” number of licenses if the instance is running with “n” CPUs.

To configure NetScaler Pooled capacity or CP1000 licenses while provisioning the NetScaler CPX instance:

If you want to check out the license for the NetScaler CPX instance using the Pooled licensing (bandwidth-based) or the NetScaler CPX private pool (CP1000 or private-pool-based), you must provide the environment variables accordingly.

For example,

docker run -dt -P --privileged=true --ulimit core=-1 -v<host_dir>:/cpx -e EULA=yes -e CPX_CORES=2 -e LS_IP=<LS_IP_ADDRESS> -e LS_PORT=<LS_PORT> -e PLATFORM=CP1000 cpx:11.1

CP1000. This command triggers the checkout from CP1000 pool (NetScaler CPX private pool). The NetScaler CPX instance then retrieves “n” number of instances for “n” number of cores specified for CPX_CORES. The most common use case is to specify n = 1 for a checkout of a single instance. Multicore NetScaler CPX use cases check out “n” vCPUs (where “n” is from 1 to 7).

docker run -dt -P --privileged=true --ulimit core=-1 -v<host_dir>:/cpx -e EULA=yes -e CPX_CORES=2 -e LS_IP=<LS_IP_ADDRESS> -e LS_PORT=<LS_PORT> -e BANDWIDTH=2000 cpx:11.1

Pooled capacity. This command checks out one license from the instance pool and consumes 1000 Mbps of bandwidth from the Premium bandwidth pool yet enables NetScaler CPX to run up to 2000 Mbps. In Pooled licensing, the first 1000 Mbps is not charged.


Specify the corresponding number of vCPUs for the desired target bandwidth when checking out from the bandwidth pool as detailed in the following table:

Number of cores (vCPU) Maximum bandwidth
1 1000 Mbps
2 2000 Mbps
3 3500 Mbps
4 5000 Mbps
5 6500 Mbps
6 8000 Mbps
7 9300 Mbps
NetScaler virtual CPU licensing