- 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
Use jobs to upgrade NetScaler instances
You can use NetScaler MAS to upgrade one or more NetScaler instances. Before upgrading an instance, ensure you have uploaded the correct build and documentation files to the NetScaler instances. You must know the licensing framework and types of licenses before you upgrade an instance.
When you upgrade your NetScaler instance by creating a maintenance task, you can do the following:
- Perform a pre-validation check on the instances that are being upgraded. The pre-validation check consists of the following checks:
Check for any existing customizations on NetScaler instances and delete the customizations. You can reapply all the customizations after the upgrade process is completed.
Check the disk usage of NetScaler instances. If the disk usage is more than 80%, clean up the disk space.
Check for disk hardware issues of NetScaler instances.
Perform the NetScaler HA pair upgrade in two stages.
Perform the upgrade task on a node immediately or you can even schedule that for later.
Schedule the upgrade for the other node later. It must be scheduled after the initial node is upgraded.
When you upgrade a NetScaler HA pair, note the following:
Currently, the second node of the HA pair is upgraded first, and then, the upgrade for the first node is scheduled to be done later.
Synchronization and propagation of the nodes are disabled until both the nodes are upgraded successfully.
After the upgrade of both nodes, you will see an error message in execution history (that indicates that HA Sync is not enabled) if your nodes in the HA pair are on different builds or versions.
To create a maintenance task to upgrade your NetScaler instance:
Navigate to Networks > Configuration Jobs > Maintenance Jobs.
In the Maintenance Jobs page, click Create Job.
In the Create Maintenance Job page, select Upgrade NetScaler/ Upgrade NetScaler HA and click Proceed.
On one or more Upgrade NetScaler Appliances page, in the Instance Selection tab, specify the Job Name and click Add Instances.
Select the target instances or instance groups that you want to upgrade.
- To upgrade NetScaler instances in high availability mode, you have to select IP addresses of either the primary or secondary instances. However, always using the primary node for the upgrade is recommended.
- To upgrade NetScaler instances in cluster mode, select the cluster IP address.
After you have added the NetScaler instances or instance groups, click Next to start the pre-upgrade validation on the selected instances. The screen reports the progress of pre-validation of each of the NetScaler instances.
On the Modify Upgrade NetScaler Appliance(s) page, select the Upgrade tab. From the Software Image drop-down menu, select either Local (your local machine) or Appliance (the build file must be present on NetScaler MAS).
You can also see if any instances have pre-validation upgrade errors. These errors are shown in the form of message. The messages show the errors related to disk space, hard disk drive, and user customization.
If you do not want to proceed with instances that have failed the pre-validation upgrade check, you can remove the instances. To remove the instances, select the instances and click Delete.
It is highly recommended to proceed the upgrade process, only if the pre-upgrade validation check passes for the NetScaler instances.
On the Schedule Task tab, you can also set execution details where you can perform the upgrade process now or schedule it for a later date.
You can enable email notification to receive the execution report of upgrading NetScaler instances. Click the Receive Execution Report Through Email checkbox to enable the email notification. To create an email distribution list:
Select the + icon to Create the Email Distribution List.
On the Create Email Distribution List page, specify a Name for the Email Distribution List. Add the SMTP mail server to use for sending email notifications to the Email Server. In the From box, add the Email address from which to send messages. In the To box, add Email address or addresses to which to send messages. You can also add an Email address or addresses to which to send message copies and copies without displaying these addresses in the messages or the copies. Click Create. After creating the email distribution list, click Finish to complete the configuring process.
On the Schedule Task tab, you can also perform the two-stage upgrade for nodes in HA. You can either perform the upgrade immediately or schedule a time for the nodes to be updated one after another. Synchronization and propagation of the nodes are disabled until both the nodes are upgraded successfully.