PM/Ethernet Configuration File

PM-II ETHERNET CONF(5)

FILE FORMATS

PM-II ETHERNET CONF(5)

NAME

PM/Ethernet Configuration File Format

DESCRIPTION

Each line of the PM/Ethernet configuration file specifies mapping from node number to hostname and IP address.
A single '#' character indicates that the rest of the line is a comment, and to be ignored.

Notation of a node
```
NodeNumber     MAC address   Hostname
```
NodeNumber
Node number of PM/Ethernet. An integer starting from zero.
This number doesn't have to be the same as the node number of this host on another PM network interface.
MAC address
MAC address of the host. An example of the syntax is 00:60:08:F5:C5:5B.
Hostname
Host name of the host. This name should be exactly the same as the name which the hostname command returns. PM/Ethernet itself doesn't depend on this constraint, thus, the pmtest command doesn't detect a problem about this, but upper-level software depends on this.
Example:
0 00:00:12:23:34:45 xxx.yyy.xxx
Notation of interface unit number
```
unit     unit_number
```
Specify unit number of this configuration.
Example:
unit 0

Notation of checksum option

checksum     0(off) or 1(on)

Enable data checksum. If you application fails or results of caliculateion is wrong. Set this value 1, and re-run your application. If data checksum error occur, the error is showed by /proc/pm/ethernet/[ethernet-unit-num]/info. In some sitiation, we found a checksum error on NIC DMA(sending or receiving).

comp0.score.rwcp.or.jp.% cat /proc/pm/ethernet/3/info PM Ethernet 0310 Version : "$Id: pm-ether-conf.html,v 1.9 2000/09/13 18:12:12 soda Exp $" device : eth3 irq : 5 MTU : 1468 Bytes maxnodes : 128 Intreap : on Checksum : on dev error : 8504 header err : 0 header cksum err: 50 data cksum err : 5 underrun err : 0

Example:

checksum 	1

Notation of maxnsend option
```
maxnsend      8 - 32    
```
Define number of sending packets at a time. When you use network trunking, you should increase this parameter from default value.
Example:
maxnsend 16
Notation of backoff option
```
backoff     1000 - 20000(usec)    
```
Define a re-transmitting time. This value is very important on large node cluster or an application which uses all to all communication.
Example:
backoff 4800

EXAMPLE

This is an example of a PM/Ethernet configuration file. In this example, four hosts: comp0, comp1, comp2 and comp3 are connected.

#
# Sample configuration file
#
unit	 0
checksum 1
#
# Node specification
#  NodeNumber  	MAC address		Hostname                
0  		00:00:f3:51:03:00      	comp0.score.rwcp.or.jp
1              	00:00:f3:51:03:01	comp1.score.rwcp.or.jp
2               00:00:f3:51:03:02	comp2.score.rwcp.or.jp  
3               00:00:f3:51:03:03	comp3.score.rwcp.or.jp

NOTES

This configuration file can be created with mkpmethernetconf(8) using PM/Agent/UDP configuration files.

SEE ALSO

mkpmethernetconf(8)

Parallel and Distributed System Software Laboratory
Real World Computing Partnership

score-info@rwcp.or.jp

CREDIT: This document is a part of the SCore cluster system software developed at Real World Computing Partnership, Japan. Copyright (c) 2000, 1999 Real World Computing Partnership.