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/yum.repos.d/hapee.repo if it does not exist and add the contents below. Replace <HAProxy Enterprise Key> with the key you received when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/1.6r2/rhel-7/$basearch/bin/
    gpgcheck=1
    
    [hapee-plus]
    name=hapee-plus
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.6r2/rhel-7/$basearch/bin/
    gpgcheck=1
  • 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.

    rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.6r2.asc
  • Update the repository cache:

    yum makecache
  • To install the load balancer, run:

    yum install -y hapee-1.6r2-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-1.6r2-base-1.6r2.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-1.6r2-lb-1.6r2.0-67.20.x86_64       2/2
    Verifying  : hapee-1.6r2-base-1.6r2.0-16.0.noarch      1/2
    Verifying  : hapee-1.6r2-lb-1.6r2.0-67.20.x86_64       2/2
    Installed:
    hapee-1.6r2-lb.x86_64 0:1.6r2.0-67.20
    Dependency Installed:
    hapee-1.6r2-base.noarch 0:1.6r2.0-16.0
    Complete!
  • 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:

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

    yum install hapee-1.6r2-lb-udpate
  • 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.