COMMANDS

NAME

lvs-kiss-control - Control the lvs-kiss daemon.

SYNOPSIS

lvs-kiss-control [--options] <command>

DESCRIPTION

Unless the lvs-kiss daemon is started with the --nosocket option the daemon opens a socket on which there can be given commands. The lvs-kiss daemon can reload its configuration, shutdown, temporary disable and enable realservers, inspect status and such.

OPTIONS

--socket <socket>: Specify alternate socket - default is /var/run/lvs-kiss.sock.
--timeout <timeout>: Specify timeout (in seconds). Default is 30 seconds.
--verbose: Be a bit verbose.
--help: Displays help.

COMMANDS

status: Show status of all the virtualservers and the realservers. A virtualserver can be given as an option and the only this virtualserver will be shown. If a realserver is also given - only the status of this perticular realserver is shown.
qs: This command shows the internal load-queues of lvs-kiss. As with status a virtualserver or a virtualserver and a realserver might be given also to get a bit less information.
weights: Shows what weights the different servers are given. Might be narrowed down as status.
reload: Issues a reload command to lvs-kiss in order to make lvs-kiss reload its configuration.
shutdown: Issue a shutdown command.
disable <Virtualserver> <Realserver>: Temporarily disables a realserver.
enable: Enables or re-enables a realserver. Internally, this is done by marking the realserver as DEAD and the let lvs-kiss itself discover that the server is alive again. So, if you are taking a server down for maintainance you can disable it - disconnect the server and re-enable it in lvs-kiss. The server won't be used until it is declared healty by lvs-kiss itself.
ping: Check if lvs-kiss is alive. Can be used by the init-script in order to verify that lvs-kiss has started up.
debug <value>: ``debug 1'' turns on debugging. This makes lvs-kiss syslog quite a lot of information. ``debug 0'' turns it off again.
interval <interval>: Instructs lvs-kiss to set the interval between checks to <interval> seconds.
rinterval <rebalancing interval>: Instructs lvs-kiss to set the default rebalancing/check ratio. The default is to rebalance the realservers at every check - this also implies checking of load - if these are heavy, but the alive/dead-checks are not you might want to set rinterval to something higher the 1. Then lvs-kiss will rebalance the realservers at every N check. Please see the lvs-kiss manual page for more information.
config: Shows the running configuration - be aware that this representation might be somewhat different from what you are used to - and all comments are stripped off.

VERSION

This is lvs-kiss-control, a part of lvs-kiss 1.2

AUTHOR

Per Andreas Buer <perbu (at) linpro.no>

BUGS

Please report other bugs to the author.

COPYRIGHT

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.