Product Documentation

Configure NetScaler pooled capacity

You can allocate licenses in the license pool to NetScaler instances on demand. You can upload the pooled capacity license files (Bandwidth Pool or Instance Pool) to the license server. You can allocate the licenses from NetScaler MAS, or you can check-out the licenses from NetScaler instance (MPX-Z /SDX-Z/VPX/CPX) according to the minimum and maximum capacity of the instance.

localized image

Supported Hardware and Software Versions

NetScaler Software Version NetScaler MPX Zero-Capacity Hardware NetScaler SDX Zero-Capacity Hardware Supported Hypervisors for NetScaler VPX
11.1 Build 54.14 and later MPX-14000Z, MPX-14000Z-40G, MPX-25000Z-40G SDX-14000Z, SDX-14000Z-40G, SDX-25000Z-40G VMWare ESX 6.0, Citrix XenServer, Linux KVM
12.0 Build 51.24 and later     Microsoft Hyper-V, Amazon AWS, Microsoft Azure

Configuring the License Server

You need to configure the license server to pool and allocate the licenses to the pooled-capacity enabled instances, or check-out licenses from the NetScaler pooled capacity enabled instance.

Note

You need to configure the license server to pool and allocate the licenses to the pooled-capacity enabled instances, or check-out licenses from the NetScaler pooled capacity enabled instance.

NetScaler Management and Analytics System

You can configure the NetScaler Management and Analytics System as a license server for the NetScaler Pooled capacity. There are two ways for a NetScaler Instance to get bandwidth and or instance license:

  • A NetScaler instance can initiate the check-out request to NetScaler MAS to obtain its bandwidth and/or instance licenses.
  • The licenses can be allocated to a NetScaler instance through NetScaler MAS.

Note

Pooled Capacity is displayed on NetScaler MAS only if pooled licenses are added to the NetScaler MAS.

Following are the operating modes of the NetScaler instances that are using the NetScaler Pooled Capacity:

  • Optimum – Instance is running with proper license capacity.
  • Capacity mismatch – instance is running with a capacity less than user configured.
  • Grace - Instance is running on grace license.
  • Grace & Mismatch – Instance is running on grace but with a capacity less than user configured.
  • Not available – Instance is not registered with NetScaler MAS for management or Nitro communication from NetScaler MAS to Instance is not working.
  • Not allocated – License is not allocated in instance.

To install license files on the NetScaler Management and Analytics System:

  1. In a web browser, type the IP address of the NetScaler Management and Analytics System (for example, http://192.168.100.1).
  2. In User Name and Password, enter the administrator credentials.
  3. Navigate to Networks > Licenses.
  4. In the License Files section, select one of the following options:

    • Upload license files from a local computer - If a license file is already present on your local computer, you can upload it to the NetScaler MAS. To add license files, click Browse and select the license file (.lic) that you want add. Then click Finish.

      Note

      If the uploaded license files does not add the licenses in the NetScaler Pooled capacity, you can select the license files and click Apply Licenses to add the licenses to the pool.

      localized image

    • Use license access code - Citrix emails the License Access Code (LAC) for the licenses that you purchase. To add license files, enter the LAC in the text box and then click Get Licenses.

      localized image

      Note

      At any time, you can add more licenses to the NetScaler Management and Analytics System (MAS) from the License Settings.

To allocate NetScaler Pooled Capacity licenses from the NetScaler Management and Analytics System:

Prerequisite: Before you can manage your instance’s pool licenses through the NetScaler Management and Analytics System (MAS), you must register the NetScaler instance with the NetScaler MAS. In the NetScaler GUI, navigate to System > Licenses > Manage Licenses and select the Register with NetScaler MAS for manageability check box when adding the NetScaler MAS IP.

Note

If you have not registered the NetScaler instance with NetScaler MAS, you can check-out licenses from NetScaler MAS, but cannot allocate from NetScaler MAS to the NetScaler pooled capacity enabled Instance.

localized image

Note

In the Username and Password fields on the above screen, enter the NetScaler Management and Analytics System credentials.

After the instance is registered with the license server, allocate the licenses as follows:

  1. In a web browser, type the IP address of the NetScaler Management and Analytics System (for example, http://192.168.100.1).
  2. In User Name and Password, enter the administrator credentials.
  3. On the Configuration tab, navigate to Networks > Licenses > Pooled Capacity.
  4. Click on the license pool that you want to manage.
  5. Select a NetScaler instance from the list of available instances by clicking on the > button.

    localized image

  6. If you want to change or release a license allocation, click Change allocation or Release allocation.

    localized image

  7. If you click Change allocation, a pop-up window with the available licenses in the license server appears.

    localized image

  8. You can choose the bandwidth or instance allocation to the NetScaler instance by setting the Allocate drop-down options. After making your selections, click Allocate.

  9. You can also change the allocated license edition from the drop-down options in the Change License Allocation window.

Citrix Licensing Server

The Citrix License Server (Windows or VPX) can be used to serve NetScaler Pooled Capacity licenses. You can check-out licenses from the Citrix Licensing Server to the pooled capacity enabled instances (MPX-Z/SDX-Z/VPX/CPX), but cannot allocate licenses from the Citrix Licensing Server to the pooled capacity enabled instances.

Note

You can always change your NetScaler pooled capacity enabled Instances to use a different license server (NetScaler Management and Analytics System or Citrix Licensing Server) by entering a new license server’s IP address in the System > Licenses section of the NetScaler Instance’s GUI. It is recommended to check-in the licenses to the old licensing server and check-out again from new licensing server.

Configuring NetScaler Pooled Capacity on MPX-Z

MPX-Z is the NetScaler pooled-capacity enabled NetScaler MPX appliance. MPX-Z supports bandwidth pooling for Platinum, Enterprise, or Standard edition licenses.

MPX-Z require its platform licenses before it can connect to the license server. You can install the MPX-Z platform license by either uploading the license file from a local computer or using the instance’s hardware serial number, or the License Access Code from System > Licenses section of the NetScaler Instance’s GUI. If you remove the MPX-Z platform license, the pooled-capacity feature is disabled and all the checked-out licenses are checked in to the license server.

You can dynamically modify the Bandwidth of a MPX-Z instance without a restart. A restart is required only if you want to change the license edition.

Note

When you restart the instance, it automatically checks out the pooled licenses required for its configured capacity.

Configuring NetScaler Pooled Capacity on a NetScaler VPX Instance

A pooled-capacity enabled NetScaler VPX instance can check-out licenses from a bandwidth pool (Platinum/Enterprise/Standard editions). You can use the NetScaler GUI to check-out licenses from the license server.

You can dynamically modify the Bandwidth of a VPX instance without a restart. A restart is required only if you want to change the license edition.

Note

When you restart the instance, it will automatically check-out the pooled licenses required for its configured capacity.

Allocating Pool Licenses to a NetScaler MPX-Z or NetScaler VPX Instance

To allocate your licenses:

  1. In a web browser, type the IP address of the NetScaler instance (for example, http://192.168.100.1).

  2. In the User Name and Password fields, enter the administrator credentials.

  3. On the Configuration tab, navigate to System > Licenses > Manage Licenses, click Add New License and select Use Pooled Licensing.

    localized image

  4. Enter the details of the license server in the Server Name/IP Address field.

  5. If you want to manage your instance’s pool licenses through the NetScaler Management and Analytics System (MAS), select the Register with NetScaler MAS for manageability check box and enter the NetScaler Management and Analytics System credentials.

  6. Select the license edition and the required bandwidth, click Get Licenses.

    localized image

  7. You can change or release the license allocation by selecting Change allocation or Release allocation.

    localized image

  8. If you click Change allocation, a pop-up window shows the licenses available on the license server.

    Note

    A restart is not required if you change the bandwidth allocation, but a warm restart is required if you change the license edition.

    localized image

  9. You can allocate bandwidth or instances to the NetScaler instance from the Allocate drop-down list. Then click Get Licenses.

  10. You can choose the license edition and the bandwidth required from the drop-down lists in the pop-up window.

    Note

    Bandwidth allocation should be a multiple of the minimum bandwidth unit.

Configuring NetScaler Pooled Capacity on SDX-Z

An SDX-Z instance is a pooled-capacity enabled instance of NetScaler SDX. SDX-Z supports bandwidth pooling for Platinum, Enterprise, and Standard editions, and instance pooling. After you apply the SDX-Z platform license, the Management Service provides options for checking

licenses out from and back into the licensing server, and for allocating bandwidth capacity to the NetScaler instances running on the SDX-Z platform.

Note

NetScaler VPX instances running on SDX-Z cannot directly check licenses out from or in to the license server. This can be done by the Management Service in SDX.

You can install the SDX-Z platform license by either uploading the license file from the local computer or using the instance’s hardware serial number, or the License Access Code.

If you remove the SDX-Z platform license, the pooled-capacity feature is disabled and all the licenses are checked back into the licensing server.

Note

If you reboot the instance, it checks-out the pooled licenses required for its configured capacity.

Pool Capacity on NetScaler SDX

Instance Pool:

An SDX appliance can provision same number of instances that are available in the instance pool of the SDX appliance.

Bandwidth Pool:

During NetScaler instance provisioning, bandwidth is allocated to the instance. You can select the edition and required bandwidth to provision a Virtual NetScaler instance. The Management Service allows the provisioning to continue only if the instance has sufficient bandwidth for the requested edition. You are notified if the bandwidth is insufficient.

Note

Bandwidth modification does not require an instance restart.

Allocating Pool Licenses to a NetScaler SDX-Z Instance

To allocate your licenses:

  1. In a web browser, type the IP address of your NetScaler SDX-Z instance (for example, http://192.168.100.1).

  2. In the User Name and Password fields, enter the administrator credentials.

  3. On the Configuration tab, navigate to System > Licenses, and go to Pooled Capacity.

    localized image

  4. Enter the details of the license server in the Server Name/IP Address field.

  5. If you want to manage your instance’s pool licenses through the NetScaler Management and Analytics System (MAS), select the Register with NetScaler MAS check box and enter the NetScaler Management and Analytics System credentials.

  6. You can change or release the license allocation by selecting Change allocation or Release allocation.

    Note

    The checked out licesnses are stored in a separate pool by the Management Service.

    localized image

  7. To change the license allocation for a specific VPX instance in the SDX-Z instance, select the instance from the Instances section, and click Change allocation. A new window displays the available licenses.

    localized image

  8. You can change the bandwidth edition of the instance from the Feature License drop-down list, and the required bandwidth in the Throughput(mbps) field. Then click Done.

    Note

    Bandwidth allocation should be an integer multiple of the minimum bandwidth unit of the corresponding form factor.

Configuring NetScaler Pooled Capacity on a NetScaler CPX Instance

While provisioning the NetScaler CPX instance, you can configure the NetScaler CPX instance to use NetScaler Pooled Capacity. In the docker run command, you need to provide the NetScaler Licensing Server (NetScaler MAS) details. The NetScaler CPX instance checks-out licenses from the Instance pool.

Note

By default, NetScaler CPX instance checks-out an instance license from the instance pool and the throughput is automatically set to 1000 Mbps. You cannot modify the 1000 Mbps bandwidth allocated to the instance.

You can download NetScaler CPX from the Docker App Store. On the Docker host, to download NetScaler CPX, run the following command:

docker pull store/citrix/netscalercpx: <version>

To configure NetScaler Pooled Capacity while provisioning the NetScaler CPX Instance:

While provisioning a NetScaler CPX instance, define the NetScaler Licensing Server (NetScaler MAS) as an environmental variable in the docker run command as shown below:

docker run -dt -P -e LS_IP=<LS_IP_ADDRESS> -e LS_PORT=<LS_PORT> --name <container_name> --ulimit core=-1 -e EULA=yes -v <host_dir>:/cpx --cap-add=NET_ADMIN <REPOSITORY>:<TAG>

Where:

  • <LS_IPADDRESS> is the IP address of the NetScaler Licensing Server (NetScaler MAS).
  • <LS_PORT> is the port of the NetScaler Licensing Server. By default, the port is 27000.