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.

DESCRIPTION

       hapc needs an admin socket to be able to use it. So it is needed to add this to /etc/haproxy/haproxy.cfg:

       global
               stats socket /var/lib/haproxy/admin.sock mode 600 level admin

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.

                                                                                                         hapc(1)