NAME

lvs-kiss - Linux Virtual Server made simple


SYNOPSIS

lvs-kiss [--options]


DESCRIPTION

lvs-kiss is designed to make load-balancing with fail-over simpler. The primary design-goal is for you to get load-balancing with failover up and running within an hour or so.

Secondary design goal is to be able to make this software as flexible and powerful as possible. Embedding of perl in configuration-files and load-balancing with custom made tests should be possible without to much hassle.

lvs-kiss is configured through a simple, apache-style configuration file. An load-balancer with failover for apache could look like this:

<VirtualServer web.foo.com:80> DynamicScheduler 1

 <RealServer web1.foo.com:80>
   Test wget -t10 -q -O /dev/null http://web1.foo.com/ping.pl
 </RealServer>
 <RealServer web2.foo.com:80>
   Test wget -t10 -q -O /dev/null http://web2.foo.com/ping.pl
 </RealServer>

</VirtualServer>

For details about the configuration, please see the lvs-kiss.conf manual page.

Once it is running, lvs-kiss can be controlled via the program lvs-kiss-control. lvs-kiss-control communicates with lvs-kiss via a socket. Operations such as reloading the configuration, shutting down, disabling and enabling servers can be done. Please see the lvs-kiss-control manual page for details.


OPTIONS

--config <configfile>
Specify alternate configuration file. Default if /etc/lvs-kiss.conf.

--interval
Time between checks, in seconds. The default is 20 seconds.

--rinterval
How often should a check include a complete rebalancing. If the loadmeasure is heavy on the realservers and you would rather see that is not performed so often you can set the rinterval to N. lvs-kiss then only performs rebalancing every N times. So - if you set interval to 10 (seconds) you can set rinterval to 6 and rebalacing will only occur once every 60 seconds.

You can also set a spesific rebalacing interval for each virtual server.

--syslog or --nosyslog
Enables or disables syslog. Default is to syslog.

--threads or --nothreads
Enables or disables the threading engine. Per default the threads are enabled. lvs-kiss uses traditional unix threads (fork). Unless you are debugging you probably don't need to disable threads.

--interpolate
Turns off interpolating of variables in the configuration. See the manual entry for Config::General::Interpolate.

--pidfile <pidfile>
Placement of pidfile. Default is /var/run/lvs-kiss.pid

--facility <facility>
Specifies what syslog facility lvs-kiss will use. Default is ``local1''.

--dry-run
Do not alter the Kernel Virtual Server Setup. All the tests are still run. You might wa nt to use --debug with this option.

--version
Show version number and exit.

--foreground
Do not daemonize. Stay in the foreground.

--debug
Turns on debugging. Implies --foreground.

--help
Gives help.


ENVIROMENT

lvs-kiss overrides the PATH. /bin:/usr/bin is used as path.


SIGNALS

lvs-kiss responds to the following signals.

SIGTERM
Programs exits in a safe manner.

SIGUSR1
Drop a nice status-report to /tmp/lvs-kiss.status.$$ Yes, I've been a good boy and lvs-kiss is checking if it is a symbolic link before overwriting it.

SIGHUP
Programs re-reads its configuration files.

SIGKILL
Be carefull sending SIGKILL to lvs-kiss. It might do some damage and leave your virtual server in a inconsistant state.


FILES

/etc/lvs-kiss.conf


VERSION

This is lvs-kiss 1.2


AUTHOR

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


BUGS

Please report bugs and functionality requests 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-control (8), lvs-kiss.conf (5), ipsvadm (8), Config::General (3), Config::General::Interpolate (3),