HAPEE is distributed through the Operating System package manager.

To install it, proceed as follows:

  1. Create the repository file.
  2. Install HAPEE and components.

Note

HAPEE 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. IE: hapee.repo

Add the HAPEE 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.5r2/rhel-7/$basearch/bin/
gpgcheck=1
[hapee-base-source]
name=hapee-base-source
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.5r2/rhel-7/$basearch/source/
gpgcheck=1

  2. Replace the tag YOURKEYHERE with the key you received from HAProxy.

Add the HAPEE components repository

HAPEE 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.5r2/rhel-7/$basearch/bin/
gpgcheck=1
[hapee-plus-source]
name=hapee-plus-source
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/1.5r2/rhel-7/$basearch/source/
gpgcheck=1

  2. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

Install HAPEE and components

About Dependencies

When required, yum resolves dependencies and automatically installs them.

Import HAProxy Technologies HAPEE public key

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.5r2.asc

Update Repository Cache

Run yum makecache to update the yum repository cache.

Search for Package Names

To find packages related to HAPEE:

yum search hapee-1.5r2

Output of a successful search:

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

Install the Load Balancer

To install the load balancer run:

yum install -y hapee-1.5r2-lb

Output of a successful installation:

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

Locate Destination Directories

HAPEE files are installed following these rules:

  • Binaries and documentation are in /opt/hapee-1.5/

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

  • Configuration is installed in /etc/hapee-1.5/

    /etc/hapee-1.5/
  |-- hapee-lb.cfg
    |-- hapee-log.cfg
    |-- hapee-snmp.cfg
    \`-- hapee-vrrp.cfg

    Note

    HAPEE Extensions may also add some files here.

  • init scripts are installed in /etc/init.d/

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

  |-- hapee-1.5-log

  |-- hapee-1.5-snmp-lb
  |-- hapee-1.5-stktagg
  |-- hapee-1.5-route
  |-- hapee-1.5-rhi
 \`-- hapee-1.5-vrrp

    Note

    HAPEE Extensions may also add some files here.

Enable services

To enable HAPEE services, refer to the documentation related to init scripts administration.