Command Line Interface
An HAProxy Enterprise Command Line Interface is available from the package hapee-1.6r2-cli
and allows you to:
Report information about the current HAProxy Enterprise deployment
Manage HAProxy Enterprise processes
Interact with
hapee-1.6-lb
stats socket to report statistics, current sessions, errorsOpen a shell on running
hapee-1.6-lb
Print help
Install HAProxy Enterprise CLI
To install the HAProxy Enterprise CLI package run:
$ # On Debian/Ubuntu
$ sudo apt-get install hapee-1.6r2-cli
$ # On CentOS/RedHat/Oracle
$ sudo yum install hapee-1.6r2-cli
The package adds a bash completion script in /etc/bash_completion.d/hapee-1.6-completion.sh
This script executes when you log into the server and enables a new command called hapee
. To use it, type hapee
and press the [TAB] key twice:
$ hapee
condrestart force-reload help lb reload
restart start status stop try-restart version
Retrieve an information report
To get an information report, enter the HAProxy Enterprise version for the CLI reports your want to retrieve:
The HAProxy Enterprise version
Installed HAProxy Enterprise packages
Installed HAProxy Enterprise packages versions
On Debian/Ubuntu
$ hapee version
HAPEE version 1.6r2
ii hapee-1.6r2-base 1.6... all HAPEE BASE : Common dependencies
ii hapee-1.6r2-cli 1.6... amd64 HAPEE CLI : Command line interfac
dpkg-query: no packages found matching hapee-1.6r2-cli-lb
ii hapee-1.6r2-lb 1.6... amd64 HAPEE LB : Layer 7 load-balancing
dpkg-query: no packages found matching hapee-1.6r2-lb-sanitize
dpkg-query: no packages found matching hapee-1.6r2-lb-update
dpkg-query: no packages found matching hapee-1.6r2-log
dpkg-query: no packages found matching hapee-1.6r2-rhi
dpkg-query: no packages found matching hapee-1.6r2-route
dpkg-query: no packages found matching hapee-1.6r2-snmp
dpkg-query: no packages found matching hapee-1.6r2-vrrp
On CentOS/RedHat
$ hapee version
HAPEE version 1.6
hapee-1.6r2-base-1.6....noarch
hapee-1.6r2-cli-1.6....x86_64
package hapee-1.6r2-cli-lb is not installed
hapee-1.6r2-lb-1.6....x86_64
package hapee-1.6r2-lb-sanitize is not installed
package hapee-1.6r2-lb-update is not installed
package hapee-1.6r2-log is not installed
package hapee-1.6r2-rhi is not installed
package hapee-1.6r2-route is not installed
package hapee-1.6r2-snmp is not installed
package hapee-1.6r2-vrrp is not installed
Manage HAProxy Enterprise processes
You can manage HAProxy Enterprise processes with the command: hapee <action> [<service name>]
.
CLI can execute the following actions on any daemon installed by HAProxy Enterprise:
Action | Description |
---|---|
| restart a service only if it was already running |
| reload a service configuration |
| reload service configuration |
| restart a service |
| start a service |
| stop a service |
| like |
If you do not specify a service name, the command executes the action on all HAProxy Enterprise services. It is the shortened version of the service name, such lb
, log
, rhi
, route
, vrrp
, etc.
Start all services:
$ hapee start
Reload hapee-1.6-lb
configuration:
$ hapee reload lb
Check HAProxy Enterprise status
The HAProxy Enterprise CLI can report on the status of each daemon with the command hapee status [<service name>]
If you do not specify the service name, the command reports on all statuses of all daemons.
Display the status of HAProxy:
$ hapee status lb
$ hapee status lb
hapee-1.6r2-lb (pid 1136) is running...
Display the status of all HAProxy Enterprise services:
$ hapee status
$ hapee status
hapee-1.6r2-vrrp (pid 1120) is running...
hapee-1.6r2-lb (pid 1136) is running...
rsyslogd (pid 1145) is running...
hapee-1.6r2-rhi is not installed
hapee-1.6r2-route is not installed
hapee-1.6r2-route6 is not installed
hapee-1.6r2-snmp is not installed
Get Help
You can also use the HAProxy Enterprise CLI to get help about installed components, such as:
Daemon options
Configuration
Use cases
To use this command: enter hapee help <service name>
, then press [TAB] key to get the list of available help.
Read HAProxy Enterprise documentation:
$ hapee help lb config
Read VRRP configuration:
$ hapee help lb config
Next up
Data Plane API