Application Delivery Management

NetScaler license management for Flexed and Pooled licensing

Note:

When you purchase a Universal Hybrid Multi-Cloud (UHMC) or a Citrix Platform License (CPL), the NetScaler licenses delivered are referred to as Flexed licenses.

Flexed licenses are supported in NetScaler Console on-prem 14.1 and 13.1 releases. For a better product experience showcasing Flexed GUI and offering bundled entitlement, we recommend upgrading your NetScaler Console on-prem to release 14.1-12.34 or later.

In NetScaler Console on-prem release 14.1-12.34 and later:

  • You can manage Flexed licenses through the Flexed dashboard UI (NetScaler Licensing > Flexed Licensing).
  • Bundled entitlement of unlimited NetScaler Console VIPs for analytics is available if you apply Flexed licenses.

For NetScaler Console on-prem release 13.1 and 14.1 builds earlier than 14.1-12.34:

  • When you apply Flexed licenses, NetScaler Console treats them the same as Pooled licenses and shows the details in the Pooled dashboard UI (Infrastructure > Pooled Licensing).
  • When the Flexed license is applied, the bundled entitlement of unlimited NetScaler Console VIPs for analytics is not available in these releases.

License files

NetScaler Flexed license includes the following files that you must download from the MyCitrix portal. For more information about transitioning from your current type of NetScaler licensing to Flexed Licensing, see Transition to Flexed licensing.

The license files present on your NetScaler are listed in this section.

File name contains Description Download information Where to upload/apply the license
NetScaler Flexed VPX SW Instance Entitles you to VPX/CPX/BLX software instances Download this file using your NetScaler Console host ID On NetScaler Console
NetScaler Flexed MPX SW Instance Entitles you to MPX software instances Download this file using your NetScaler Console host ID On NetScaler Console
NetScaler Flexed SDX SW Instance Entitles you to SDX software instances Download this file using your NetScaler Console host ID On NetScaler Console
NetScaler Flexed Platinum BW Entitles you to Flexed Platinum throughput capacity Download this file using your NetScaler Console host ID On NetScaler Console
NetScaler Flexed VPX FIPS SW Instance Entitles you to VPX FIPS software instances Download this file using your NetScaler Console host ID On NetScaler Console
Zero Capacity MPX-Z Platform License Entitles you to make your NetScaler MPX HW participate in Flexed licensing Download this file On NetScaler MPX
Zero Capacity SDX-Z Platform License Entitles you to make your NetScaler SDX HW participate in Flexed licensing Download this file On NetScaler SDX

Important points to note

  1. If you are a Pooled licensing customer transitioning to Flexed licensing and your MPX and SDX hardware already has Z-Cap Perpetual licenses, then you don’t need to apply the Z-Cap licenses received with Flexed. However, if the current Z-Cap licenses that are applied on NetScaler MPX/NetScaler SDX are valid for a specific period, then you must apply the Z-Cap licenses received with the Flexed license. Flexed software license includes NetScaler Flexed MPX/SDX/VPX/VPX FIPS software instance and NetScaler Flexed Platinum bandwidth licenses.

  2. You must apply the Flexed licenses on NetScaler Console for the NetScalerform factor that you are using in your deployment. For example:

    Apply the following licenses if you are using NetScaler SDX form factor:

    License File Apply on
    NetScaler Flexed SDX SW Instance NetScaler Console
    NetScaler Flexed VPX SW Instance NetScaler Console
    NetScaler Flexed Platinum BW NetScaler Console
    ADC Zero Capacity SDX-Z Platform NetScaler SDX

    Apply the following licenses if you are using NetScaler MPX form factor:

    License File Apply on
    NetScaler Flexed MPX SW Instance NetScaler Console
    NetScaler Flexed Platinum BW NetScaler Console
    ADC Zero Capacity MPX-Z Platform NetScaler MPX

    Apply the following licenses if you are using NetScaler VPX, NetScaler BLX or NetScaler CPX form factor:

    License File Apply on
    NetScaler Flexed VPX SW Instance NetScaler Console
    NetScaler Flexed Platinum BW NetScaler Console

    Apply the following licenses if you are using NetScaler VPX FIPS form factor

    License File Apply on
    NetScaler Flexed VPX FIPS SW Instance NetScaler Console
    NetScaler Flexed Platinum BW NetScaler Console

Apply a license file

You can add, delete, and download licenses. You must apply licenses before they can be used.

  1. Navigate to NetScaler Licensing > License Management.
  2. In the License Files section, click Add License File and 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 NetScaler Console.
    • Use license access code: Specify the license access code for the license that you have purchased from Citrix. Click Get Licenses and then click Finish.
  3. Click Finish. The license files are added to NetScaler Console. The License Expiry Information section lists the licenses present in NetScaler Console, count, and the remaining days to expiry.

    The following screenshot shows the number of Flexed NetScaler VPX, NetScaler MPX, NetScaler SDX, and NetScaler VPX FIPS software instance licenses, Flexed premium bandwidth capacity present and the days to expiry.

    Flexed license expiry

    The following screenshot shows the Pooled Standard, Advanced, and Premium bandwidth available and the days to expiry.

    Pooled license expiry

  4. Select a license file and click Apply licenses.

Delete a license file

To delete a license file, select one or more files and click Delete. When you delete a license, you must first add the license and only then you can apply it.

Download a license file

To download a license file, select a file and click Download. You can save the license file offline as a backup.

License server port settings

Ports are used by NetScaler instances to communicate with the license server. Click the Edit icon and specify values for the following parameters:

  • License Server Port: The proxy server port used by NetScaler instances to access the Citrix licensing portal for license allocation. Default value: 27000.
  • Vendor Daemon Port: The license server port used by NetScaler instances to communicate with the license server. Default value: 7279.
  • Proxy Server Port: NetScaler Console can be used as a forward HTTP proxy for NetScaler instances to access the MyCitrix Portal for automated license retrieval. To enable this feature, specify a TCP port the proxy listens on.

License expiry information

You can now configure the license expiry threshold for Flexed or Pooled capacity licenses. When the threshold is set, NetScaler Console sends notifications via email or SMS when a license is due to expire. An SNMP trap and a notification are also sent when the license has expired on NetScaler Console.

An event is generated when a license expiry notification is sent and this event can be viewed on NetScaler Console from Infrastructure > Events.

View license expiry

  1. Navigate to NetScaler Licensing > License Management.
  2. In the License Settings page, under the License Expiry Information section, you can find the details of the licenses that are going to expire:
    • Feature: Type of license that is going to expire.
    • Count: Number of virtual servers or instances that are affected.
    • Days to expiry: Number of days before license expiry.

Note:

When you add new licenses to the pool, the NetScaler instances use the new licenses on the expiry of their existing licenses.

Notification settings

Specify the settings based on which notifications will be sent out about license allocation and days to expiry.

  1. In the Notification Settings section, click the Edit icon and select Notify me on license usage. Set the alert threshold as a percentage of Flexed or Pooled license capacity to be allocated to send a notification.
  2. Choose the type of notification that you want to send when licenses reach the threshold, or going to expire by selecting the appropriate checkbox. The notification types are as follows. Select a notification type and click Add to add details. You can also test that each notification is delivered before saving your settings.
    • Email: Email profile or distribution list for sending notifications. For more information, see Create an email distribution list.
    • SMS: SMS profile or distribution list for sending notifications.
    • Slack: Slack profile details for sending notifications.
    • PagerDuty: PagerDuty profile for sending notifications.
    • ServiceNow: The Citrix ServiceNow profile is specified by default and is the only option available currently. For more information about creating these profiles, see Configure notifications
  3. Specify the Days to Expiry, which is the number of days before which you would like to be notified about the license expiry.
  4. Click Save.

Create an email distribution list

Perform the following steps to create an email distribution list:

  1. Select Email and click Add.
  2. In Create Email Distribution List, specify the following details:
    • Name - Specify the distribution list name.
    • Email Server - Select the email server that sends an email notification. To add an email server, click Add. Specify the server name/IP address and port. Select Authentication to mandate authentication to access the email server. Select Secure if the email server supports SSL authentication. Click Create.
    • From - Specify the email address from which the NetScaler Console sends the message.
    • To - Specify the email addresses to which the NetScaler Console send the message.
    • Cc - Specify the email addresses to which the NetScaler Console copies the message.
    • Bcc - Specify the email addresses to which the NetScaler Console blind carbon copies (does not display the email address) the message.
  3. Click Create.

Create an SMS distribution list

Perform the following steps to configure SMS notification settings:

  1. In SMS, click Add.
  2. In Create SMS Distribution List, specify the following details:
    • Name - Specify the distribution list name.
    • SMS Server - Select the SMS server that sends SMS notifications. To add an SMS server, click Add. Specify the server details and click Create.
    • To - Specify the phone number to which the NetScaler Console sends the message.
  3. Click Create.

Create a Slack profile

Perform the following steps to create a Slack profile:

  1. In Slack, click Add.
  2. In Create Slack Profile, specify the following details:
    • Profile Name - Specify the profile name. This name appears in the Slack profile list.
    • Channel Name - Specify the Slack channel name to which the NetScaler Console sends the notification.
    • Webhook URL - Specify the Webhook URL of the channel. Incoming Webhooks are a simple way to post messages from external sources into Slack. The URL is internally linked to the channel name. All event notifications that are sent to this URL are posted on the designated Slack channel. An example of a webhook is as follows: https://hooks.slack.com/services/T0******E/B9X55DUMQ/c4tewWAiGVTT51Fl6oEOVirK.

Create a PagerDuty profile

PagerDuty enables you to configure notifications through email, SMS, push notifications, and phone calls on a registered number. Before you add a PagerDuty profile in NetScaler Console, ensure you have completed the required configurations in PagerDuty. To get started with PagerDuty, see the PagerDuty documentation.

Perform the following steps to create a PagerDuty profile:

  1. In PagerDuty, click Add.
  2. In Create PagerDuty Profile, specify the following details:
    • Profile Name - Specify a profile name. This name is used by different modules, such as event rules and SSL notifications to send PagerDuty alerts.
    • Integration Key - Specify the integration key. You can obtain this key from your PagerDuty portal.
  3. Click Create.

For more information, see Services and Integrations in the PagerDuty documentation.

View the ServiceNow profile

To enable ServiceNow notifications for NetScalerevents and the NetScaler Console events, you must integrate NetScaler Console with the ServiceNow using ITSM connector. For more information, see Integrate NetScaler Console with the ServiceNow instance.

Perform the following steps to view and verify the ServiceNow profile:

  1. In ServiceNow, Citrix_Workspace_SN profile is selected by default.
  2. Click Test to auto-generate a ServiceNow ticket and verify the configuration.

Note:

For information about the different types of NetScaler licenses, see Licensing overview.

NetScaler license management for Flexed and Pooled licensing