SYNOPSIS

lava-coordinator --logfile=LOGFILE [--loglevel=INFO] lava-coordinator [{-h | --help}]

DESCRIPTION

This manual page documents briefly the lava-coordinator daemon.

lava-coordinator is a daemon to manage Multi-Node communications between LAVA devices under test.

OPTIONS

--logfile=LOGFILE

Overrides the default log file location of <file>/var/log/lava-coordinator.log</file>

--loglevel=LOGLEVEL

Overrides the default log level of INFO. Available options, in increasing order of verbosity, are: ERROR, WARNING, INFO, DEBUG.

-h, --help

Show summary of options.

FILES

/etc/lava-coordinator/lava-coordinator.conf

The system-wide configuration file to control the behaviour of lava-coordinator. A LAVA NodeDispatcher installed on the same machine as the coordinator will use the same file. NodeDispatchers on remote machines need their own copy of this file, modified so that the coordinator_hostname field is the hostname or IP address of the machine running the coordinator.

LAVA LAB SETUP

The LAVA Coordinator needs to be in lock-step with compatible versions of the LAVA NodeDispatcher (part of lava-dispatcher / lava-server) but the coordinator is a singleton and there can be multiple dispatchers, none of which need to be on the same machine as the coordinator.

Additionally, when a dispatcher is installed on a machine other than the machine running the coordinator, a copy of the LAVA Coordinator conffile needs to be copied to that machine and modified to indicate the hostname or IP address of the LAVA Coordinator for that dispatcher. Typically, this can be done with tools like salt, puppet, chef etc.

Therefore, lava-coordinator does not depend on the rest of LAVA and the setup of the coordinator is at the discretion of the LAVA lab administrator. As long as there is one Coordinator and all dispatchers have a working address for a coordinator, all should be well.

If a lab contains more than one Coordinator, it is recommended that each coordinator uses a different port. This is mandatory if more than one coordinator is installed on a single machine.

LAVA Coordinator is lightweight and has minimal dependencies, installing on virtualised hardware is not expected to be a problem.

AUTHOR

Neil Williams <[email protected]>

Author.

COPYRIGHT

Copyright © 2007 Neil Williams

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.