- Release notes
- All how to articles
- System requirements
- Get started
- NetScaler MAS with Citrix XenServer
- NetScaler MAS with Microsoft Hyper-V
- NetScaler MAS with VMware ESXi
- NetScaler MAS with Linux KVM server
- Configure high availability deployment
- Configure disaster recovery for high availability
- Configure on-prem agents for multisite deployment
- Migrate from NetScaler Insight Center to NetScaler MAS
- Migrate Command Center configurations to NetScaler MAS
- Integrate NetScaler MAS with Citrix XenDesktop Director
- Attach an additional disk to NetScaler MAS
- Access control
- StyleBook groups
- Use default StyleBooks
- Business application StyleBooks
Create and use custom StyleBooks
- StyleBook to create a load balancing virtual server
- StyleBook to create a basic load balancing configuration
- Create a composite StyleBook
- Use GUI attributes in a custom StyleBook
- Use custom StyleBooks
- Create a StyleBook to upload files to NetScaler MAS
- Create a StyleBook to upload SSL certificate and certificate key files to NetScaler MAS
- Enable analytics and configure alarms on a virtual server defined in a StyleBook
- Create a Stylebook to perform non-CRUD operations
- Use API to create configurations from StyleBooks
- Import StyleBooks
- Parameters-default-sources construct
- Helper components
- Optional properties
- Properties-default-sources construct
- Nested components
- Condition construct
- Repeat construct
- Repeat-condition construct
- Nested repeats
- Parameter reference
- Parent reference
- Components reference
- Substitutions reference
- Variable reference
- In-place interpolations
- Built-in functions
- Dependency detection
- Monitor globally distributed sites
- Manage admin partitions of NetScaler instances
- Back up and restore NetScaler instances
- Force a failover to the secondary NetScaler instance
- Force a secondary NetScaler instance to stay secondary
- Create instance groups
- Rediscover multiple NetScaler VPX instances
- Poll NetScaler instances and entities
- Unmanage an instance
- Trace the route to an instance
- Use events dashboard
- Set event age for events
- Schedule an event filter
- Set repeated email notifications for events
- Suppress events
- Create event rules
- Modify the reported severity of events that occur on NetScaler instances
- View events summary
- Display event severities and SNMP trap details
- Export syslog messages
- Suppress syslog messages
- Configure prune settings for instance events
- Use the SSL dashboard
- Set up notifications for SSL certificate expiry
- Update an installed certificate
- Install SSL certificates on a NetScaler instance
- Create a Certificate Signing Request (CSR)
- Link and unlink SSL certificates
- Configure an enterprise policy
- Poll SSL certificates from NetScaler instances
- Create a configuration job
- Use record-and-play to create configuration jobs
- Use configuration jobs to replicate configuration from one instance to multiple instances
- Use variables in configuration jobs
- Create configuration jobs from corrective commands
- Replicate running and saved configuration from one NetScaler instance to another
- Reuse executed configuration jobs
- Schedule jobs created by using built in templates
- Use maintenance jobs to upgrade NetScaler SDX instances
- Create configuration jobs for NetScaler SD-WAN WO instances
- Use the master configuration template
- Use jobs to upgrade NetScaler instances
- Use configuration templates to create audit templates
- Use SCP (put) command in configuration jobs
- Reschedule jobs configured by using built in templates
- Reuse configuration audit templates in configuration jobs
- Import and export configuration templates
- Maintenance jobs
- Configuration audit
- Network functions
- Network reporting
- Instance management
- License requirements
- Logstream overview
- Web Insight
- HDX Insight
- Gateway Insight
- Security Insight
- SSL Insight
- TCP Insight
- WAN Insight
- View network efficiency
- Compare the data volume used by optimized and unoptimized ABR videos
- View the type of videos streamed and data volume consumed from your network
- Compare optimized and unoptimized play time of ABR videos
- Compare bandwidth consumption of optimized and unoptimized ABR videos
- Compare optimized and unoptimized number of plays of ABR videos
- View peak data rate for a specific time frame
- Secure Web Gateway Analytics
OpenStack - integrating NetScaler instances
- Service package isolation policies
- Manual provisioning of NetScaler VPX instance on OpenStack
- Configure layer 7 content switching
- Configure LBaaS V1 using Horizon
- Configure LBaaS V2 using command line
- Shared VLAN support for admin partitions
- Pre-configuration tasks in NetScaler MAS and OpenStack
- Trial licensing workflow
- Integrate with OpenStack Heat services
- Flexible policy-based device allotment
- NSX Manager - manual provisioning of NetScaler instances
- NSX Manager - auto provisioning of NetScaler instances
- NetScaler automation using NetScaler MAS in Cisco ACI hybrid mode
- NetScaler device package in Cisco ACI's cloud orchestrator mode
- OpenStack - integrating NetScaler instances
NetScaler pooled capacity
- Configure NetScaler pooled capacity
- Upgrade a perpetual license in NetScaler VPX to NetScaler pooled capacity
- Upgrading a Perpetual License in NetScaler MPX to NetScaler Pooled Capacity
- Upgrade a perpetual license in NetScaler SDX to NetScaler pooled capacity
- NetScaler pooled capacity on NetScaler instances in cluster mode
- Health monitoring
- Expected behaviors when issues arise
- Configure expiry checks for pooled capacity licenses
- NetScaler VPX check-in and check-out licensing
- NetScaler virtual CPU licensing
- NetScaler pooled capacity
- Manage NetScaler SD-WAN instances
Manage HAProxy instances
- Add HAProxy instances to NetScaler MAS
- HAProxy app dashboard
- Third-party licensing
- Role-based access control for HAProxy instances
- Monitor HAProxy instances
- View the details of frontends configured on HAProxy instances
- View the details of backends configured on HAProxy instances
- View the details of servers configured on HAProxy instances
- View the HAProxy Instances with the highest number of frontends or servers
- Restart an HAProxy instance
- Back up and restore an HAProxy instance
- Edit the HAProxy configuration file
Manage system settings
- Configure system backup settings
- Configure a NTP Server
- Upgrade NetScaler MAS
- Configure syslog purging interval
- Configure system prune settings
- Enable shell access for non-default users
- Recover inaccessible NetScaler MAS servers
- Assign a host name to a NetScaler MAS server
- Back up and restore your NetScaler MAS server in a single-server deployment
- View auditing information
- Configure SSL settings
- Monitor CPU, memory, and disk usage
- Configure system notification settings
- Generate a tech support file
- Diagnose and troubleshoot NetScaler instances
- Back Up and restore a NetScaler MAS configuration in an HA pair
- Configure a cipher group
- Create SNMP traps, managers, and users
- Configure and view system alarms
- NetScaler MAS as an API proxy server
NSX Manager: auto provisioning of NetScaler instances
NetScaler Management and Analytics System (MAS) integrates with VMware network virtualization platform to automate the deployment, configuration, and management of NetScaler services. This integration abstracts away the traditional complexities associated with physical network topology, enabling vSphere/vCenter admins to programmatically deploy NetScaler services faster.
During load-balancing service insertion and deletion on VMware NSX Manager, NetScaler MAS dynamically provisions and destroys the NetScaler instances. This dynamic provisioning requires the NetScaler VPX license assignments to be automated in NetScaler MAS. When the NetScaler licenses are uploaded to the NetScaler MAS, NetScaler MAS performs the role of license server.
NetScaler MAS, version 12.1 setup in high availability and installed on ESX.
NetScaler VPX, version 12.1
NetScaler VPX licenses for NetScaler VPX instances, version 12.1
Install VMware ESXi version 4.1 or later with hardware that meets the minimum requirements.
Install VMware Client on a management workstation that meets the minimum system requirements.
Install VMware OVF Tool (required for VMware ESXi version 4.1) on a management workstation that meets the minimum system requirements.
To provision the NetScaler MAS HA setup, install the NetScaler MAS image file that you have downloaded from the Citrix download site. For more information on how to provision NetScaler MAS HA set up, see Deploying NetScaler MAS in High Availability.
To integrate VMware NSX manager with NetScaler MAS that is deployed in a HA mode, you must first enter the virtual IP address of the load balancing NetScaler instance. You must also upload the certificate file that is present on the NetScaler load balancing virtual server to the NetScaler MAS file system.
To provide load balancing configuration information in NetScaler MAS:
In NetScaler MAS HA node, navigate to System > Deployment.
Click HA Settings in the top-right corner, and in MAS-HA Settings page, click MAS-HA Endpoint Details.
On MAS-HA Endpoint Details page, upload the same certificate that is already present on the load balancing NetScaler instance.
Enter the virtual IP address of the load balancing NetScaler instance and click OK.
When you set up two NetScaler MAS servers in high availability, the two server nodes are in active-passive mode. Log on to the primary NetScaler MAS server node to register VMware NSX manager with NetScaler MAS in HA, to create a communication channel between them.
To register VMware NSX manager with NetScaler MAS in HA:
In the primary NetScaler MAS server node, navigate to Orchestration > SDN Orchestration > VMware NSX Manager.
Click Configure NSX Manager Settings.
- On Configure NSX Manager Settings page, set the following parameters:
NSX Manager IP Address - IP address of NSX Manager.
NSX Manager Username - Administrative user name of NSX Manager.
Password - Password of the administrative user of NSX Manager.
In NetScaler MAS account used by NSX Manager section, set the NetScaler Driver Password for the NSX Manager.
- Click OK.
Upload the NetScaler VPX licenses to NetScaler MAS, so that NetScaler MAS can automatically assign licenses to the instances during orchestration with NSX.
To install license files on the NetScaler Management and Analytics System:
In NetScaler MAS, navigate to Networks > Licenses.
In 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 to add. Then click Finish.
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.
Note: At any time, you can add more licenses to the NetScaler MAS from the License Settings.
Add the NetScaler images to NetScaler MAS, so that the NetScaler MAS uses these images as defined in the service package.
To upload NetScaler VPX Images in NetScaler MAS:
In NetScaler MAS, navigate to Orchestration > SDN Orchestration > VMware NSX Manager > ESX NSVPX Images.
Click Upload, and select the NetScaler VPX zip package from the local storage folder.
Create service packages in NetScaler MAS to define the set of SLAs, which states how the NetScaler resources are allocated.
To create service packages in NetScaler MAS:
In NetScaler MAS, navigate to Orchestration > SDN Orchestration > VMware NSX Manager > Service Packages, and click Add to add a new service package.
On Service Package page, in Basic Settings section, set the following parameters:
Name - name of a service package
Isolation Policy - select Dedicated
Select Auto Provision
In the Auto Provision Settings section, select the recently uploaded NetScaler VPX zip package for deploying it on NSX platform, select the corresponding license, and click Continue.
Note: In High Availability section, check the box to provision NetScaler instances for HA.
The name of license displayed in the drop-down box shown in the figure above, VPX8000_Enterprise, 2number is an example and is explained as below:
VPX - the license is to deploy NetScaler VPX instances
8000 - consumable bandwidth is 8GB
Enterprise - Citrix provides three types of licenses - Standard, Enterprise, and Platinum
2number - two NetScaler VPX instances can be deployed by using this license
The name of license displayed in the License drop-down box depends on the license that you have purchased from Citrix.
The service package is published to NSX Manager. In NSX Manager, navigate to Service Definitions > Service Managers. You can view Citrix NetScaler MAS as one of the service managers. This indicates that the registration is successful and bi-directional communication is established between the NSX manager and NetScaler MAS.
Note: For NetScaler MAS in high availability deployment, the licenses are uploaded only in the NetScaler MAS license server node. Note that the NetScaler MAS nodes are in an active-passive mode.
Perform load balancer service insertion on the existing NSX Edge Gateway, that is, offload the load balancing function from NSX load balancer to NetScaler.
To insert load balancing service on NSX Edge Gateway:
In NSX Manager, navigate to Home > Networking and Security > NSX Edges, and double-click to select the edge gateway that you have configured.
Click Manage, and on the Load Balancer tab, select Global Configuration, and click Edit.
Select Enable Load Balancer and Enable Service Insertion to enable them.
In Service Definition, select the service package that was published to NSX Manager.
Configure one virtual NIC for management interface, and one or more virtual NICs for data interfaces. Select the networks for management and data accordingly.
Note: Select IP Pool option in Primary IP Allocation mode. NetScaler MAS does not support manual or DHCP allocation of IP addresses.
Click the refresh icon to see the creation of the run time.
Note: Because you are deploying two NetScaler VPX instances in HA deployment, two run times are created in the NSX manager.
Note: You might have to refresh the screen to view the run times displayed on the screen.
Select the run time, click Actions, and select Install from the pop-up menu. For HA, repeat this for the other run time also.
When both the virtual machines start, the value of Status changes to “In Service” and that of Install State changes to “Enabled.”
Note: You might have to refresh the screen to view the change in status.
In NetScaler MAS, navigate to Orchestration > Requests to see progress details of completion of service insertion. You can see that a request to create and update the run time has come in to NetScaler MAS. When the run time has been updated, select the request and click the Tasks button to view that NetScaler MAS has been added in NSX Manager.
For HA, there will be two requests to create and update two run times in NetScaler MAS. When both run times have been updated, select both requests and click the Tasks button to view that two NetScaler MAS HA nodes have been added in NSX Manager.
In NetScaler MAS, navigate to Orchestration > SDN Orchestration > VMware NSX Manager > Edge Gateways. In the right-hand side panel, you can view that the NetScaler VPX has been added to the NSX Edge Gateway.
For HA, you can see that two NetScaler VPX instances in HA mode have been added to the NSX Edge Gateway.
In NetScaler MAS, navigate to Networks > Licenses >VPX Licenses. Select the NetScaler VPX license and the edition that you have installed.
The NetScaler VPX instances that are in HA mode consume two licenses and the status is displayed on your screen as below.
When the service insertion is complete, you can use StyleBooks to configure the NetScaler instances in one of the following two methods:
Perform the following task to enable configuration of load balancing services on the NSX Edge gateway device using built-in StyleBooks.
In NSX Manager, navigate to Home > Networking and Security > NSX Edges, and double-click to select the edge gateway that you have configured.
Creating pools and pool members
Create a pool of servers and members of different capacities.
Click Manage, and on the Load Balancer tab, select Pools, and click “+” icon to add a new pool, and set the following parameters:
Name - Name of the new pool
Algorithm - Select an algorithm from the drop-down list base on which the pool will be selected.
Monitors - Make sure the service monitor is set to default_http_monitor
Members - Click “+” to add members to the pool and enter the required parameters in the New Member window.
Name - Name of the member
IP Address/ VC Container - Click Select to select the object from the available list or enter the IP address of the object.
Add as many members as required.
Creating virtual servers
Create a set of virtual servers and assign a pool to each virtual server.
Click Manage, and on the Load Balancer tab, select Virtual Servers, and click “+” icon to add a virtual server, and set the following parameters:
Application profile - By default, the service profile that you created in NetScaler MAS is displayed.
Name - Name of the virtual server.
IP Address - Click Select to select an existing pool of IP addresses or create a new pool of IP addresses.
Default pool - Select the default pool from the drop-down list.
In NetScaler MAS, navigate to Orchestration > Requests to see progress details of completion of service creation on the selected NetScaler instance(s).
In NetScaler MAS, navigate to Applications > Configuration, and check that the “nsx-lb-mon” config pack has been created.
Deploy load balancer configurations on the NetScaler instance using NetScaler MAS StyleBooks. For HA, the configuration is deployed on both NetScaler instances that are in HA.
To create configuration packs through StyleBooks:
In NetScaler MAS, navigate to Applications > Configuration > Create New, and select the HTTP/SSL LoadBalancing (with Monitors) StyleBook from the list. The StyleBook opens as a user interface page on which you enter the values for all the parameters defined in this StyleBook.
Specify values for all the required parameters.
Select the target NetScaler VPX instance that is provisioned in the NSX environment, and click Create to apply the configuration on the selected device. For HA deployment, select the instances that are in HA mode.
You can view that the service groups and virtual servers are created by loogin on to the NetScaler VPX instance.
To view the service groups and virtual servers:
Log on to the NetScaler VPX instance. For HA deployment, you must log on to both NetScaler instances that are in HA.
Navigate to Configuration > System > Networking. In the right pane, you can view the IP addresses that are added. Click the IP address hyperlink to see the details. You can see that the subnet IP address is same as the IP address of the web interface that was added in NSX.
Next, navigate to Traffic Management > Load Balancing > Virtual Servers and view the virtual server details.
Next, navigate to Service Groups and view the service group details.
Finally, navigate to Configuration > System > Licenses to view the licenses that are applied to this instance.
When the load balancing services are no longer required on the NetScaler VPX instances deployed on the NSX manager, you can delete the service insertions that were performed earlier.
To delete configuration and service insertion:
In NetScaler MAS, Navigate to Applications > Configuration, select the application configuration created, and then delete the configuration by clicking on the “X” icon.
In NSX Manager, navigate to the edge gateway to which the NetScaler VPX instance is connected. Navigate to Manage > Load Balancer > Global Configuration, right-click on the runtime entry, and then click Unprovision. The virtual machine is rendered out of service.
In NetScaler MAS, navigate to Orchestration > Cloud Orchestration > Edge Gateways. Verify that the respective mapping of Edge gateway to deleted instance should not be present.
NSX Manager: auto provisioning of NetScaler instances
In this article
- High-Availability Deployment of NetScaler MAS and NetScaler Instances
- Setting up NetScaler MAS HA Endpoint Details
- Registering VMware NSX Manager with NetScaler MAS
- Uploading Licenses in NetScaler MAS
- Uploading NetScaler VPX Images in NetScaler MAS
- Creating Service Packages in NetScaler MAS
- Performing Load Balancer Service Insertion for Edge
- Configuring Load Balancing Services on NetScaler VPX in VMware NSX Manager GUI
- Configuring Load Balancing Services on NetScaler VPX in NetScaler MAS GUI
- Verifying Creation of Virtual Servers and Service Groups in NetScaler VPX Instances
- Deleting Load Balancing Services