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 2.1r1 <HAProxy Enterprise key>
  • Start HAProxy Enterprise:

    sudo systemctl enable hapee-2.1-lb
    sudo systemctl start hapee-2.1-lb

    On older systems that do not have systemctl, use:

    sudo service hapee-2.1-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/zypp.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=HAProxy Enterprise Base
    enabled=1
    autorefresh=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/suse-15.0/x86_64/bin/
    path=/
    type=rpm-md
    keeppackages=0
    
    [hapee-plus]
    name=HAProxy Enterprise Base
    enabled=1
    autorefresh=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/suse-15.0/x86_64/bin/
    path=/
    type=rpm-md
    keeppackages=0
    
    [hapee-plus-extras]
    name=HAProxy Enterprise Base
    enabled=1
    autorefresh=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/suse-15.0/x86_64/bin/
    path=/
    type=rpm-md
    keeppackages=0
  • 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-2.1r1.asc
  • Update the repository cache:

    zypper makecache
  • To install the load balancer, run:

    zypper install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    The following 3 NEW packages are going to be installed:
    hapee-2.1r1-base hapee-2.1r1-lb libpcreposix0
    
    3 new packages to install.
    Overall download size: 3.6 MiB. Already cached: 0 B. After the operation, additional 13.9 MiB will be used.
    Continue? [y/n/v/...? shows all options] (y): y
    Retrieving package hapee-2.1r1-base-1.0.0-91.0.noarch (1/3), 13.4 KiB ( 18.6 KiB unpacked)
    Retrieving: hapee-2.1r1-base-1.0.0-91.0.suse-15.0.noarch.rpm .........................................................................................................................................[done]
    Retrieving package libpcreposix0-8.41-lp151.5.67.x86_64 (2/3), 16.6 KiB ( 10.1 KiB unpacked)
    Retrieving: libpcreposix0-8.41-lp151.5.67.x86_64.rpm ....................................................................................................................................[done (19.0 KiB/s)]
    Retrieving package hapee-2.1r1-lb-1.0.0-217.640.x86_64 (3/3), 3.5 MiB ( 13.9 MiB unpacked)
    Retrieving: hapee-2.1r1-lb-1.0.0-217.640.suse-15.0.x86_64.rpm ............................................................................................................................[done (1.1 MiB/s)]
    
    Checking for file conflicts: .........................................................................................................................................................................[done]
    (1/3) Installing: hapee-2.1r1-base-1.0.0-91.0.noarch .................................................................................................................................................[done]
    Additional rpm output:
    Note: you should edit /etc/sysctl.d/hapee-2.1.conf for system tuning.
    
    (2/3) Installing: libpcreposix0-8.41-lp151.5.67.x86_64 ...............................................................................................................................................[done]
    (3/3) Installing: hapee-2.1r1-lb-1.0.0-217.640.x86_64 .........................................................................................[done]
  • To start HAProxy Enterprise, run:

    sudo systemctl enable hapee-2.1-lb
    sudo systemctl start hapee-2.1-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:

    zypper search hapee-2.1r1
  • To find packages within the HAProxy Enterprise 'extras' repository, run:

    zypper search hapee-extras
  • Install a package using its name, for example:

    zypper install hapee-2.1r1-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-2.1/

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

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

    /etc/init.d/
      |-- hapee-2.1
      |-- hapee-2.1-lb
      |-- hapee-extras-snmp-lb
      |-- hapee-extras-stktagg
      |-- hapee-extras-spoa-sso
      |-- hapee-extras-route
      |-- hapee-extras-rhi
      \`-- hapee-extras-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.