- Release Notes
- How-to Articles
- About NetScaler MAS
- NetScaler MAS Licensing
- Getting Started with NetScaler MAS
- System Requirements
Deploying NetScaler MAS
- NetScaler MAS with Citrix XenServer
- NetScaler MAS with Microsoft Hyper-V
- NetScaler MAS with VMware ESXi
- NetScaler MAS with Linux KVM server
- Deploy NetScaler MAS in high availability mode
- Migrate a single-server deployment to a high availability 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
- Setting up NetScaler MAS
- Upgrading NetScaler MAS
- Managing NetScaler SD-WAN instances
Managing and Monitoring HAProxy instances
- Adding HAProxy instances to NetScaler MAS
- HAProxy Applications in Application Dashboard
- Third-party licensing
- Role Based Access Control in NetScaler MAS for HAProxy Instances
- How to Use the NetScaler MAS Dashboard to Monitor an HAProxy Instance
- How to Display the Details of the Frontends Configured on HAProxy Instances
- How to Display the Details of the Backends Configured on HAProxy Instances
- How to Display the Details of the Servers Configured on HAProxy Instances
- How to Use the Application Dashboard to View the HAProxy Instances That Have the Highest Number of Frontends or Servers
- How to Restart an HAProxy Instance From NetScaler MAS
- How to Back Up and Restore an HAProxy Instance by Using NetScaler MAS
- How to Edit the HAProxy Configuration File by Using NetScaler MAS
Application Analytics and Management
- Application Performance Analytics
- Application Security Analytics
- How to create an application definition in NetScaler MAS
- How to Enable or Disable Entities in NetScaler MAS
- How to Disable Entities in NetScaler MAS
- How to View the Effective State of a Virtual Server on NetScaler MAS
- How to Search for Entities in NetScaler MAS
- StyleBook groups
- Use default StyleBooks
- How to Create Your Own StyleBooks
- How to Use User-Defined StyleBooks in NetScaler MAS
- Use API to create configurations from StyleBooks
- Retrieve private StyleBooks
- Enable analytics and configure alarms on a virtual server defined in a StyleBook
- Create a StyleBook to upload files
- Create a StyleBook to upload SSL certificate and certificate key files
- SSO Google Apps StyleBook
- Microsoft Skype for Business StyleBook
- Microsoft Exchange StyleBook
- Microsoft SharePoint StyleBook
- How to use the SSO Office 365 StyleBook
- 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
- How to Monitor Globally Distributed Sites
- How to Manage Admin Partitions of NetScaler Instances
- How to Add Instances to NetScaler MAS
- How to Back Up and Restore NetScaler Instances Using NetScaler MAS
- How to Configure Sites for Geomaps in NetScaler MAS
- How to Force a Failover to the Secondary NetScaler Instance by Using NetScaler MAS
- How to Force a Secondary NetScaler Instance to Stay Secondary by Using NetScaler MAS
- How to Create Instance Groups on NetScaler MAS
- How to Rediscover Multiple NetScaler VPX Instances
- How to Poll NetScaler Instances and Entities in NetScaler MAS
- How to Unmanage an Instance on NetScaler MAS
- How to Trace the Route to an Instance from NetScaler MAS
- How to Set Event Age for Events on NetScaler MAS
- How to Schedule an Event Filter by Using NetScaler MAS
- How to Set Repeated Email Notifications for Events from NetScaler MAS
- How to Suppress Events by Using NetScaler MAS
- How to Use the Events Dashboard to Monitor Events
- Creating Event Rules
- How to Modify the Reported Severity of Events that Occur on NetScaler Instances
- How to View Events Summary in NetScaler MAS
- How to Display Event Severities and SNMP Traps Details on NetScaler MAS
- Using NetScaler MAS to Export Syslog Messages
- How to Suppress Syslog Messages in NetScaler MAS
- How to Configure Prune Settings for Instance Events
NetScaler Certificate Management
- How to Set Up Notifications for SSL Certificate Expiry from NetScaler MAS
- How to Install SSL Certificates on a NetScaler Instance
- How to Update an Installed Certificate from NetScaler MAS
- How to Link and Unlink SSL Certificates by Using NetScaler MAS
- How to Create a Certificate Signing Request (CSR) using NetScaler MAS
- How to Configure an Enterprise Policy on NetScaler MAS
- How to Use the SSL Dashboard on NetScaler MAS
- How to Poll SSL Certificates from NetScaler Instances
- How to Create a Configuration Job on NetScaler MAS
- How to Use Record-and-Play to Create Configuration Jobs
- How to Use Configuration Jobs to Replicate Configuration from One Instance to Multiple Instances
- How to Use Variables in Configuration Jobs on NetScaler MAS
- How to Create Configuration Jobs from Corrective Commands on NetScaler MAS
- How to Use Configuration Templates to Create Audit Templates on NetScaler MAS
- How to Create Configuration Jobs for SD-WAN WO Instances in NetScaler MAS
- How to Use the Master Configuration Template on NetScaler MAS
- How to Replicate Running and Saved Configuration Commands from One NetScaler Instance to Another on NetScaler MAS
- How to Upgrade NetScaler SDX Instances by Using NetScaler MAS
- How to Schedule Jobs Created by Using Built-in Templates in NetScaler MAS
- How to Reschedule Jobs That Were Configured by Using Built-in Templates in NetScaler MAS
- How to Reuse Executed Configuration Jobs
- How to Upgrade NetScaler Instances
- How to Use SCP (put) Command in Configuration Jobs
- How to Reuse Configuration Audit Templates in Configuration Jobs
- Creating Maintenance Tasks
- How to Import and Export Configuration Templates
- Configuration Audit
- Network Functions
- Network Reporting
- License requirements
- Understanding Logstream
- Web Insight
- HDX Insight
- Gateway Insight
- Security Insight
- SSL Insight
- TCP Insight
- WAN Insight
- Viewing the Type of Videos Streamed and the Data Volume Consumed from your Network
- Viewing the Peak Data Rate for a Particular Time Frame
- Comparing the Optimized and Un-Optimized Number of Plays of ABR Videos
- Compare the Optimized and Unoptimized Play Time of ABR Videos
- Comparing Bandwidth Consumption of Optimized and Un-Optimized ABR Videos
- Comparing the Data Volume Used by Optimized and Unoptimized ABR Videos
- Viewing the Network Efficiency
- Secure Web Gateway Analytics
Integrating NetScaler MAS with OpenStack Platform
- Pre-configuration tasks in NetScaler MAS and OpenStack
- Configure LBaaS V1 using Horizon
- Configure LBaaS V2 using command line
- Configure layer 7 content switching
- Manual provisioning of NetScaler VPX instance on OpenStack
- Shared VLAN support for admin partitions
- Trial licensing workflow
- Integrate with OpenStack Heat services
- Service package isolation policies
- Flexible policy-based device allotment
- Integrating NetScaler MAS with NSX Manager by Manual Provisioning
- Integrating NetScaler MAS with NSX Manager by Auto-provisioning
- NetScaler automation using NetScaler MAS in Cisco ACI hybrid mode
- NetScaler device package in Cisco ACI's cloud orchestrator mode
- Use NetScaler MAS as an Ingress Controller for the Kubernetes Environment
Authentication and Access Control
- Role-based Access Control in NetScaler MAS
- Configuring Authentication in NetScaler MAS
- Multi-Tenancy - Provide Exclusive Management Environment to Your Tenants
Managing NetScaler MAS 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 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
Migrating Command Center Configurations to NetScaler MAS
You can now migrate your Command Center configurations to the NetScaler Management and Analytics System (MAS) without losing the existing configuration, settings, or data of your Command Center deployment and NetScaler MAS deployment. You can view the migrated Command Center configurations in NetScaler MAS after the migration process is completed.
Points to note:
Migrating Command Center configurations to NetScaler MAS is supported on the following deployments:
Command Center standalone to NetScaler MAS standalone deployment or NetScaler MAS high availability deployment.
Command Center high availability to NetScaler MAS standalone deployment or NetScaler MAS high availability deployment.
Note: You must use only the primary node’s IP address of Command Center and NetScaler MAS high availability deployment while migrating the Command Center standalone or high availability deployment to NetScaler MAS standalone or high availability deployment.
You can run the Command Center tool multiple times on same or different NetScaler MAS deployments:
Whenever you run the Command Center tool beyond the first time for the same NetScaler MAS, the logs will be shown as failed for the configurations that have already been migrated and exist in NetScaler MAS.
If any new configuration has been added in Command Center from the time the tool was run earlier to now for the same NetScaler MAS, all such configuration except the new Custom tasks will be migrated to NetScaler MAS.
Migrating Command Center configurations to NetScaler MAS is supported for NetScaler, NetScaler SDX, and NetScaler SD-WAN WO devices.
All communication between Command Center and NetScaler MAS is on an HTTPS connection.
Backing up of existing data of NetScaler MAS before migrating the Command Center configurations is highly recommended.
After the Command Center migration is completed, the Admin Partitions of NetScaler are auto-discovered in the NetScaler MAS.
The following Command Center configurations are not migrated from the Command Center appliance to the NetScaler MAS:
Device backup configuration files
Timeout details in SD-WAN WO device profiles
The following details under event and alarm triggers are not migrated:
Abort details for run command action
Run task details
Triggers with all empty parameters (severity/category/instances/failure objects) are not migrated
Triggers having instances with the state as HA cluster, primary, and secondary are not migrated if all the three states of the instances are selected
Custom tasks without description are not migrated
Event severities settings
Event rule schedule details
Syslog suppress filters
Configuration task details
Audit policies without devices
Audit policy schedule details
Groups RBAC authorized scope settings
Database monitor and management settings
Performance custom reports
Custom views of fault/syslog/reports/Entity Monitoring
AppFirewall and NS gateway reports and its schedule details
SD-WAN WO auto configuration details
High Availability settings
Scheduled system backup settings
Database retry settings
Syslog purge schedule time
All statistic data like syslog, events, and audit logs of all modules.
Before migrating the Command Center configurations to NetScaler MAS, make sure that the following prerequisites are met:
You are running Command Center version 5.2 build 48.2 or later.
You have installed and configured NetScaler MAS version 12.0 build 51.24 or later.
Only the Admin user will run the Command Center configuration migration.
For successful migration of custom tasks, the description field is mandatory in Command Center.
Communication between the Command Center and NetScaler MAS is NITRO based. You must configure and open the necessary SSL (Secure Socket Layer) and TLS (Transport Layer Security) protocol settings on Command Center and NetSCaler MAS for NITRO communication.
If you are using a Command Center version earlier than 5.2 build 48.2, you must upgrade the Command Center version to 5.2 build 48.2 and then migrate the Command Center configurations to NetScaler MAS. For detailed information about upgrading the Command Center appliance, see “Upgrading Command Center”.
To migrate a Command Center configuration to NetScaler MAS, you need the Command Center appliance IP address and administrator credentials.
To migrate Command Center Configurations to NetScaler MAS:
In a web browser, type the IP address of the Command Center appliance.
In the User Name and Password fields, type the administrator credentials and log in.
After successful login, on the screen that appears, select the Administration tab and do one of the following:
In the right pane, under NetScaler MAS Migration, select Migrate Configuration, as shown in the following figure.
In the left pane, select NetScaler MAS Migration, and then click Migrate Configuration, as shown in the following figure.
In the Command Center to MAS Migration dialog box, enter the IP address of the NetScaler MAS server, and the administrator credentials, and then click OK.
Note: In case of NetScaler MAS high availability deployment, enter the primary node IP address.
At the confirmation prompt, click Yes.
The screen reports the progress of the migration tasks.
The Migrate Configuration operation takes the details of the NetScaler MAS deployment and its admin credentials as input. The Migrate Configuration operation then migrates the configuration of Command Center deployment to NetScaler MAS deployment.
When the tasks are completed, you can verify the migrated Command Center configuration from Command Center migration logs and NetScaler MAS data.
To use the Command Center migration logs to verify the migration
In the Command Center GUI, on the Administration tab, do one of the following:
In the right pane, under NetScaler MAS Migration, click Migration Log.
In the left pane, select NetScaler MAS Migration, and then click Migration Log.
Review the list of migration logs.
To display more detail, select Module Name, or to display details for a particular module, select that module, and then click Details.
The following example shows the log details for a selected module.
To use the NetScaler MAS to verify the migration
During the migration process, the Command Center configurations are migrated to NetScaler MAS and are shown as NetScaler MAS configurations in the NetScaler MAS GUI.
After the migration process is completed, the NetScaler MAS Server reboots and there might be a momentary downtime. When the NetScaler MAS server is up and running, access the NetScaler MAS GUI by typing the IP address of the NetScaler MAS server in the address bar of your browser.
The following table shows how the NetScaler MAS terminology for the migrated configurations corresponds to the terminology used in Command Center.
|Command Center Terminology||NetScaler MAS Terminology|
|Device profiles||Instance profiles|
|Devices and its state (like managed/unmanaged)||Instances and its state (like managed/unmanaged)|
|Device annotations||Instance annotations|
|Device groups||Instance groups|
|Event and alarm triggers||Event rules|
|Built-In and custom task commands||Configuration templates under create Job editor|
|Scheduled audit policies||Audit templates|
|Password policy||Password policy|
|Users (local users only)||System users|
|Authentication profiles and authentication settings||Authentication profiles and authentication configuration|
|Email settings||Email server/Email distribution list|
|Syslog server||Syslog server|
|SSL settings||SSL settings|
|SNMP agent configuration||SNMP manager|
|Trap forward settings||Trap settings|
|Event purge settings||Events prune settings|
|Inventory settings||Instance backup settings|
|Syslog purge settings||Syslog prune settings|
|Appliance network settings like DNS, NTP, and time zone||NetScaler MAS network settings like DNS, NTP, and time zone|
*Groups with all permissions in Command Center are migrated as groups with an “admin” role in NetScaler MAS. All other Command Center groups are migrated as groups with a “read-only” role in NetScaler MAS.