mclu (mini cluster) is a virtualization cluster manager.

The key features:

 - Entirely command line driven.

 - No required dependencies except ansible (on the client only),
   libvirt and ssh.

 - Nothing to install on the nodes except libvirtd and sshd.

 - Only designed for small clusters (up to around 10-20 hosts).

 - Simple configuration.

Example commands
----------------------------------------------------------------------

   mclu status                   Display status of the cluster
   mclu list                     List all virtual machines on the cluster
   mclu on ham0                  Switch on (wake-on-LAN) node 'ham0'
   mclu off ham0                 Power off node 'ham0' in the cluster
   mclu start ham0:vm            Start vm on node 'ham0'
   mclu stop ham0:*              Stop all VMs on node 'ham0'
   mclu migrate *:* ham2:        Live migrate all VMs to 'ham2'
   mclu build ham3:vm fedora-20  Build and run a new Fedora 20 VM on node 'ham3'
   mclu console ham3:fedora-20   Show me the serial console of a VM
   mclu viewer ham3:fedora-20    Show me the graphical console of a VM
   mclu info                     Print general configuration information
   mclu --help                   Print help on all commands

Since the mclu cluster is based on an ansible "hosts group", you can
also issue ansible commands, eg:

   ansible cluster -u root -a "yum -y update"   Update all nodes in the cluster
   ansible cluster -m ping                      Ping all nodes

Configuration notes
----------------------------------------------------------------------

See `CONFIGURATION'.

Dependencies
----------------------------------------------------------------------

To get a full list of the required and optional dependencies, look at:

 - configure.ac
 - mclu.spec.in

Building it
----------------------------------------------------------------------

If building straight from git, then do:

  autoreconf -i

To build:

  ./configure --prefix /usr --sysconfdir /etc
  make

To run without installing:

 - Edit the configuration file (mclu.conf).

 - Add the hosts group (usually called '[cluster]') to /etc/ansible/hosts.
   You can set $ANSIBLE_HOSTS to change the location of this file.

 - Run commands such as:

   ./run status
   ./run list

To install:

 - sudo make install

 - Edit the configuration file (/etc/mclu/mclu.conf).

 - Add the hosts group (usually called '[cluster]') to /etc/ansible/hosts.

 - Run commands such as:

   mclu status
   mclu list

Developer information
----------------------------------------------------------------------

The license is GPLv2+.

The git repo is:

  http://git.annexia.org/?p=mclu.git;a=summary

There is no mclu mailing list.  Send patches to the virt-tools mailing list:

  http://www.redhat.com/mailman/listinfo/virt-tools-list