Add HAProxy instances to Citrix ADM

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

Prerequisites

Make sure that you have:

  • Deployed an HAProxy instance on a host in your deployment. For more information, see http://www.haproxy.org/#docs.
  • 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.

Important

Citrix ADM requires access to the host in order to discover the HAProxy instances in it. You can provide access to Citrix ADM 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 Citrix ADM:

  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 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:

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

    2. 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.

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

      localized image

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

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

      3. In the SSL Authentication section, if you want the Citrix ADM to use SSH key based authentication to access the host, do the following:

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

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

          If you want Citrix ADM to use the host password to access the host, enter the host password in the Password field.

      4. Click Create.

  5. Click OK.

Citrix ADM 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 Citrix ADM, navigate to Networks > Instances > HAProxy and, on the, Instances tab, select the HAProxy instance and click View Configuration.

localized image

Add HAProxy instances to Citrix ADM