wdx.cfg(5) — Macro Packages and Conventions

Name

wdx.cfg - DECwatchdog/Autopilot mission file

Description

1 copy of this file is required on each member of the mission.

File characteristics are:

•all configuration files consist of ASCII text entries,

•a text editor is required for their update,

•a new line is used to delimit each entry,

•A null entry consists of an empty line,

•comments begin with #.

The mission file is a mandatory start up file for the WDX process. The content of this file must be identical on all members of the mission. It lists all the members, their roles in the mission, the
priority for mastership, and time parameters.

The naming convention for the mission file is mission.cfg where mission is the mission’s name.

Version and Date line

The obligatory format keyword value for "VERSION" is:

VERSION X.Y

where X and Y represent 1 number.

The format for "DATE" is a zone of up to 20 characters:

DATE dd-mmm-yyyy

The VERSION line must be the same on all the members of the mission.

Member line

The format of "member characteristics" lines is:

member name type priority broadcast validity redundancy network_1 network_2

where:

•member is a keyword,

•name: the name of the member is either any name or hostname.

•type: wdx process is configured to provide either MASTER-SLAVE or SATELLITE features only.

•The keyword for MASTER-SLAVE is: MAS/SLA

•the keyword for SATELLITE is: SAT

•priority: This parameter defines the priority level of each member in the mission when there is a MASTERTOKEN request. The member with the highest priority is considered as the preferred member to be started as the MASTER during the MASTERTOKEN request. The parameter is valid only for the MASTER-SLAVE member type. The highest priority value is zero

•broadcast: wdx process periodically broadcasts information.
Broadcast time determines the period of the broadcast in seconds. Broadcast must be a positive integer value. There is no default value. The minimum value is 3 seconds.

•validity: Each broadcast has a validity period attached. If the validity period has expired, the broadcast is considered as invalid. The validity period is expressed in seconds. The validity period must be greater than broadcast time; the minimum value is (broadcast time + 1) seconds. A useful value for validity is (broadcast time x 3) seconds. There is no default.

•redundancy: Each message is sent (redundancy) times on each configured interface in order to tolerate a single message loss on the interface(s). Redundancy must be a non-zero integer value. There is no default.

•network_1 or network_2: This is the name of a configured Ethernet interface supporting TCP/IP. For example, "ln0". If no Ethernet interface is defined for the network, "N/A" is required

In a line, each element is MANDATORY.

Example

##########################################################################
#
#                          DECwatchdog/Autopilot V2.1
#
#                      Mission file for DECwatchdog/Autopilot
#
##########################################################################
#
# Mission file must be identical on all members in the mission
#
# All fields are MANDATORY.
# Format:
# name    type    priority broadcast validity redundancy network-1 network-2
#
# Example:
DATE 20-MAY-1994
VERSION 2.1
MEMBER volnay MAS/SLA 1        5        12       1          ln0       ln1
MEMBER chalut MAS/SLA 1        5        12       1          ln0       ln1
MEMBER wdix    MAS/SLA 0        5        12       1          ZE0       N/A
MEMBER titanix.aeo.dec.com MAS/SLA 1 5 12       1          SE0       n/a
MEMBER bandol MAS/SLA 0        5        15       1          lance01   N/A

Museum