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.pccluster.org.% 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.pccluster.org 1 00:00:f3:51:03:01 comp1.pccluster.org 2 00:00:f3:51:03:02 comp2.pccluster.org 3 00:00:f3:51:03:03 comp3.pccluster.org

NOTES

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

SEE ALSO

mkpmethernetconf(8)

PC Cluster Consotium

$Id: pm-ether-conf.html,v 1.3 2002/03/07 12:03:41 kameyama Exp $