'\" t
.\"     Title: LAVA-COORDINATOR
.\"    Author: Neil Williams <codehelp@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 07/06/2015
.\"    Manual: lava-coordinator Administrators Guide
.\"    Source: lava-coordinator
.\"  Language: English
.\"
.TH "LAVA\-COORDINATOR" "8" "07/06/2015" "lava-coordinator" "lava-coordinator Administrator"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
lava-coordinator \- Coordinator daemon for group messaging in MultiNode LAVA
.SH "SYNOPSIS"
.HP \w'\fBlava\-coordinator\fR\ 'u
\fBlava\-coordinator\fR \fB\-\-logfile=\fR\fB\fILOGFILE\fR\fR [\fB\-\-loglevel=\fR\fBINFO\fR]
.HP \w'\fBlava\-coordinator\fR\ 'u
\fBlava\-coordinator\fR [{\fB\-h\fR\ |\ \fB\-\-help\fR}]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBlava\-coordinator\fR
daemon\&.
.PP
\fBlava\-coordinator\fR
is a daemon to manage Multi\-Node communications between LAVA devices under test\&.
.SH "OPTIONS"
.PP
\fB\-\-logfile=\fR\fB\fILOGFILE\fR\fR
.RS 4
Overrides the default log file location of
<file>/var/log/lava\-coordinator\&.log</file>
.RE
.PP
\fB\-\-loglevel=\fR\fB\fILOGLEVEL\fR\fR
.RS 4
Overrides the default log level of INFO\&. Available options, in increasing order of verbosity, are: ERROR, WARNING, INFO, DEBUG\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Show summary of options\&.
.RE
.SH "FILES"
.PP
/etc/lava\-coordinator/lava\-coordinator\&.conf
.RS 4
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
\fBcoordinator_hostname\fR
field is the hostname or IP address of the machine running the coordinator\&.
.RE
.SH "LAVA LAB SETUP"
.PP
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\&.
.PP
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\&.
.PP
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\&.
.PP
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\&.
.PP
LAVA Coordinator is lightweight and has minimal dependencies, installing on virtualised hardware is not expected to be a problem\&.
.SH "AUTHOR"
.PP
\fBNeil Williams\fR <\&codehelp@debian\&.org\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2007 Neil Williams
.br
.PP
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\&.
.sp