HAProxy Enterprise Documentation 2.1r1

Linux

HAProxy Enterprise 2.1r1 is distributed through the Operating System package manager for the following Linux distributions:

Install HAProxy Enterprise 2.1r1 on CentOS
CentOS
8 7
Install HAProxy Enterprise 2.1r1 on Debian
Debian
10 9
Install HAProxy Enterprise 2.1r1 on RedHat
RedHat
8 7
Install HAProxy Enterprise 2.1r1 on Ubuntu
Ubuntu
20.04 18.04 16.04
Install HAProxy Enterprise 2.1r1 on SUSE
SUSE
15.0
Install HAProxy Enterprise 2.1r1 on Oracle
Oracle
8 7

Install HAProxy Enterprise

The following procedure adds package repositories and installs HAProxy Enterprise 2.1r1. After the installation, you can install additional components to get the most out of your load balancer.

  1. Run the following command on the server where you would like to install HAProxy Enterprise, replacing <HAProxy Enterprise Key> with the key you were given when you registered.

    $ curl -s https://www.haproxy.com/static/install_haproxy_enterprise.sh | \
       sudo bash /dev/stdin 2.1r1 <HAProxy Enterprise key>

    To verify the integrity of the script before installing, download it and its hash to a local directory:

    Then run these commands to verify the checksum of the script:

    $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 0xCA2DF14657C5A207
    $ gpg --verify ./install_haproxy_enterprise.sh.sha512.asc
  2. Start HAProxy Enterprise:

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

    On systems that do not have systemctl, use:

    $ sudo service hapee-2.1-lb start

Install additional modules

HAProxy Enterprise comes with additional native and third-party modules like the Real-time Dashboard. 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 all available packages.

Search for additional modules

The list of additional modules is also available by running the following commands:

$ # On Debian/Ubuntu
$ apt-cache search hapee-2.1r1
$ apt-cache search hapee-extras

$ # On CentOs/RedHat
$ yum search hapee-2.1r1
$ yum search hapee-extras

$ # On SUSE
$ zypper search hapee-2.1r1
$ zypper search hapee-extras

Install a module

$ # On Debian/Ubuntu
$ sudo apt-get install hapee-2.1r1-lb-update
$ # On CentOS/RedHat/Oracle
$ sudo yum install hapee-2.1r1-lb-update
$ # On SUSE
$ sudo zypper install hapee-2.1r1-lb-update
$ # On FreeBSD
$ sudo pkg 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

Binaries and documentation

/opt/hapee-2.1/
  |-- bin
  |-- doc
  |-- modules
  |-- sbin
  |-- version

Configuration files

/etc/hapee-2.1/
  |-- hapee-lb.cfg

Init scripts

/etc/init.d/
  |-- hapee-2.1-lb

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.

Install HAProxy Enterprise manually

The following section gives detailed information on how to install HAProxy Enterprise 2.1r1 its associated components manually on all supported Operating Systems.

Use this procedure if our installation script is not suited for your infrastructure or if you want to customize your installation.

Instructions for CentOS 8

  1. 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 were given when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/rhel-8/$basearch/bin/
    gpgcheck=1
    
    [hapee-plus]
    name=hapee-plus
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/rhel-8/$basearch/bin/
    gpgcheck=1
    
    
    [hapee-plus-extras]
    name=hapee-plus-extras
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-8/$basearch/bin/
    gpgcheck=1
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ yum makecache
  4. To install the load balancer, run:

    $ yum install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Verifying  : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Verifying  : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Installed:
    hapee-2.1r1-lb.x86_64 0:2.1r1.0-67.20
    Dependency Installed:
    hapee-2.1r1-base.noarch 0:2.1r1.0-16.0
    Complete!
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for CentOS 7

  1. 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 were given when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/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/2.1r1/rhel-7/$basearch/bin/
    gpgcheck=1
    
    
    [hapee-plus-extras]
    name=hapee-plus-extras
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-7/$basearch/bin/
    gpgcheck=1
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ yum makecache
  4. To install the load balancer, run:

    $ yum install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Verifying  : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Verifying  : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Installed:
    hapee-2.1r1-lb.x86_64 0:2.1r1.0-67.20
    Dependency Installed:
    hapee-2.1r1-base.noarch 0:2.1r1.0-16.0
    Complete!
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Debian 10

  1. 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 were given when you registered.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/debian-buster/amd64/ buster main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/debian-buster/amd64/ buster main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/debian-buster/amd64/ buster main
  2. Install required dependencies:

    $ sudo apt-get install --yes apt-transport-https dirmngr gnupg-agent
  3. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc | sudo apt-key add -
    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc | sudo apt-key add -

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  4. Update the repository cache:

    $ sudo apt-get update
  5. To install the load balancer, run:

    $ sudo apt-get install hapee-2.1r1-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-2.1r1-base openssl
    Suggested packages:
           ca-certificates
    The following NEW packages will be installed:
           hapee-2.1r1-base hapee-2.1r1-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
    [...]
  6. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  7. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Debian 9

  1. 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 were given when you registered.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/debian-stretch/amd64/ stretch main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/debian-stretch/amd64/ stretch main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/debian-stretch/amd64/ stretch main
  2. Install required dependencies:

    $ sudo apt-get install --yes apt-transport-https dirmngr gnupg-agent
  3. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc | sudo apt-key add -
    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc | sudo apt-key add -

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  4. Update the repository cache:

    $ sudo apt-get update
  5. To install the load balancer, run:

    $ sudo apt-get install hapee-2.1r1-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-2.1r1-base openssl
    Suggested packages:
           ca-certificates
    The following NEW packages will be installed:
           hapee-2.1r1-base hapee-2.1r1-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
    [...]
  6. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  7. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for RedHat 8

  1. 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 were given when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/rhel-8/$basearch/bin/
    gpgcheck=1
    
    [hapee-plus]
    name=hapee-plus
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/rhel-8/$basearch/bin/
    gpgcheck=1
    
    
    [hapee-plus-extras]
    name=hapee-plus-extras
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-8/$basearch/bin/
    gpgcheck=1
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ yum makecache
  4. To install the load balancer, run:

    $ yum install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Verifying  : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Verifying  : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Installed:
    hapee-2.1r1-lb.x86_64 0:2.1r1.0-67.20
    Dependency Installed:
    hapee-2.1r1-base.noarch 0:2.1r1.0-16.0
    Complete!
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for RedHat 7

  1. 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 were given when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/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/2.1r1/rhel-7/$basearch/bin/
    gpgcheck=1
    
    
    [hapee-plus-extras]
    name=hapee-plus-extras
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-7/$basearch/bin/
    gpgcheck=1
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ yum makecache
  4. To install the load balancer, run:

    $ yum install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Verifying  : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Verifying  : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Installed:
    hapee-2.1r1-lb.x86_64 0:2.1r1.0-67.20
    Dependency Installed:
    hapee-2.1r1-base.noarch 0:2.1r1.0-16.0
    Complete!
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Ubuntu 20.04

  1. 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 were given when you registered.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/ubuntu-20.04/amd64/ focal main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/ubuntu-20.04/amd64/ focal main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/ubuntu-20.04/amd64/ focal main
  2. Install required dependencies:

    $ sudo apt-get install --yes apt-transport-https dirmngr gnupg-agent
  3. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc | sudo apt-key add -
    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc | sudo apt-key add -

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  4. Update the repository cache:

    $ sudo apt-get update
  5. To install the load balancer, run:

    $ sudo apt-get install hapee-2.1r1-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-2.1r1-base openssl
    Suggested packages:
           ca-certificates
    The following NEW packages will be installed:
           hapee-2.1r1-base hapee-2.1r1-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
    [...]
  6. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  7. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Ubuntu 18.04

  1. 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 were given when you registered.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/ubuntu-18.04/amd64/ bionic main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/ubuntu-18.04/amd64/ bionic main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/ubuntu-18.04/amd64/ bionic main
  2. Install required dependencies:

    $ sudo apt-get install --yes apt-transport-https dirmngr gnupg-agent
  3. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc | sudo apt-key add -
    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc | sudo apt-key add -

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  4. Update the repository cache:

    $ sudo apt-get update
  5. To install the load balancer, run:

    $ sudo apt-get install hapee-2.1r1-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-2.1r1-base openssl
    Suggested packages:
           ca-certificates
    The following NEW packages will be installed:
           hapee-2.1r1-base hapee-2.1r1-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
    [...]
  6. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  7. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Ubuntu 16.04

  1. 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 were given when you registered.

    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/ubuntu-16.04/amd64/ xenial main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/ubuntu-16.04/amd64/ xenial main
    deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/ubuntu-16.04/amd64/ xenial main
  2. Install required dependencies:

    $ sudo apt-get install --yes apt-transport-https dirmngr gnupg-agent
  3. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc | sudo apt-key add -
    $ wget -O - https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc | sudo apt-key add -

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  4. Update the repository cache:

    $ sudo apt-get update
  5. To install the load balancer, run:

    $ sudo apt-get install hapee-2.1r1-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-2.1r1-base openssl
    Suggested packages:
           ca-certificates
    The following NEW packages will be installed:
           hapee-2.1r1-base hapee-2.1r1-lb openssl
    0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
    [...]
  6. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  7. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for SUSE 15.0

  1. 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 were given 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
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ zypper makecache
  4. 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]
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Oracle 8

  1. 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 were given when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/rhel-8/$basearch/bin/
    gpgcheck=1
    
    [hapee-plus]
    name=hapee-plus
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/2.1r1/rhel-8/$basearch/bin/
    gpgcheck=1
    
    
    [hapee-plus-extras]
    name=hapee-plus-extras
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-8/$basearch/bin/
    gpgcheck=1
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ yum makecache
  4. To install the load balancer, run:

    $ yum install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Verifying  : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Verifying  : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Installed:
    hapee-2.1r1-lb.x86_64 0:2.1r1.0-67.20
    Dependency Installed:
    hapee-2.1r1-base.noarch 0:2.1r1.0-16.0
    Complete!
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Instructions for Oracle 7

  1. 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 were given when you registered.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/2.1r1/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/2.1r1/rhel-7/$basearch/bin/
    gpgcheck=1
    
    
    [hapee-plus-extras]
    name=hapee-plus-extras
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-7/$basearch/bin/
    gpgcheck=1
  2. The packages that HAProxy Technologies provides are signed. To install them, you first must import the public key.

    Run the following commands:

    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    Tip

    We encourage you to validate any fingerprints by downloading them first locally.

    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-2.1r1.asc
    $ wget https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc

    You can compare it with the output of this command:

    $ gpg --keyid-format long --with-fingerprint HAPEE-key-2.1r1.asc
    $ gpg --keyid-format long --with-fingerprint HAPEE-key-extras.asc
    Long PGP fingerprint (HAProxy Enterprise 2.1r1)
    830A EC2F 0277 3B85 393F  1101 B39D 35B2 86A3 FF2D
    Long PGP fingerprint (Extras)
    77A6 6FDC 5D4D 779E 9CB9  D580 9ABA 76BB 03A7 31D6
  3. Update the repository cache:

    $ yum makecache
  4. To install the load balancer, run:

    $ yum install -y hapee-2.1r1-lb

    Output of a successful installation:

    [...]
    Running Transaction
    Installing : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Note: you should edit /etc/sysctl.conf for system tuning.
    Installing : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Verifying  : hapee-2.1r1-base-2.1r1.0-16.0.noarch      1/2
    Verifying  : hapee-2.1r1-lb-2.1r1.0-67.20.x86_64       2/2
    Installed:
    hapee-2.1r1-lb.x86_64 0:2.1r1.0-67.20
    Dependency Installed:
    hapee-2.1r1-base.noarch 0:2.1r1.0-16.0
    Complete!
  5. To start HAProxy Enterprise, run:

    $ sudo systemctl enable hapee-2.1-lb
    $ sudo systemctl start hapee-2.1-lb
  6. If you have installed Rsyslog, restart it now to begin collecting HAProxy Enterprise logs:

    $ sudo systemctl restart rsyslog

Next up

Additional Packages