scorehosts.db(5)

SCOREHOSTS.DB(5)

FILE FORMATS

SCOREHOSTS.DB(5)

NAME

scorehosts.db - SCore Cluster Database

DESCRIPTION

Upon execution, scoreboard(8) reads its configuration information from a configuration file which, by default, is (INSTALL_DIR)/etc/scorehosts.db. The file consists of a number of records. Each record has a unique name to identify it with other records in the file, and each record has several attributes. The attributes consist of an attribute name and one or more associated values. All values are treated as character strings, and there is no data type.

A record is terminated by a newline (\n) character. The record name is the first blank-separated token followed by one or more attribute/value pairs. Each attribute name and value pair is also separated by blank(s) or tab(s). The equal (=) character, immediately after the attribute name, separates attribute name and value tokens. Lists of values are separated by comma (,). There is no way to include a blank character in a record name, an attribute name, or a value.

Here is an example of a record:

a b=1,2,3 c=true

This describes a record "a" having two attributes "b" and "c". The values of attribute "b" are "1", "2", and "3". The "c" attribute has only one value of "true". There can be multiple attributes with the same name in a record, and in this case, the values list is treated as a concatenation of the attribute values.

A value can also be path to a file. When there is a record like:

dwarf bib:file=/home/dwarf/bibliography.txt

In this case, the attribute name must be suffixed by :file. If a client program running on a remote host tries to read the file located on the server host where the scoreboard program is running, the scoreboard program and its client library together make a cache file on the client host. The cached file is located in the directory /var/scored/scoreboard, and the cached file name is encoded to identify the original file.

The database file is firstly preprocessed by the cpp(1) UNIX program when the database file is analyzed by the scoreboard program. Thus users can include any other database file (using #include) or define (using #define) any macros in the database file. INSTALL_DIR is a predefined symbol and set to the same directory where scoreboard was installed. Consult your system administrator for the exact location. All parentheses ("(" and ")") are ignored, however, unmatched parentheses are warned. Usually parentheses are used to separate macros with other symbols. Here is an example.

troll datafile=(INSTALL_DIR)/troll.txt

When a client tries to open and read this file, the original file is located in the INSTALL_DIR directory, and INSTALL_DIR is defined when scoreboard was made.

* Attributes used by the SCore Cluster System Software

The Cluster Database file must hold all cluster configuration information required by the SCore programs. There must be two types of records, host records and network records.

Host record
The record name of a host record must be exactly the same name as the hostname of the host. The order of host records affects the order of node numbers in a group. The first host of a host group, from the beginning of the database file, will have node number zero (0).
Required attributes depend on which SCore programs will be run.

Program name Attribute name

msgbserv group msgbserv
scout group msgbserv [spare]
scored network cpugen speed smp [watchfs]

The attributes are as follows:

group
Specify a set of hosts and give them a name. A host may belong to several host groups.

msgbserv
Specify the Compute Host Lock Server hostname (and port number) to lock a host when it is occupied, and unlock it when finished. The hostname must be exactly the same name as that produced by the hostname(1) command. The port number, if any, must be an even number.

spare
Specify a list of host names one of which is used as a spare when the host record is specified in the defected file. The host(s) specified in the spare attribute must have a host record having the same msgbserv value, but belonging to no host group. This is an optional attribute.

network
Specify a network record name to configure PM devices. The name of this record might be specified scrun command. (See network record section below in this page)

cpugen
Specify processor (CPU) generation so that SCore users can select specific types of processors to run their programs

speed
Specify processor speed factor so that SCore users can select specific processor speeds. This value must be numeric. Usually, this number correlates with the clock speed of processor (in MHz)

smp
Number of processors installed in the host. This value must be numeric. If there is only one processor installed then smp=1 must be set

watchfs
List of directories each of which represents filesystems taken into account of disk resource management of SCore-D. This attirbute is an optional
Network record
Each network record must have one attribute, type. The value of the type attribute must be the same as the PM device name (e.g. type=myrinet). The order of network records is arbitrary. All other attributes vary from device to device. The name of this record might be specified scrun command.

PM device Attributes

myrinet -firmware:file -config:file
ethernet -config:file
shmem -node
agent -unit -agent -config:file

The attributes are as follows:
-firmware:file
Specify the Myrinet LANai firmware file (absolute path)

-agent
Specify the agent command name for PM/Agent (relative path from "deploy" directory)

-config:file
Specify the network routing information file (absolute path)

-node
Specify the node number to identify with the other devices

-unit
Specify the unit number of the network device.
On PM/Agent, this attribute is optional and only needed if there are nodes which have to run multiple agents.
For example, if your site has multiple IP networks which are not reachable from each other, and if there are nodes which have multiple IP network interfaces connected to both of the IP networks, you may specify multiple PM/Agent/UDP configurations for each interface by specifying different unit numbers as follows:
```
	udp-100base  type=agent -agent=pmaudp \
	  -unit=0 -config:file=(INSTALL_DIR)/etc/udp-100base.conf
	udp-1000base type=agent -agent=pmaudp \
	  -unit=1 -config:file=(INSTALL_DIR)/etc/udp-1000base.conf
	
```

FILES

(INSTALL_DIR)/etc/scorehosts.db
/var/tmp/score/*

SEE ALSO

scoreboard(8), msgbserv(8), scorehosts(1), msgb(1), scout(1), scrun(1), scored(8), PM API(3),

CREDIT
This document is a part of the SCore cluster system software developed at PC Cluster Consortium, Japan. Copyright (C) 2003 PC Cluster Consortium.

Program name	Attribute name
`msgbserv`	`group msgbserv`
`scout`	`group msgbserv [spare]`
`scored`	`network cpugen speed smp [watchfs]`

PM device	Attributes
`myrinet`	`-firmware:file -config:file`
`ethernet`	`-config:file`
`shmem`	`-node`
`agent`	`-unit -agent -config:file`