Installing on Linux

Install additional modules
Manual installation

Before you install, make sure you check out our Recommendations for optimal performance.

HAProxy Enterprise 1.7r2 is distributed through the Operating System package manager for the following Linux distributions.

CentOS
7 6

Debian
9 8

RedHat
7 6

Ubuntu
16.04 14.04

SUSE

Oracle
7 6

Note

HAProxy Enterprise requires OpenSSL 1.1.1, which ships with updates or backport branches for certain Linux distributions ship. For example, in the case of Ubuntu 18.04, OpenSSL is defined in the 'bionic-updates' repository, which you must declare in your source lists.

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

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://cdn.haproxy.com/static/install_haproxy_enterprise.sh | sudo bash /dev/stdin 1.7r2 <HAProxy Enterprise key>
```

Start HAProxy Enterprise:

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

On older systems that do not have systemctl, use:

$ sudo service hapee-1.7-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 available packages.

This list is also available by running the following command:

$ # On Debian/Ubuntu
$ apt-cache search hapee-1.7r2

$ # On CentOs/RedHat/Oracle
 $ yum search hapee-1.7r2

$ # On SUSE
$ zypper search hapee-1.7r2

Install a package using its name, for example:

$ # On Debian/Ubuntu
$ apt-get install hapee-1.7r2-lb-update

$ # On CentOs/RedHat/Oracle
$ yum install hapee-1.7r2-lb-udpate

$ # On SUSE
$ zypper install hapee-1.7r2-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.7/

/opt/hapee-1.7/
  |-- bin
  |-- certs
  |-- doc
  |-- misc
  |-- misc
  |-- modules
  \-- sbin

Configuration is installed in /etc/hapee-1.7/

/etc/hapee-1.7/
  |-- 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.7
  |-- hapee-1.7-lb

  |-- hapee-1.7-snmp-lb
  |-- hapee-1.7-stktagg
  |-- hapee-1.7-route
  |-- hapee-1.7-rhi
  |-- hapee-1.7-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.

Manual installation

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 information if our Installation script doesn't work for your infrastructure or you would like to ccustomize your installation.

Instructions for CentOS 7

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/1.7r2/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.7r2/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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.asc
```
Update the repository cache:
```
$ yum makecache
```

To install the load balancer, run:

$ yum install -y hapee-1.7r2-lb

Output of a successful installation:

[...]
Running Transaction
Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Note: you should edit /etc/sysctl.conf for system tuning.
Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Installed:
hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
Dependency Installed:
hapee-1.7r2-base.noarch 0:1.7r2.0-16.0
Complete!

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for CentOS 6

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/1.7r2/rhel-6/$basearch/bin/
gpgcheck=1

[hapee-plus]
name=hapee-plus
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/rhel-6/$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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.asc
```
Update the repository cache:
```
$ yum makecache
```

To install the load balancer, run:

$ yum install -y hapee-1.7r2-lb

Output of a successful installation:

[...]
Running Transaction
Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Note: you should edit /etc/sysctl.conf for system tuning.
Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Installed:
hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
Dependency Installed:
hapee-1.7r2-base.noarch 0:1.7r2.0-16.0
Complete!

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for Debian 9

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/1.7r2/debian-stretch/amd64/ stretch main
deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/debian-stretch/amd64/ stretch 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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ wget -O - https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.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.7r2-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.7r2-base openssl
Suggested packages:
       ca-certificates
The following NEW packages will be installed:
       hapee-1.7r2-base hapee-1.7r2-lb openssl
0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
[...]

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for Debian 8

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/1.7r2/debian-jessie/amd64/ jessie main
deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ wget -O - https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.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.7r2-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.7r2-base openssl
Suggested packages:
       ca-certificates
The following NEW packages will be installed:
       hapee-1.7r2-base hapee-1.7r2-lb openssl
0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
[...]

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for RedHat 7

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/1.7r2/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.7r2/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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.asc
```
Update the repository cache:
```
$ yum makecache
```

To install the load balancer, run:

$ yum install -y hapee-1.7r2-lb

Output of a successful installation:

[...]
Running Transaction
Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Note: you should edit /etc/sysctl.conf for system tuning.
Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Installed:
hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
Dependency Installed:
hapee-1.7r2-base.noarch 0:1.7r2.0-16.0
Complete!

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for RedHat 6

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/1.7r2/rhel-6/$basearch/bin/
gpgcheck=1

[hapee-plus]
name=hapee-plus
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/rhel-6/$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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.asc
```
Update the repository cache:
```
$ yum makecache
```

To install the load balancer, run:

$ yum install -y hapee-1.7r2-lb

Output of a successful installation:

[...]
Running Transaction
Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Note: you should edit /etc/sysctl.conf for system tuning.
Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Installed:
hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
Dependency Installed:
hapee-1.7r2-base.noarch 0:1.7r2.0-16.0
Complete!

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for Ubuntu 16.04

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/1.7r2/ubuntu-16.04/amd64/ xenial main
deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/ubuntu-16.04/amd64/ xenial 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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ wget -O - https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.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.7r2-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.7r2-base openssl
Suggested packages:
       ca-certificates
The following NEW packages will be installed:
       hapee-1.7r2-base hapee-1.7r2-lb openssl
0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
[...]

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for Ubuntu 14.04

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/1.7r2/ubuntu-14.04/amd64/ trusty main
deb [arch=amd64] https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/ubuntu-14.04/amd64/ trusty 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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ wget -O - https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.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.7r2-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.7r2-base openssl
Suggested packages:
       ca-certificates
The following NEW packages will be installed:
       hapee-1.7r2-base hapee-1.7r2-lb openssl
0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
[...]

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for Oracle 7

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/1.7r2/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.7r2/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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.asc
```
Update the repository cache:
```
$ yum makecache
```

To install the load balancer, run:

$ yum install -y hapee-1.7r2-lb

Output of a successful installation:

[...]
Running Transaction
Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Note: you should edit /etc/sysctl.conf for system tuning.
Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Installed:
hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
Dependency Installed:
hapee-1.7r2-base.noarch 0:1.7r2.0-16.0
Complete!

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

Instructions for Oracle 6

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/1.7r2/rhel-6/$basearch/bin/
gpgcheck=1

[hapee-plus]
name=hapee-plus
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/1.7r2/rhel-6/$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, replacing <HAProxy Enterprise Key> with the key you were given when you registered.
```
$ rpm --import https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-common/HAPEE-key-1.7r2.asc
```
Update the repository cache:
```
$ yum makecache
```

To install the load balancer, run:

$ yum install -y hapee-1.7r2-lb

Output of a successful installation:

[...]
Running Transaction
Installing : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Note: you should edit /etc/sysctl.conf for system tuning.
Installing : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Verifying  : hapee-1.7r2-base-1.7r2.0-16.0.noarch      1/2
Verifying  : hapee-1.7r2-lb-1.7r2.0-67.20.x86_64       2/2
Installed:
hapee-1.7r2-lb.x86_64 0:1.7r2.0-67.20
Dependency Installed:
hapee-1.7r2-base.noarch 0:1.7r2.0-16.0
Complete!

To start HAProxy Enterprise, run:

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

If you have installed Rsyslog, restart it now to begin collecting HAProxy logs:
```
$ sudo systemctl restart rsyslog
```

HAProxy Enterprise 1.7r2 Documentation

Searching HAProxy Enterprise 1.7r2

Installing on Linux

Install additional modules

Locate installed directories

Configure HAProxy Enterprise

Manual installation

Instructions for CentOS 7

Instructions for CentOS 6

Instructions for Debian 9

Instructions for Debian 8

Instructions for RedHat 7

Instructions for RedHat 6

Instructions for Ubuntu 16.04

Instructions for Ubuntu 14.04

Instructions for Oracle 7

Instructions for Oracle 6