Format of the vvd.config configuration file

The configuration file, /etc/vvd/vvd.config, is read when vvd starts running. It consists of a number of single line statements. Blank lines or lines beginning with a "#" are ignored. The configuration file has two sections, a "machines" section and an "applications" section. The "machines" section defines the names of other machines with which vvd will interact. The "applications" section defines the names and number of instances of any applications to be run.

A line in the "machines" section begins with either of the keywords MASTER or SLAVE. It is followed by an "=" symbol, then by the name of a machine. In the case of a SLAVE line, the machine name is followed by a ":" symbol and a port number when communicating with the slave machine. The port number normally used is 2929. There should be no spaces within an entry. Examples of suitable SLAVE and MASTER lines are:

    SLAVE=video.somewhere.com:2929
    MASTER=display.somewhere.com

Note that it is quite acceptable (though probably unusual) for a machine to be configured as both a SLAVE and a MASTER. It is also acceptable to have neither SLAVE nor MASTER entry: in fact, that is how a single machine AG node is configured.

A line in the "applications" sections begins with one of the keywords: "VID_vic", "AUD_rat" or "MUD_tkmoo". It is followed by an "=" symbol and then by the number of instances of the application to run. There should be no spaces within an entry. An example applications entry is:

    VID_vic=1

The above line instructs that 1 instance of vic be run as the video application.