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)