lvsm

lvsm provides a command shell to manage a Linux Virtual Server (LVS) as a unified system and aims to simplify the management of such systems. The program assumes a Linux server running IPVS with iptables rules as firewall.

Build

$ cd lvsm-<version>
$ python setup.py sdist

Install

$ cd lvsm-<version>
$ cd dist
$ pip install lvsm-<version>.tar.gz

Configure

The configuration file can be specified on the command line

$ lvsm --config=configfile

Otherwise the program will look for /etc/lvsm.conf to use.

Valid configuration directives are as follows:

• director: the type of director used for ipvs. Must be one of: ldirectord, keepalived, generic
• director_config: location of the director configuration file
• director_cmd: command to restart the director
• firewall_config: location of the iptables configuration file
• firewall_cmd: command restart the iptables firewall
• ipvsadm: location of the ipvsadm binary. Defaults to ipvsadm
• iptables: location of the iptables binary. Defaults to iptables
• maintenance_dir: directory used by ldirectord for disabling servers
• nodes: comma separated list of nodes if lvs runs in a cluster
• version_control: scm used for versioning configs. Only svn is supported at the moment

All other directives are invalid and cause an error message. Further, lines beginning with # are considered
comments and will not be parsed.

example:

# this line is a comment
director_config = /etc/ha.d/ldirectord.cf
firewall_config = /etc/iptables.rules
nodes = lb1, lb2

Use

See the project README for usage instructions.