Startstop is a system-specific module; the configuration file described here is for the Linux version. On startup, startstop changes to the directory specified by the EW_PARAMS environment variable. Then it reads the configuration file named startstop_unix.d. This file sets up all parameters required to run an Earthworm system. In the configuration file, lines may begin with a valid startstop command (listed below) or with a # to denote a comment. Command names must be typed in the configuration file exactly as shown in this document (upper/lower case matters!).
#
# Startstop (Linux Version) Configuration File
#
# <nRing> is the number of transport rings to create.
# <Ring> specifies the name of a ring followed by it's size
# in kilobytes, eg Ring WAVE_RING 1024
# The maximum size of a ring is 1024 kilobytes.
# Ring names are listed in file earthworm.h.
#
nRing 3
Ring WAVE_RING 1024
Ring PICK_RING 1024
Ring HYPO_RING 1024
#
MyModuleId MOD_STARTSTOP # Module Id for this program
HeartbeatInt 50 # Heartbeat interval in seconds
MyClassName TS # For this program
MyPriority 0 # For this program
LogFile 1 # 1=write a log file to disk, 0=don't
KillDelay 5 # seconds to wait before killing modules on
# shutdown
#
# Class must be RT or TS
# RT priorities from 0 to 59
# TS priorities le 0
#
# If the command string required to start a process contains
# embedded blanks, it must be enclosed in double-quotes.
# Processes may be disabled by commenting them out.
# To comment out a line, preceed the line by #.
# The optional Agent command lists the user and group names under which
# the command will be run. Make sure they are valid names!
# You cannot use "root" as the Agent user. If an earthworm module
# needs to run as root, you should make that module's binary setuid root.
#
Process "pick_ew pick_ew.d"
Class/Priority TS 0
Agent "eworm" "net"
#
# Process "coaxtoring coaxtoring.d"
# Class/Priority RT 10
#
# Process "export_generic export_picks.d"
# Class/Priority TS 0
#
Process "binder_ew binder_ew.d"
Class/Priority TS 0
#
#
Process "eqproc eqproc.d"
Class/Priority TS 0
#
Process "diskmgr diskmgr.d"
Class/Priority TS 0
#
Process "pagerfeeder pagerfeeder.d"
Class/Priority TS 0
#
Process "statmgr statmgr.d"
Class/Priority TS 0
#
# Process "eqalarm_ew eqalarm_ew.d"
# Class/Priority TS 0
#
Process "copystatus WAVE_RING HYPO_RING"
Class/Priority RT 5
#
Process "copystatus PICK_RING HYPO_RING"
Class/Priority RT 5
#
Process "menlo_report menlo_report.d"
Class/Priority TS 0
#
Shared memory setup:
nRing required
Ring required (nRing)
Startstop-specific info:
MyModuleId required
HeartbeatInt required
MyClassName required
MyPriority required
LogFile required
KillDelay required
Earthworm modules to run:
Process required \ one pair
Class/Priority required | per module
Agent optional /
command arg1
nRing nRing
Specifies the number of shared memory regions (aka transport rings) that startstop will create for "public" use by the modules of this Earthworm system. nRing should be an integer from 1 to MAX_RING (currently defined in the solaris version of startstop.c to be 5).Example: nRing 3
Ring name size
Specifies the name and size, in kilobytes, of one transport ring. There must be exactly nRing "Ring" commands following the "nRing" command in the startstop_sol.d. name is a character string (up to 19 characters long, valid strings are listed in earthworm.d) that relates (in earthworm.d) to a unique number for the key to the shared memory region. size should be an integer between 1 and 1024 (the default maximum size under Linux). When deciding how large to make a memory region, realize that the transport layer uses a portion of the memory region for its own bookkeeping. The region size is NOT required to be an even multiple of the size of the messages it will contain. However, suppose you want the region to be exactly large enough to store NUM messages of size MSGSIZE. To include space for transport bookkeeping too, the region size (in bytes) should be:sizeof(SHM_HEAD) + NUM * ( sizeof(TPORT_HEAD) + MSGSIZE )
Example: Ring WAVE_RING 1024
MyModuleId mod_id
Sets the module id for labeling all outgoing messages. mod_id is a character string (up to 30 characters, valid strings listed in earthworm.d) that relates (in earthworm.d) to a unique single-byte number. Startstop places its outgoing messages on the shared memory ring specified by the first "Ring" command in startstop_sol.d.Example: MyModuleId MOD_STARTSTOP
HeartbeatInt nsec
Defines the number of seconds, nsec, between TYPE_HEARTBEAT messages issued by startstop. Startstop places its heartbeats on the shared memory ring specified by the first "Ring" command in startstop_sol.d.Example: HeartbeatInt 30
MyClassName class
Sets the process class for startstop. class is a character string that must be set to either "RT" (for Real-Time) or "TS" (for Time- Share) on solaris.Example: MyClassName RT
MyPriority priority
Sets the process priority for startstop. See the "Class/Priority" command below for allowed values. After startstop reads its configuration file, it changes its own class/priority to the values specified in the "MyClassName" and "MyPriority" commands.Example: MyPriority 4
LogFile switch
Sets the on-off switch for writing a log file to disk. If switch is 0, no log file will be written. If switch is 1, startstop will write a daily log file(s) called startstopxx.log_yymmdd where xx is startstop's module id (set with "MyModuleId" command) and yymmdd is the current UTC date (ex: 960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable).Example: LogFile 1
KillDelay nsec
Gives the number of seconds nsec that startstop will wait for modules to shutdown gracefully on termination. After this delay, startstop will force modules to shut down with the TERM signal.Example: KillDelay 10
Process cmdstring
Gives the command string, cmdstring, (up to 79 characters) that will be used to start one Earthworm module. Each "Process" command must be immediately followed by a "Class/Priority" command. If the cmdstring required to start a process contains embedded blanks, it must be enclosed in double-quotes. Startstop can create up to MAX_CHILD (currently defined as 20 in the Linux/UNIX version of startstop.c) child processes.Example: Process "binder_ew binder_ew.d"
Class/Priority class priority
Specifies the class and priority under which the module given by the previous "Process" command will be run. class is a 2-character string and priority is an integer; their values are restricted to:class priorityClass RT processes run at higher priority than class TS processes. Take care not to assign known CPU hogs (binder_ew, for example) to the RT class. Such an assignment could bog down all class TS processes, causing poor Earthworm system performance. After a "Class/Priority" line, startstop expects to find the "Process" command of the next Earthworm module it should spawn.
Real-Time "RT" 0 to 59
Time-Share "TS" <= 0Example: Class/Priority TS 0
Agent user group
Optional command to specify the user and group names under which this module will run. Normally this feature will not be used. But if you need to have the output and log files from this module owned by a user other than the one who runs startstop, then you can use Agent to do this. You cannot specify root as the user agent. If you need to have a module run with root privelege, you should set that module's file permissions to make it setuid root. Make sure that user is a valid user name and group is a valid group name for your system.Example: Agent "eworm" "net"