NAME¶

hapc - administrative commands for your haproxy service

SYNOPSIS¶

hapc <action> [options] [arguments]

DESCRIPTION¶

hapc configures the backends of an haproxy setup, so it is possible to put backend servers in maintenance gracefully.

OPTIONS¶

-verbose|-v

Display with a more verbose output.

ACTIONS¶

list-backends [-l|--links]

List all available backends, asking through the haproxy socket file.

list-frontends

List all available frontend as configured in the haproxy.cfg file.

list-config-backends

List all available backends as configured in the haproxy.cfg file.

list-servers [-b|--backend] <backend> [-d|--details]

List all available servers for a given backend. With --details, the command shows the state of the servers (if they are active in the backend or not).

list-connections [-b|--backend] <backend> [-s|--server] <server>

Show the number of connections for a given backend and server.

enable-server [-b|--backend] <backend> [-s|--server] <server>

Set a server as ACTIVE in its backend.

drain-server [-b|--backend] <backend> [-s|--server] <server> [-w|--wait]

Gracefuly drain a server from its backend. If the --wait option is added, then hapc waits for all connections to be closed before returning, with a timeout set to 60 seconds.

stop-server [-b|--backend] <backend> [-s|--server] <server>

Forceably remove a server from its backend, eventually killing existing connections.

check-safe-to-remove [-b|--backend] <backend> [-s|--server] <server>

Check if a server is safe to remove from its backend (ie: check if there's not existing connections to it).

reload-haproxy

Reload haproxy.

LICENSE¶

This is released under the Apache-2.0 license.

AUTHORS¶

This utility has been written by Olivier Chaze <olivier.chaze at infomaniak dot com> and Thomas Goirand <zigo at debian dot org> for internal use in the Infomaniak servers.