Searching HAProxy Enterprise 1.8r2
Installing on Ubuntu 14.04 (Trusty)
Installing on Ubuntu 14.04 (Trusty)
HAProxy Enterprise is distributed through the Operating System package manager.
To install it, proceed as follows:
Note
HAProxy Enterprise components include modules, scripts, tools, and optimized third party software.
Create the repository file
The repository file holds repositories for the load balancer, HAProxy Enterprise components, and 'extras'.
The components repository includes modules, scripts, tools, and optimized third party software.
The 'extras' repository includes components that are independent of HAProxy Enterprise versions.
-
Create a new repository description file in
/etc/apt/sources.list.d/
.Note
The extension of the file must be list. IE: hapee.list
-
In the file
/etc/apt/sources.list.d/hapee.list
, add the contents below to copy the repositories for the load balancer and HAProxy Enterprise components, and 'extras'.deb [arch=amd64] https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-common/1.8r2/ubuntu-14.04/amd64/ trusty main deb [arch=amd64] https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/1.8r2/ubuntu-14.04/amd64/ trusty main deb [arch=amd64] https://www.haproxy.com/download/hapee/key/[YOURKEYHERE]-plus/extras/ubuntu-14.04/amd64/ trusty main
Replace the tag [YOURKEYHERE] with the key you received from HAProxy.
Install HAProxy Enterprise, components, and 'extras'
About dependencies
When required, apt
resolves dependencies and automatically installs them.
Import HAProxy Technologies public key
The packages that HAProxy Technologies provides are signed. 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.8r2.asc | apt-key add -
Enable HTTPS
-
To allow
apt
to access repositories over HTTPS, run:apt-get install apt-transport-https
Update the repository cache
-
Run
apt-get update
to update the repository cache.Warning
HAProxy Enterprise repositories are 64 bits only. In some cases, the operating system may not find i386 packages. If this happens, add
[arch=amd64]
after thedeb
keyword of your HAProxy Enterprise repository file.
Install the load balancer
-
To install the load balancer, run:
apt-get install hapee-1.8r2-lb
Output of a successful installation:
Reading package lists... Done Building dependency tree Reading state information... Done The following extra packages will be installed: hapee-1.8r2-base openssl Suggested packages: ca-certificates The following NEW packages will be installed: hapee-1.8r2-base hapee-1.8r2-lb openssl 0 upgraded, 3 newly installed, 0 to remove and 0 not upgraded. [...]
Search for package names
-
To find packages related to HAProxy Enterprise 1.8r2, run:
apt-cache search hapee-1.8r2
-
To find packages related to HAProxy Enterprise 'extras', run:
apt-cache search hapee-extras
Output of successful search:
[...] hapee-1.8r2-base.noarch : HAPEE BASE : Common dependencies hapee-1.8r2-cli.x86_64 : HAPEE CLI : Command line interface for HAPEE LB (socat) hapee-1.8r2-cli-debuginfo.x86_64 : Debug information for package hapee-1.8r2-cli hapee-1.8r2-lb.x86_64 : HAPEE LB : Layer 7 load-balancing (HAProxy) hapee-1.8r2-lb-debuginfo.x86_64 : Debug information for package hapee-1.8r2-lb hapee-1.8r2-lb-dev.x86_64 : HAPEE LB : development 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.8/
/opt/hapee-1.8/ |-- bin |-- certs |-- doc |-- misc |-- misc |-- modules \`-- sbin
-
Configuration is installed in
/etc/hapee-1.8/
/etc/hapee-1.8/ |-- 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.8 |-- hapee-1.8-lb |-- hapee-extras-snmp-lb |-- hapee-extras-stktagg |-- hapee-extras-spoa-sso |-- hapee-extras-route |-- hapee-extras-rhi \`-- hapee-extras-vrrp
Note
HAProxy Enterprise Extensions may also add some files here.
Enable services
-
To start HAProxy Enterprise, run:
service hapee-1.8 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 from the left-hand menu bar.