- 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
NetScaler MAS with Linux KVM server
Virtualization platforms on which the Citrix NetScaler Management and Analytics System (MAS) can be provisioned include Linux-KVM.
Before you install NetScaler MAS on Linux-KVM, make sure that your system has the hardware virtualization extensions, and verify that the CPU virtualization extensions are available. Verify that virsh (a command-line tool for managing virtual machines) is available on the hypervisor.
Use your administrator credentials to log on to Citrix.com website, access the latest NetScaler MAS setup files, and download them onto your computer. Then, install the NetScaler MAS on your Linux-KVM platform and configure it for your network.
Before installing the NetScaler MAS virtual appliance, verify that Linux-KVM version 3.6.11-4 and later is installed on hardware that meets the minimum requirements.
|CPU||A 64-bit x86 processor with the hardware virtualization features that are included in the AMD-V and Intel VT-X processors. Provide at least 2 CPU cores to host Linux-KVM. Note: To test whether your CPU supports Linux host, enter the following command at the host Linux shell prompt:
|Memory (RAM)||Minimum 4 GB for the host Linux kernel. Add additional memory as required by the VMs.|
|Hard Disk||Calculate the space for Host Linux kernel and VM requirements. A single NetScaler MAS VM requires 120 GB of disk space.|
The memory and hard disk requirements specified above are for deploying NetScaler MAS on the OpenStack platform, considering that there are no other virtual machines running on the host. The hardware requirements for OpenStack depends on the number of virtual machines running on it.
Citrix recommends newer kernels, such as the 64-bit version of the 3.6.11-4 kernel or later.
Guest virtual machine hardware requirements
NetScaler virtual machine and NetScaler MAS support only IDE hard disk type.
|Note: The default value is 8 GB. Citrix recommends that you increase the default value to 32 GB for better performance.|
|Virtual CPU||8 CPUs|
|Note: The default is 2 CPUs. Citrix recommends that you increase the default value to 8 CPUs for better performance.|
|Storage space||Citrix recommends using solid-state drive (SSD) technology for NetScaler MAS deployments. The default value is 120 GB. Actual storage requirement will depend on NetScaler MAS sizing estimation. If your NetScaler MAS storage requirement exceeds 120 GB, you to have to attach an additional disk. Note that you can add only one additional disk. Citrix recommends you to estimate storage and attach additional disk at the time of initial deployment. For more information, see How to Attach an Additional Disk to NetScaler MAS.|
|Virtual Network Interfaces||1|
|Throughput||1 Gbps or 100 Mbps|
NetScaler MAS supports only one virtIO para-virtualized network interface. This interface should be connected to the management network of the Linux-KVM host, so that the NetScaler MAS and Linux-KVM can communicate.
To download the NetScaler Management and Analytics System setup files from www.citrix.com:
Open a web browser and type www.citrix.com in the address bar.
Click Log In, enter your login credentials, and then again click Log In.
Navigate to Downloads section.
From the Downloads drop-down list, select NetScaler ADC.
On the NetScaler ADC page, select the release. For example, select Release 11.1.
Click Components to expand it, and click NetScaler Management and Analytics System.
Scroll down to the list of available builds, and then select a build. For example, select NetScaler MAS Image for Linux-KVM, 11.1-Build 44.5.
Click Download File, accept the end-user license agreement, and download the compressed image file to any folder on your local machine.
Using SSH, log on to the KVM host.
At the CLI prompt, by using any of the file transfer programs, copy the image to a folder on the server.
Navigate to the directory where you have saved the downloaded image.
Perform these at the command line:
List the files in the directory verify the presence of the image file.
Use the tar command to untar the NetScaler Management and Analytics System image file. The unzipped package contains the following components:
A domain XML file that specifies the NetScaler MAS attributes
A text file that specifies the check sum of the domain disk image
A domain disk image
tar -xvfz MAS-KVM.tgz MAS-KVM.xml MAS-KVM.qcow2 checksum.txt
Create a copy of MAS-KVM.xml as MAS1-KVM.xml, as a back-up option. Open the MAS1-KVM.xml file by using the vi editor.
- Edit MAS1-KVM.xml for the following networking attributes:
name - Specify the name.
mac - Specify the MAC address.
source file - Specify the absolute disk-image source path. The file path has to be absolute.
The domain name and the MAC address must be unique.
mode - Specify the mode.
model type - Set to virtIO.
source dev - Specify the interface.
<name> MAS1-KVM</name> <mac address='52:54:00:29:74:b3'/> <source file='/var/ MAS-KVM.qcow2'/> <source dev='eth0' mode='bridge'/> <model type='virtio'/>
Define the VM attributes in the MAS1-KVM.xml file by using the following command: virsh define <FileName>.xml
virsh define MAS-KVM.xml Domain MAS defined from MAS-KVM.xml
Start the NetScaler MAS by entering the following command: *virsh start [<DomainName> <DomainUUID>]*
virsh start MAS Domain MAS started
You can connect to the NetScaler MAS virtual machine by using the following command: virsh console <DomainName>
virsh console MAS Connected to domain MAS Escape character is ^]
On some Linux KVM hosts, FreeBSD guests fail to restart properly if they have more than one CPU. When The NetScaler MAS virtual appliance is restarted, the NetScaler MAS CLI and GUI become unresponsive.For details, see https://bugs.launchpad.net/qemu/+bug/1329956
To avoid the NetScaler MAS CLI and GUI from becoming unresponsive when the NetScaler MAS virtual appliance is restarted, shut down all the virtual machines on the KVM host, and perform the following on the KVM host:
- Remove the kvm_intel module using the following command: rmmod kvm_intel
- Disable APICv and reload kvm_intel module using the following command: modprobe kvm_intel enable_apicv=N
- Start the virtual machines on the KVM host.
After installing the NetScaler MAS, allow about ten minutes for the services to become available, and then log on to the NetScaler MAS.
At the command line, use the default system administrator credentials to log on to the system:
After logging on for the first time, you should change the administrative password. Then, configure the MAS to function in your network. You can change the password from the NetScaler MAS user interface. From the NetScaler MAS home page, navigate to System > User Administration > Users. Select the user and click Edit, and then update the password in the Password field.
At the prompt, type: shell
Type networkconfig to enter the NetScaler MAS initial network configuration menu. Configure the management IP address.
To complete the initial network configuration of NetScaler MAS, follow the prompts. The console displays the NetScaler MAS initial network configuration options for setting the following parameters for the NetScaler MAS. The host name is populated by default.
Enter 2 to update NetScaler MAS IPv4 address - management IP address at which you access a NetScaler MAS
Enter 3 to update Netmask - subnet mask associated with the Management IP address
Enter 4 to update Gateway IPv4 address - default gateway IP address for the subnet of the Management IP address of the NetScaler MAS
Enter 7 to save and quit - saves your configuration changes and exits the system.
Execute the deployment script by typing the command at the shell prompt: deployment_type.py
In the deployment screen that appears, select the deployment type as NetScaler MAS server.
Currently, you cannot deploy connector nodes, database nodes, and/or NetScaler MAS agents because NetScaler MAS does not support Scale-Out deployment.
1. Type Yes to deploy NetScaler MAS as a standalone deployment.
1. Type Yes to restart the NetScaler MAS server.
1. After NetScaler MAS server restarts, log on to NetScaler MAS by using the default administrator credentials as nsroot/nsroot through the command line or the GUI.
You can later access the NetScaler MAS by typing the IP address of the NetScaler MAS server in the address bar of your browser. The default administrator credentials to log on to the server are nsroot/nsroot.