Product Documentation

Add HAProxy instances to NetScaler MAS

May 24, 2018

In NetScaler MAS, you need to manually add the details of the host on which you have provisioned the HAProxy instance. After you add those details, NetScaler MAS automatically discovers the HAProxy instances provisioned on the host and adds them to NetScaler MAS Inventory. It also discovers all the frontends, backends, and servers configured on the HAProxy instances, and treats the frontends as discovered applications. 


Make sure that you have:

  • Deployed an HAProxy instance on a host in your deployment. For more information, see
  • Identified and decided on the number of frontends for which you want to view the  application statistics on the HAProxy App Dashboard. By default, the HAProxy App Dashboard displays the statistics for 30 discovered applications. For more information about HAProxy App Dashboard, see HAProxy App Dashboard. If you want to view the statistics of more than 30 discovered applications, you need to purchase a separate license. For more information, see Third-Party Licensing.


NetScaler MAS requires access to the host in order to discover the HAProxy instances in it. You can provide access to NetScaler MAS by either providing the SSH key pair of the host or by using the host password. If you want to provide access using the SSH key pair, make sure that you generate the SSH private and public key pair in the host and add the public key to the authorized keys on the host. Also, the SSH user account must have superuser permissions.

To add an HAProxy instance to NetScaler MAS:

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

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

     3. Navigate to Networks > Instances. Under Instances, select HAProxy and click Add.

     4. In the Add HAProxy Host dialog box, do the following:

          a. In the IP Address field, enter the IP address of the host on which you have provisioned the HAProxy instances.

          b. In the HAProxy Profile drop-down list, select an existing HAProxy profile or create and select a new HAProxy profile. To create an HAProxy profile, click the + icon. 

          c. In the Add HAProxy Profile dialog box, do the following:

localized image

               i. In the Profile Name field, enter the profile name.

               ii. In the User Name field, enter the user name of the host.

               iii. In the SSL Authentication section, if you want the NetScaler MAS to use SSH key based authentication to access the host, do the following:

                    a. In the Private Key field, enter the generated SSH private key. 

                    b. In the Passphrase field, enter the passphrase of the SSH private key.

                    If you want NetScaler MAS to use the host password to access the host, enter the host password in the Password field.

               iv. Click Create.

          d. Click OK.

NetScaler MAS discovers the HAProxy instances provisioned on the host, and you can view all the HAProxy instances on the Instances tab.

localized image

Viewing the Configuration of an HAProxy Instance

To view the configuration of an HAProxy instance in NetScaler MAS, navigate to Networks > Instances > HAProxy and, on the, Instances tab, select the HAProxy instance and click View Configuration.

localized image