Installing on CentOS 7

HAPEE is distributed through the Operating System package manager.

To install it, proceed as follows:

  1. Create the repository file.
    1. Add the HAPEE load balancer to the repository.
    2. Add HAPEE components to the repository.
      HAPEE components include modules, scripts, tools, and optimized third party software.
  2. Install HAPEE and components.

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 HAPEE load balancer to the repository

  1. In the file /etc/yum.repos.d/hapee.repo, add the content below.
  2. Replace the tag <YOURKEYHERE> with the key you received from HAProxy.
[hapee-base]
name=hapee-base
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/<YOURKEYHERE>-common/
  1.6r2/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.6r2/rhel-7/$basearch/source/
gpgcheck=1

Add HAPEE components to the 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.
  2. Replace the tag <YOURKEYHERE> with the key you received from HAProxy.
[hapee-plus]
name=hapee-plus
enabled=1
baseurl=https://www.haproxy.com/download/hapee/key/<YOURKEYHERE>-plus/
  1.6r2/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.6r2/rhel-7/$basearch/source/
gpgcheck=1

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/RPM-GPG-KEY-HAProxy

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.6r2

[...]

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

Install the Load Balancer

yum install -y hapee-1.6r2-lb

[...]

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

Complete!

Locate Destination Directories

HAPEE files are installed following these rules:

  • Binaries and documentation are in /opt/hapee-1.6/
/opt/hapee-1.6
	|-- bin
	|-- certs
	|-- doc
	|-- misc
	|-- misc	
	|-- modules
	`-- sbin
  • Configuration is installed in /etc/hapee-1.6/
/etc/hapee-1.6/
	|-- 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.6
	|-- hapee-1.6-lb
	|-- hapee-1.6-log
	|-- hapee-1.6-snmp
	`-- hapee-1.6-vrrp
Note: HAPEE Extensions may also add some files here.

Enabling services

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