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

Copyright © 2002 Per Andreas Buer / Linpro AS.

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


SEE ALSO

lvs-kiss (8), lvs-kiss.conf (5), Config::General (3), Config::General::Interpolate (3), ipsvadm (8),