HAProxy Enterprise is distributed through the Operating System package manager.

To install it, proceed as follows:

  1. Create the repository file.

  2. Install HAProxy Enterprise and components.

Note

HAProxy Enterprise components include modules, scripts, tools, and optimized third party software.

Create the repository file

Create a new repository description file in /etc/yum.repos.d/.

Note

The extension of the file must be repo (i.e. hapee.repo).

Add the HAProxy Enterprise load balancer repository

  1. In the file /etc/yum.repos.d/hapee.repo, add the content below.

    [hapee-base]
    name=hapee-base
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.7r1/rhel-7/$basearch/bin/
    gpgcheck=1
  2. Replace the tag YOURKEYHERE with the key you received from HAProxy.

Add the HAProxy Enterprise components repository

HAProxy Enterprise components include modules, scripts, tools, and optimized third party software.

  1. In the file /etc/yum.repos.d/hapee.repo, add the content below.

    [hapee-plus]
    name=hapee-plus
    enabled=1
    baseurl=https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/1.7r1/rhel-7/$basearch/bin/
    gpgcheck=1
  2. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

Install HAProxy Enterprise and components

About Dependencies

When required, yum resolves dependencies and automatically installs them.

Import your HAProxy Enterprise public key from HAProxy Technologies

Packages provided by HAProxy Technologies are signed. In order to install them, you first must import the public key:

rpm --import https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/HAPEE-key-1.7r1.asc

Update Repository Cache

Run yum makecache to update the yum repository cache.

Install the Load Balancer

To install the load balancer run:

yum install -y hapee-1.7r1-lb

Output of a successful installation:

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

Search for Package Names

To find packages related to HAProxy Enterprise:

yum search hapee-1.7r1

Output of a successful search:

[...]
hapee-1.7r1-base.noarch : HAPEE BASE : Common dependencies
hapee-1.7r1-cli.x86_64 : HAPEE CLI : Command line interface for HAPEE LB (socat)
hapee-1.7r1-cli-debuginfo.x86_64 : Debug information for package hapee-1.7r1-cli
hapee-1.7r1-lb.x86_64 : HAPEE LB : Layer 7 load-balancing (HAProxy)
hapee-1.7r1-lb-debuginfo.x86_64 : Debug information for package hapee-1.7r1-lb
hapee-1.7r1-lb-dev.x86_64 : HAPEE LB : developpement files
hapee-extras-vrrp.x86_64 : HAPEE VRRP : VRRP daemon (Keepalived).
hapee-extras-vrrp-debuginfo.x86_64 : Debug information for package hapee-extras-vrrp

Locate Destination 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

    Note

    HAProxy Enterprise Extensions may also add some files here.

  • 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-extras-vrrp

    Note

    HAProxy Enterprise Extensions may also add some files here.

Enable services

To enable HAProxy Enterprise services, run service <service name> start.

To start hapee-1.7-lb:

service hapee-1.7-lb start

For more information on how to configure HAProxy Enterprise to start with your system, refer to the documentation related to init scripts administration.

Post-installation

After you complete the installation, you can configure HAProxy Enterprise using the instructions in the Configuration section.