Licensing
https protocol.
-
For build 13.1-9.x or earlier, you can manage up to 30 discovered applications or virtual servers and view analytics. Beyond the 30 discovered applications or the 30 virtual servers, you must buy and apply an Advanced license. For example, if you buy 100 virtual server licenses, then you are entitled to you use up to 130 virtual server licenses.
-
For build 13.1-12.x or later, you can manage up to two discovered applications or virtual servers and view analytics. Beyond the two discovered applications or the two virtual servers, you must buy and apply an Advanced license. For example, if you buy 100 virtual server licenses, then you are entitled to you use up to 102 virtual server licenses.
-
All the Express default free virtual servers remain functional for 30 days. You can select the 2 virtual servers and apply the 2 default licenses within the 30 days grace period. If no user action is taken 30 days post upgrade, ADM randomly applies license to 2 virtual servers and unlicenses the remaining virtual servers. You must buy and apply new Advanced licenses to enable these virtual servers.
-
Post upgrade, the following are the changes in the ADM behavior:
-
ADM enforces a 30-day grace period.
-
Within the 30-day grace period, the allocation of new virtual servers for the 30 express free virtual servers is blocked.
-
For example, if the number of available virtual server licenses before you upgraded to 12.x was 30 and only 20 licensed virtual servers were used, you are only allowed to use the 20 virtual servers and not allowed to license the remaining 10 virtual servers in the 30-day grace period.
-
-
However, within the 30-day grace period, as an administrator, you can still apply Advanced ADM licenses and allocate new virtual servers.
-
| Features | Options | Express edition | Advance edition | NetScaler License |
|---|---|---|---|---|
| Applications | Application Dashboard | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | NetScaler Web App Firewall related information on App Dashboard needs Premium (or) Advanced with App Firewall license. |
| Web Insight | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | NA | |
| Service Graph | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | NA | |
| Configuration > StyleBooks | Unlimited | Unlimited | NA | |
| Security | Security Dashboard | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | NetScaler Web App Firewall related information on Security Dashboard needs Premium (or) Advanced with App Firewall license. |
| Security Violations | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | Premium (or) Advanced with App Firewall license | |
| Users and endpoints | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | NA | |
| Gateway | HDX Insight | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | Advanced (reporting < 1 hour) Premium (reporting = Unlimited) |
| Gateway Insight | Up to two virtual servers. | Entitled for all purchased virtual server licenses and extra two virtual servers. | Advanced (reporting < 1 hour) Premium (reporting = Unlimited) | |
| Infrastructre | Infrasturcture Analytics | Unlimited | Unlimited | NA |
| Instances | Unlimited | Unlimited | NA | |
| SSL Dashboard | Unlimited | Unlimited | NA | |
| Events | Unlimited | Unlimited | NA | |
| Network Functions | Unlimited | Unlimited | NA | |
| Network Reporting | Unlimited | Unlimited | NA | |
| Pooled licenses | Unlimited | Unlimited | NA | |
| Configuration > Configuration Jobs, Configuration Templates, and Configuration Advice | Unlimited | Unlimited | NA | |
| Upgrade Jobs | Unlimited | Unlimited | NA | |
| Orchestration | Unlimited | Unlimited | NA | |
| Settings | RBAC & External Authentication (instance level) | Unlimited | Unlimited | NA |
| RBAC & External Authentication | Unlimited | Unlimited | NA |
High Availability
-
If you have installed NetScaler ADM 12.1.49.x or earlier releases, you get a grace period of 30 days to maintain the licensing on the secondary node. After the grace period, you must contact Citrix to rehost the original license.
-
For 12.1.50.x or later releases, the NetScaler ADM license is automatically synchronized to the secondary node.
-
Pooled licenses are automatically synchronized to the secondary node from 12.1.50.x or later release.
How licenses are synchronized between ADM high-availability nodes?
-
Real Host ID - This ID is generated from a MAC Address of the ADM server. Each ADM standalone deployment has a unique host ID.
-
Virtual Host ID - This ID is auto generated during HA deployment. The real host ID of an ADM primary server is used as the virtual Host ID of a secondary server. This ID is stored in the ADM database in an encrypted format and modifications to this ID is restricted. The virtual Host ID is preferred over the real Host ID.
-
License files available in Node-1 are synchronized to Node-2.
-
Any new license files on Node-1 are synchronized to Node-2 periodically.
-
ADM ensures that the License Server is running only on Node-1 to avoid doubling of license capacity.
-
NetScaler instances check out licenses from Node-1 using the floating IP address.
Orchestration
Upgrade the virtual server licenses
-
Log on to NetScaler ADM using the administrator credentials.
-
Navigate to Infrastructure > Pooled Licensing.
-
Go to License Files, and select one of the following options:
-
Upload license files from a local computer. If a license is already present on your local computer, click Browse and select the license file (.lic) that you want to use to allocate your licenses. Click Finish.
-
Use License Activation Code. Citrix emails the license access code for the license that you purchased. Enter the license access code in the text box and then click Get Licenses.
NoteIf you select this option, the NetScaler ADM must be connected to the Internet, or a proxy server must be available.
-
-
You can add more licenses from the License Settings page at any time.

Verification
Manage virtual servers
-
By default, NetScaler ADM automatically licenses the virtual servers randomly after each virtual server poll cycle.
-
If the total number of virtual servers discovered in your NetScaler ADM is lower than the number of installed virtual server licenses, NetScaler ADM, by default, licenses all the virtual servers.
Disable auto-licensing virtual servers
-
Navigate to Settings > Licensing & Analytics Configuration.The dashboard displays the virtual server licenses available, the managed virtual servers along with the virtual server type, and license expiry information.
-
In Virtual Server License Allocation, disable Auto Licensed Virtual Servers and Auto-select non addressable Virtual Servers.

Select third-party virtual servers for licensing
-
Navigate to Settings > Licensing & Analytics Configuration.The dashboard displays the virtual server licenses available, the managed virtual servers along with the virtual server type, and license expiry information.
-
In Third Party Virtual Server Summary, disable Auto-select Third Party Virtual Servers.

Apply virtual server licenses manually
-
In Virtual Server License Allocation, select Configure Licenses.The All Vitrual Servers page is displayed.
-
Filter unlicensed virtual servers using the property:
Licensed: No. -
Select the virtual server that you want to license.
-
Click License.
Configure policy based virtual server licensing
-
Set virtual servers limit on CPX instances separately to apply licenses. The ADM applies license to virtual servers on CPX instances up to a specified limit.ImportantThis limit applies to CPX instances except sidecar deployment types.To view CPX instances of sidecar deployment types, filter the virtual servers using the property:
License Type: Freely Managed. -
Set virtual servers limit on selected ADC instances (MPX/VPX/BLX) to apply licenses. The ADM applies licenses to virtual servers on ADC instances up to a specified limit.
-
Select the priority ADC instances to apply virtual server licenses. Therefore, the ADM can apply license to selected instances’ virtual servers only.
View the licensed virtual servers
-
Navigate to Settings > Licensing & Analytics Configuration.
-
Click the virtual server type in the Total Licensed section in the Virtual Servers License Summary.
Configure auto license support for non-addressable virtual servers
-
NetScaler ADM, by default, still does not automatically select non-addressable virtual servers for licensing.
-
Application analytics (App Dashboard) is the only analytics supported currently on licensed non-addressable virtual servers.
Expiry Checks for virtual server licenses
-
Navigate to Infrastructure > Pooled Licensing > System Licenses.
-
In 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 remaining before expiry.
-
-
Navigate to Infrastructure > Pooled Licensing > Settings.
-
In the Notification Settings section, click the pencil icon and edit the parameters.
-
Email profile: Email profile or distribution list for sending notifications when licenses reach the threshold, or going to expire.
-
SMS (Text Message): SMS profile or distribution list for sending notifications when licenses reach the threshold, or going to expire.
-
Slack - Specify Slack profile details.
-
PagerDuty alerts - Specify a PagerDuty profile. Based on the notification settings configured in your PagerDuty portal, a notification is sent when your certificates are about to expire.
-
Notify me: Set the percentage of pooled licenses to notify administrators by Email or SMS.
-
License Expiry Threshold: Number of days before the number of licenses determined by Alert Threshold expire.
-
Expiry of licenses: Number of days remaining before expiry.
-