############################
Keepalived programs synopsis
############################

Keepalived package comes with 2 programs.

keepalived daemon
*****************

The keepalived command line arguments are:

.. glossary::

    -f, --use-file=FILE
        Use the specified configuration file. The default configuration file is "/etc/keepalived/keepalived.conf".

    -P, --vrrp
        Only run the VRRP subsystem. This is useful for configurations that do not use IPVS load balancer.

    -C, --check
        Only run the healthcheck subsystem. This is useful for configurations that use the IPVS load balancer with a single director with no failover.

    -l, --log-console
        Log messages to the local console. The default behavior is to log messages to syslog.

    -D, --log-detail
        Detailed log messages.

    -S, --log-facility=[0-7]
        Set syslog facility to LOG_LOCAL[0-7]. The default syslog facility is LOG_DAEMON.

    -V, --dont-release-vrrp
        Don’t remove VRRP VIPs and VROUTEs on daemon stop. The default behavior is to remove all VIPs and VROUTEs when keepalived exits

    -I, --dont-release-ipvs
        Don’t remove IPVS topology on daemon stop. The default behavior is to remove all entries from the IPVS virtual server table on when keepalived exits.

    -R, --dont-respawn
        Don’t respawn child processes. The default behavior is to restart the VRRP and checker processes if either process exits.

    -n, --dont-fork
        Don’t fork the daemon process. This option will cause keepalived to run in the foreground.

    -d, --dump-conf
        Dump the configuration data.

    -p, --pid=FILE
        Use specified pidfile for parent keepalived process. The default pidfile for keepalived is "/var/run/keepalived.pid".

    -r, --vrrp_pid=FILE
        Use specified pidfile for VRRP child process. The default pidfile for the VRRP child process is "/var/run/keepalived_vrrp.pid".

    -c, --checkers_pid=FILE
        Use specified pidfile for checkers child process. The default pidfile for the checker child process is "/var/run/keepalived_checkers.pid".

    -x, --snmp
        Enable SNMP subsystem.

    -v, --version
        Display the version and exit.

    -h, --help
        Display this help message and exit.

genhash utility
***************

The ``genhash`` binary is used to generate digest strings. The genhash command
line arguments are:

.. glossary::

    --use-ssl, -S
          Use SSL to connect to the server.

    --server <host>, -s
          Specify the ip address to connect to.

    --port <port>, -p
          Specify the port to connect to.

    --url <url>, -u
          Specify the path to the file you want to generate the hash of.

    --use-virtualhost <host>, -V
          Specify the virtual host to send along with the HTTP headers.

    --hash <alg>, -H
          Specify the hash algorithm to make a digest of the target page.   Consult  the
          help screen for list of available ones with a mark of the default one.

    --verbose, -v
          Be verbose with the output.

    --help, -h
          Display the program help screen and exit.

    --release, -r
          Display the release number (version) and exit.

Running Keepalived daemon
*************************

To run Keepalived simply type::

    [root@lvs tmp]# /etc/rc.d/init.d/keepalived.init start
    Starting Keepalived for LVS:                            [ OK ]

All daemon messages are logged through the Linux syslog. If you start Keepalived with the “dump configuration data” option, you should see in your /var/log/messages (on Debian this may be */var/log/daemon.log* depending on your syslog configuration) something like this::

    Jun 7 18:17:03 lvs1 Keepalived: Starting Keepalived v0.6.1 (06/13, 2002)
    Jun 7 18:17:03 lvs1 Keepalived: Configuration is using : 92013 Bytes
    Jun 7 18:17:03 lvs1 Keepalived: ------< Global definitions >------
    Jun 7 18:17:03 lvs1 Keepalived: LVS ID = LVS_PROD
    Jun 7 18:17:03 lvs1 Keepalived: Smtp server = 192.168.200.1
    Jun 7 18:17:03 lvs1 Keepalived: Smtp server connection timeout = 30
    Jun 7 18:17:03 lvs1 Keepalived: Email notification from = keepalived@domain.com
    Jun 7 18:17:03 lvs1 Keepalived: Email notification = alert@domain.com
    Jun 7 18:17:03 lvs1 Keepalived: Email notification = 0633556699@domain.com
    Jun 7 18:17:03 lvs1 Keepalived: ------< SSL definitions >------
    Jun 7 18:17:03 lvs1 Keepalived: Using autogen SSL context
    Jun 7 18:17:03 lvs1 Keepalived: ------< LVS Topology >------
    Jun 7 18:17:03 lvs1 Keepalived: System is compiled with LVS v0.9.8
    Jun 7 18:17:03 lvs1 Keepalived: VIP = 10.10.10.2, VPORT = 80
    Jun 7 18:17:03 lvs1 Keepalived: VirtualHost = www.domain1.com
    Jun 7 18:17:03 lvs1 Keepalived: delay_loop = 6, lb_algo = rr
    Jun 7 18:17:03 lvs1 Keepalived: persistence timeout = 50
    Jun 7 18:17:04 lvs1 Keepalived: persistence granularity = 255.255.240.0
    Jun 7 18:17:04 lvs1 Keepalived: protocol = TCP
    Jun 7 18:17:04 lvs1 Keepalived: lb_kind = NAT
    Jun 7 18:17:04 lvs1 Keepalived: sorry server = 192.168.200.200:80
    Jun 7 18:17:04 lvs1 Keepalived: RIP = 192.168.200.2, RPORT = 80, WEIGHT = 1
    Jun 7 18:17:04 lvs1 Keepalived: RIP = 192.168.200.3, RPORT = 80, WEIGHT = 2
    Jun 7 18:17:04 lvs1 Keepalived: VIP = 10.10.10.3, VPORT = 443
    Jun 7 18:17:04 lvs1 Keepalived: VirtualHost = www.domain2.com
    Jun 7 18:17:04 lvs1 Keepalived: delay_loop = 3, lb_algo = rr
    Jun 7 18:17:04 lvs1 Keepalived: persistence timeout = 50
    Jun 7 18:17:04 lvs1 Keepalived: protocol = TCP
    Jun 7 18:17:04 lvs1 Keepalived: lb_kind = NAT
    Jun 7 18:17:04 lvs1 Keepalived: RIP = 192.168.200.4, RPORT = 443, WEIGHT = 1
    Jun 7 18:17:04 lvs1 Keepalived: RIP = 192.168.200.5, RPORT = 1358, WEIGHT = 1
    Jun 7 18:17:05 lvs1 Keepalived: ------< Health checkers >------
    Jun 7 18:17:05 lvs1 Keepalived: 192.168.200.2:80
    Jun 7 18:17:05 lvs1 Keepalived: Keepalive method = HTTP_GET
    Jun 7 18:17:05 lvs1 Keepalived: Connection timeout = 3
    Jun 7 18:17:05 lvs1 Keepalived: Nb get retry = 3
    Jun 7 18:17:05 lvs1 Keepalived: Delay before retry = 3
    Jun 7 18:17:05 lvs1 Keepalived: Checked url = /testurl/test.jsp,
    Jun 7 18:17:05 lvs1 Keepalived: digest = 640205b7b0fc66c1ea91c463fac6334d
    Jun 7 18:17:05 lvs1 Keepalived: 192.168.200.3:80
    Jun 7 18:17:05 lvs1 Keepalived: Keepalive method = HTTP_GET
    Jun 7 18:17:05 lvs1 Keepalived: Connection timeout = 3
    Jun 7 18:17:05 lvs1 Keepalived: Nb get retry = 3
    Jun 7 18:17:05 lvs1 Keepalived: Delay before retry = 3
    Jun 7 18:17:05 lvs1 Keepalived: Checked url = /testurl/test.jsp,
    Jun 7 18:17:05 lvs1 Keepalived: digest = 640205b7b0fc66c1ea91c463fac6334c
    Jun 7 18:17:05 lvs1 Keepalived: Checked url = /testurl2/test.jsp,
    Jun 7 18:17:05 lvs1 Keepalived: digest = 640205b7b0fc66c1ea91c463fac6334c
    Jun 7 18:17:06 lvs1 Keepalived: 192.168.200.4:443
    Jun 7 18:17:06 lvs1 Keepalived: Keepalive method = SSL_GET
    Jun 7 18:17:06 lvs1 Keepalived: Connection timeout = 3
    Jun 7 18:17:06 lvs1 Keepalived: Nb get retry = 3
    Jun 7 18:17:06 lvs1 Keepalived: Delay before retry = 3
    Jun 7 18:17:06 lvs1 Keepalived: Checked url = /testurl/test.jsp,
    Jun 7 18:17:05 lvs1 Keepalived: digest = 640205b7b0fc66c1ea91c463fac6334d
    Jun 7 18:17:06 lvs1 Keepalived: Checked url = /testurl2/test.jsp,
    Jun 7 18:17:05 lvs1 Keepalived: digest = 640205b7b0fc66c1ea91c463fac6334d
    Jun 7 18:17:06 lvs1 Keepalived: 192.168.200.5:1358
    Jun 7 18:17:06 lvs1 Keepalived: Keepalive method = TCP_CHECK
    Jun 7 18:17:06 lvs1 Keepalived: Connection timeout = 3
    Jun 7 18:17:06 lvs1 Keepalived: Registering Kernel netlink reflector