SCore System Installation on Server
other than Red Hat and SuSE

1. scoreboard database
   The database format is described in scorehosts.db(5). The database must be the /opt/score/etc/scorehosts.db file. A sample file, scorehosts-db.sample, is located in the doc/html/installation/ directory. In the following example, we assume four dual Pentium III computers are connected by Myrinet, Gigabit Ethernet, and 100 Mbps Ethernet.

   /* PM/Myrinet */
   myrinet	type=myrinet \
   		-firmware:file=/opt/score/share/lanai/lanai.mcp \
   		-config:file=/opt/score/etc/pm-myrinet.conf
   /* PM/Ethernet */
   ethernet	type=ethernet \
   		-config:file=/opt/score/etc/pm-ethernet.conf
   /* PM/Agent/UDP */
   udp		type=agent -agent=pmaudp \
   		-config:file=/opt/score/etc/pm-udp.conf
   /* PM/SHMEM */
   shmem0		type=shmem -node=0
   shmem1		type=shmem -node=1
   
   /* Macro to define a host */
   #define PCC		msgbserv=(server.pccluster.org:8764) \
   			cpugen=pentium-iii speed=500 smp=2 \
   			network=myrinet,ethernet,udp,shmem0,shmem1 \
   			group=pcc
   
   comp0.pccluster.org	PCC
   comp1.pccluster.org	PCC
   comp2.pccluster.org	PCC
   comp3.pccluster.org	PCC
   

   If your Myrinet network is Myrinet 2000 with serial or fiber link interface (M3S-PCI64B and M3F-PCI64B), please use myrinet2k network type and lanaiM2k.mcp firmware. myrinet record should be:

   /* PM/Myrinet (for Myrinet 2000 Serial M3S-PCI64B, or Fiber M3F-PCI64B) */
   myrinet	type=myrinet2k \
   		-firmware:file=/opt/score/share/lanai/lanaiM2k.mcp \
   		-config:file=/opt/score/etc/pm-myrinet.conf
   

   If you don't have some of the above network interfaces, they must be deleted from this file. For example, if you don't have a Myrinet network, then the PCC macro should be:

   #define PCC		msgbserv=(server.pccluster.org:8764) \
   			cpugen=pentium-iii speed=500 smp=2 \
   			network=ethernet,udp,shmem0,shmem1 \
   			group=pcc
   

   If you only have single-processor Pentium III computers then smp=1 must be defined in the host macro. Without this entry SCore-D will issue a warning message saying it is unable to get the SMP field. The above PCC macro should, in this case, be replaced with:

   #define PCC             msgbserv=(server.pccluster.org:8764) \
                           cpugen=pentium-iii speed=500 smp=1 \
                           network=ethernet,udp \
                           group=pcc
   

   Be sure that all hostnames in this database, the compute hosts and msgbserv host, have exactly the same name as that produced by the hostname(1) command. port number of msgbserv must be even number.

2. PM-II Device Configuration
   1. Myrinet
      To set up the PM/Myrinet configuration file, see the PM-II MYRINET CONF(5) man page. For example, the following entries should be stored in /opt/score/etc/pm-myrinet.conf, whose file name was specified in /opt/score/etc/scorehosts.db

      # Host Number   Host Name               Switch Number . Port Number
      0           comp0.pccluster.org                   0.0
      1           comp1.pccluster.org                   0.1
      2           comp2.pccluster.org                   0.2
      3           comp3.pccluster.org                   0.3
      

   2. Agent/UDP
      To set up the PM/Agent/UDP configuration file, see the PM-II Agent/UDP CONF(5) man page. For example, the following entries should be stored in /opt/score/etc/pm-udp.conf whose file name was specified in /opt/score/etc/scorehosts.db:

      # Host Number   Host Name               [IP Address]
      0           comp0.pccluster.org
      1           comp1.pccluster.org
      2           comp2.pccluster.org
      3           comp3.pccluster.org
      

   3. Ethernet
      The PM/Ethernet configuration file format is described in the PM-II ETHERNET CONF(5) man page. To set up the PM/Ethernet configuration file, it is better to use the mkpmethernetconf(8) command which converts the PM/Agent/UDP configuration file to the PM/Ethernet configuration file.

      Examples are shown below. Be sure that all hosts listed in the PM/Agent/UDP configuration file are accessible by the rsh command. This means that the /root/.rhosts file should contain all hostnames.

      1. Using Gigabit Ethernet

         	# cd /opt/score/etc
         	# /opt/score/deploy/mkpmethernetconf \
         	    -speed 1000 pm-udp.conf > pm-ethernet.conf
         

      2. Using Fast Ethernet (100Mbps Ethernet)

         	# cd /opt/score/etc
         	# /opt/score/deploy/mkpmethernetconf \
         	    -speed 100 pm-udp.conf > pm-ethernet.conf
         

      3. Using 10Mbps Ethernet

         	# cd /opt/score/etc
         	# /opt/score/deploy/mkpmethernetconf \
         	    -speed 10 pm-udp.conf > pm-ethernet.conf
         

3. Create files under the /etc/profile.d directory
   The SCBDSERV environment variable and execution path must be set for shells. The following examples are bash, sh, csh, and tcsh.
   1. /etc/profile.d/score.sh

              PATH=/opt/score/bin:/opt/score/sbin:/opt/score/deploy:$PATH
              export PATH PWD
              SCBDSERV=server.pccluster.org
              export SCBDSERV
      

   2. /etc/profile.d/score.csh

              set path = (/opt/score/bin /opt/score/sbin /opt/score/deploy $path)
              setenv SCBDSERV server.pccluster.org
      

4. Create /etc/score.conf file
   The /etc/score.conf format is described in score.conf.

   SCBDSERV=server.pccluster.org
   SCOUTGROUP=pcc
   SCOOPHROUP=pcc
   

5. Daemon Settings
   The following three daemons must run on a server. You will find an example of init.d files under the /opt/score/src/rc/linux directory.
   1. scoreboard
   2. msgbserv
   3. Scoopd

6. PBS/SCore
   See PBS/SCore Administrator's Guide if you want to use PBS/SCore.

PC Cluster Consotium

CREDIT

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