Product Documentation

Adding HAProxy instances

You can add HAProxy instance provisioned on a host by providing the details of the host while setting up the Citrix Application Delivery Management (Citrix ADM) for the first time or at a later time.

Citrix ADM supports HAProxy version 1.6.3 or later and you can add HAProxy instances provisioned on the following hosts to Citrix ADM:

  • Ubuntu 14.0 or later
  • Red Hat Enterprise Linux (RHEL) 6.0 or later
  • SUSE 11.0 or later
  • CentOS 6.0 or later
  • Amazon Linux AMI

Note

Ensure that the host is not configured with a customized prompt string for the shell. The shell must have either $ or # as the prompt string.

To add HAProxy instances, you must specify the IP address of the host on which you have provisioned the HAProxy instances. You must then specify an HAProxy profile that Citrix ADM can use to access the host. This HAProxy profile contains the user name and password of the host that you want to add to the service.

Note: Ensure that the user account associated with the user name has:

  • Privileges to run the ps command to list all the HAProxy instances on the host.

  • Permission to restart the HAProxy instance on the host.

After you add the host on which you have provisioned the HAProxy instances to Citrix ADM, Citrix ADM accesses the host using SSH protocol. It 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.

To add HAProxy instances to Citrix ADM:

  1. Navigate to Networks > Instances and click Total Instances. On the Instances section, click Add at the top right corner of the page. On the Add Instances page, from the Instance Type drop-down list, select HAProxy Host.

    localized image

    Alternatively, navigate to Networks > Instances. Under Instances, select HAProxy and click Add.

    localized image

    localized image

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

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

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

    1. In the Profile Name field, enter a unique name for the HAProxy profile.

    2. In the User Name field, enter the user name that is used to access the host using SSH protocol.

      Note

      Ensure that the user account associated with user name has:

      • Privileges to run the ps command to list all the HAProxy instances on the host.
      • Permission to restart the HAProxy instance on the host.
    3. In the Password field, enter the password of the host.
    4. Click Create.
  5. Specify a Site for the instance.

  6. In the Agent drop-down list, select the agent with which you want to associate the instances.

  7. In the Tags field, specify a key and associated values for the HAProxy instance. Tags help you to classify and identify the instances. For example, specify Location as the key and Bangalore as the Value. You can also add multiple values for a key. Seperate the multiple values with commas.

  8. Select OK.

Citrix ADM discovers the HAProxy instances provisioned on the host, and you can view all the HAProxy instances on the Instances tab in the Networks > Instances > HAProxy page.

localized image

Adding HAProxy instances

In this article