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 list repository source file in /etc/apt/sources.list.d/.

Note

The extension of the file must be list. IE: hapee.list

Add the HAPEE load balancer repository

  1. In the file /etc/apt/sources.list.d/hapee.list, add the content below:

    deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.7r1/ubuntu-14.04/amd64/ trusty main
  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/apt/sources.list.d/hapee.list add the content below:

    deb https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/1.7r1/ubuntu-14.04/amd64/ trusty main
  2. Replace the tag [YOURKEYHERE] with the key you received from HAProxy.

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 -L https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/HAPEE-key-1.7r1.asc | apt-key add -

Enable HTTPS

To allow apt to access repositories over HTTPS, run:

apt-get install apt-transport-https

Update Repository Cache

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

Warning

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 deb keyword of your HAPEE repository file.

Search for Package Names

To find packages related to HAPEE 1.7r1, run:

apt-cache search hapee-1.7r1

Output of successful run:

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

Locate Destination Directories

HAPEE 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

    HAPEE 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-1.7-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.