Product Documentation

Add instances to NetScaler MAS

May 24, 2018

Instances are Citrix appliances or virtual appliances that you want to discover, manage, and monitor from NetScaler MAS. You must add instances to the NetScaler MAS server if you want to manage and monitor these instances. You can add the following Citrix appliances and virtual appliances to NetScaler MAS:

  • NetScaler ADC
    • NetScaler MPX
    • NetScaler VPX
    • NetScaler SDX
    • NetScaler CPX
  • NetScaler Gateway
  • NetScaler SD-WAN

You can add instances either while setting up the NetScaler MAS server for the first time or at a later time.

Note

  • NetScaler MAS uses the NetScaler IP (NSIP) address of the NetScaler instances for communication. For information about the ports that must be open between the NetScaler instances and NetScaler MAS, see Ports.
  • For NetScaler SD-WAN WO and NetScaler SD-WAN EE instances, NetScaler MAS uses the mangament IP address of the instances for communication.
  • To learn how NetScaler MAS discovers instances, see Discover instances.

How to Add Instances to NetScaler MAS

You can add instances either while setting up the NetScaler MAS server for the first time or at a later time.

To add instances, you must specify either the host name or IP address of each NetScaler instance, or a range of IP addresses.

For SD-WAN instances, specify the IP address of each instance, or a range of IP addresses. Note that NetScaler MAS supports only NetScaler SD-WAN WO and NetScaler SD-WAN EE editions.

You must then specify an instance profile that NetScaler MAS can use to access the instance.

This instance profile contains the user name and password of the instance(s) that you want to add to NetScaler MAS. For each instance type, a default profile is available. For example, the ns-root-profile is the default profile for NetScaler instances. This profile is defined by the default NetScaler administrator credentials. If you have changed the default admin credentials of your instances, you can define custom instance profiles for those instances.  If you change the credentials of an instance after the instance is discovered, you must edit the instance profile or create a new profile, and then rediscover the instance.

Note

  • To add NetScaler instances configured in a cluster, you must specify either the cluster IP address or any one of the individual nodes in the cluster setup. However, on NetScaler MAS, the cluster is represented by the cluster IP address only.
  • For NetScaler instances set up as an HA pair, when you add one instance, the other instance in the pair is automatically added.

If two NetScaler MAS servers are set up in high availability mode, when an instance is added, load balancing comes into effect and the instances are distributed across the two NetScaler MAS server nodes by using the round-robin method.

To add an instance to NetScaler MAS

1) In a web browser, type the IP address of the NetScaler Management and Analytics System (for example, http://192.168.100.1).

2) In the User Name and Password fields, enter the administrator credentials. The default administrator credentials are nsroot/nsroot.

3) Navigate to Networks > Dashboard and click All Instances. On the Instances page, click Add. On the Add Instance page, from Instance Type, select the type of instance you want to add, and then follow the instructions in step 4.

Alternatively, navigate to Networks > Instances. Under Instances, select the type of instance you want to add (for example, NetScaler VPX) and click Add.

4) Select one of the following options:

  • Enter Device IP address - For NetScaler instances, specify either the host name or IP address of each instance, or a range of IP addresses. For SD-WAN instances, specify the IP address of each instance, or a range of IP addresses.
  • Import from file - From your local system, upload a text file that contains the IP addresses of all the instances you want to add.

5) From Profile Name, select the appropriate instance profile, or create a new profile by clicking the icon.

Note

For NetScaler CPX instances, you must specify the HTTP, HTTPS, SSH, and SNMP port details of the host. You can also specify the range of ports that were published by the host in the Start Port and Number of ports field. Also, if your NetScaler CPX IP address is reachable from the NetScaler MAS server, select the Routable checkbox. If your NetScaler CPX IP address is reachable through the host, uncheck the Routable checkbox and specify the host’s IP address.

6) Click OK to initiate the process of adding instances to NetScaler MAS.

Note

If you want to rediscover an instance, navigate to Networks > Instances > NetScaler <Instance Type>, select the instance you want to rediscover, and then from the Action drop-down list, click Rediscover.