Installing on Debian 7 (Wheezy)

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.
  1. Install HAPEE and components.

Create the repository file

  • Create a new list repository source file in /etc/apt/sources.list.d/.
Note: The extension of the file must be list(i.e. hapee.list)

Add the HAPEE load balancer to the repository

  1. In the file /etc/apt/sources.list.d/hapee.repo, add the content below.
  2. Replace the tag <YOURKEYHERE> with the key you received from HAProxy.
deb http://www.haproxy.com/download/hapee/key/<YOURKEYHERE>-common/1.6r2/debian-wheezy/amd64/ wheezy main

Add HAPEE components to the repository

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

  1. In the file /etc/apt/sources.list.d/hapee.repo add the content below.
  2. Replace the tag <YOURKEYHERE> with the key you received from HAProxy.
deb http://www.haproxy.com/download/hapee/key/<YOURKEYHERE>-plus/1.6r2/debian-wheezy/amd64/ wheezy main

Install HAPEE and components

About Dependencies

When required, apt 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:

curl -s http://www.haproxy.com/download/hapee/key/<YOURKEYHERE>-common/HAProxy-key-20140923.asc | apt-key add -

Update Repository Cache

Run apt-get update to update the apt repository cache.

Note: HAPEE repositories are 64 bits only. In some cases, the operating system may not find i386 packages. If this happens, add [arch=amd64] after the debkeyword of your HAPEE repository file.

Search for Package Names

To find packages related to HAPEE:

apt-cache search hapee-1.6r2
hapee-1.6r2-lb - HAPEE LB : Layer 7 load-balancing (HAProxy).
hapee-1.6r2-cli - HAPEE CLI : Command line interface for HAPEE LB (socat)
hapee-1.6r2-vrrp - HAPEE VRRP : VRRP daemon (Keepalived).
hapee-1.6r2-base - HAPEE BASE : Common dependencies

Install the Load Balancer

apt-get install hapee-1.6r2-lb
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following extra packages will be installed:
	hapee-1.6r2-base openssl
Suggested packages:
	ca-certificates
The following NEW packages will be installed:
	hapee-1.6r2-base hapee-1.6r2-lb openssl
0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded.
[...]

Locate Destination Directories

  • Binaries and documentation are in /opt/hapee-1.6r2/
/opt/hapee-1.6r2
	|-- bin
	|-- certs
	|-- doc
	|-- misc
	|-- misc	
	|-- modules
	`-- sbin
  • Configuration is installed in /etc/hapee-1.6r2/
/etc/hapee-1.6r2/
	|-- 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.6r2
	|-- hapee-1.6r2-lb
	|-- hapee-1.6r2-log
	|-- hapee-1.6r2-snmp
	`-- hapee-1.6r2-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.