HAProxy Enterprise is distributed through the Operating System package manager.

We offer two ways of installing our product:

  • A quick procedure where you run a script to install the load balancer and its associated components (see below for Quick installation), or

  • A step-by-step procedure with detailed explanations at each stage of the installation of the load balancer and its associated components (see the section Detailed installation).

Quick installation

This procedure adds package repositories and installs HAProxy Enterprise. After the installation, you can install additional components to extend the functionalities of your load balancer.

  • Run the following command on the server where you want to install HAProxy Enterprise, and replace <HAProxy Enterprise Key> with the key you received when you registered.

    curl -s https://cdn.haproxy.com/static/install_haproxy_enterprise.sh | sudo bash /dev/stdin 1.6r2 <HAProxy Enterprise key>
  • Start HAProxy Enterprise:

    sudo systemctl enable hapee-1.6-lb
    sudo systemctl start hapee-1.6-lb

    On older systems that do not have systemctl, use:

    sudo service hapee-1.6-lb start

Post-installation:

Detailed installation

The following procedure gives detailed explanations at each stage of the installation of the load balancer and its associated components.

  • Create a new file /etc/apt/sources.list.d/hapee.list if it does not exist, and add the contents below. Replace <HAProxy Enterprise Key> with the key you received when you registered.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/1.6r2/debian-jessie/amd64/ jessie main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.6r2/debian-jessie/amd64/ jessie main
  • Install required dependencies:

    sudo apt-get install --yes apt-transport-https dirmngr gnupg-agent
  • The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key. Run the following command, and replace <HAProxy Enterprise Key> with the key you received when you registered.

    wget -O - https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.6r2.asc | sudo apt-key add -
  • Update the repository cache:

    sudo apt-get update
  • To install the load balancer, run:

    sudo apt-get install hapee-1.6r2-lb

    Output of a successful installation:

    Reading package lists... Done
    Building dependency tree
    Reading state information... Done
    The following extra packages will be installed:
           hapee-1.6r2-base openssl
    Suggested packages:
           ca-certificates
    The following NEW packages will be installed:
           hapee-1.6r2-base hapee-1.6r2-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
    [...]
  • To start HAProxy Enterprise, run:

    sudo systemctl enable hapee-1.6-lb
    sudo systemctl start hapee-1.6-lb
  • If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:

    sudo systemctl restart rsyslog

Install additional modules

HAProxy Enterprise comes with additional native and third-party modules such as the Real-time Dashboard and Antibot modules. Packages are separated into three repositories, which you already added during the installation.

Package Repository

Description

Common

Contains the primary components for HAProxy Enterprise

Plus

Contains add-on modules that extend HAProxy Enterprise

Extras

Contains supporting software: SNMP, RHI, VRRP, etc.

  • See available packages.

  • This list is also available by running the following command:

    apt-cache search hapee-1.6r2
  • Install a package using its name, for example:

    sudo apt-get install hapee-1.6r2-lb-update
  • See other parts of this documentation for instructions on how to enable and configure each package.

Locate installed directories

HAProxy Enterprise files are installed following these rules:

  • Binaries and documentation are in /opt/hapee-1.6/

    /opt/hapee-1.6/
        |-- bin
        |-- certs
        |-- doc
        |-- misc
        |-- misc
        |-- modules
        \`-- sbin
  • Configuration is installed in /etc/hapee-1.6/

    /etc/hapee-1.6/
      |-- hapee-lb.cfg
        |-- hapee-log.cfg
        |-- hapee-snmp.cfg
        \`-- hapee-vrrp.cfg
  • init scripts are installed in /etc/init.d/

    /etc/init.d/
      |-- hapee-1.6
      |-- hapee-1.6-lb
    
      |-- hapee-1.6-log
    
      |-- hapee-1.6-snmp-lb
      |-- hapee-1.6-stktagg
      |-- hapee-1.6-route
      |-- hapee-1.6-rhi
     \`-- hapee-1.6-vrrp

Configure HAProxy Enterprise

After you complete the installation, you can configure HAProxy Enterprise using the instructions in the Configuration section from the left-hand menu bar.