Changeset 8412883

Timestamp:

Oct 5, 2007 10:28:55 AM (17 years ago)

Author:

Ted Faber <faber@…>

Branches:

axis_example, compt_changes, info-ops, master, version-1.30, version-2.00, version-3.01, version-3.02

Children:

0404558

Parents:

33548e1

Message:

Documentation of variable expansion in startcmds and some touch ups.

File:

• fedkit/splitter.pl (modified) (6 diffs)

fedkit/splitter.pl

@@ -890 +890 @@
 Value in seconds after which a swap-in operatioin will be considered a success.
 Often long swap-ins will hang when there are partial failures.  This works
-around this issue.
+around this issue.  (This behavior can be requested on the command line by
+specifying B<-t> I<secs>.)
 
 =item FailSoft
 
-If not set, failure of any sub experiment swaps the rest out.  Setting this to any value avoids this swap out.  (Also B<-F>.)
+If not set, failure of any sub experiment swaps the rest out.  Setting this to
+any value avoids this swap out.  (This behavior can be requested on the command
+line by specifying B<-F>.)
 
 =back
@@ -936 +939 @@
 
 The start command to run on experimental nodes when this testbed is used as a
-slave.  In all the start commands the string FEDDIR will be replaced by the
-local experiment's federation scripts directory and the string GWCONF replaced
-by the gatway configuration file.
+slave.  In all the start commands the following string substitutions are made:
+
+=over 10
+
+=item FEDDIR
+
+The local experiment's federation scripts directory.  Each local experiment
+will have this replaced by the scripts directory on its local boss.
+
+=item GWCONF 
+
+The full pathname of the gateway configuration file.  As with FEDDIR, this is
+on the local boss.
+
+=item PROJDIR
+
+The project directory on the local boss.
+
+=item EID
+
+The local experiment name.
+
+=back
+
+All startcmds specified in F<testbeds> undergo these expansions.
 
 =item SlaveConnectorStartCmd
 
 The start command to run on gateway nodes when this testbed is used as a slave.
-The same string substitutions are made in this command as in experiment start.
+The same string substitutions are made in this command as in SlaveNodeStartCmd.
 
 =item MasterNodeStartCmd
@@ -949 +974 @@
 The start command to run on experimental nodes when this testbed is used as a
 master.  The same string substitutions are made in this command as in
-experiment start.
+SlaveNodeStartCmd.
 
 =item MasterConnectorStartCmd
@@ -955 +980 @@
 The start command to run on gateway nodes when this testbed is used as a
 master.  The same string substitutions are made in this command as in
-experiment start.
+SlaveNodeStartCmd.
 
 =item ConnectorImage
@@ -976 +1001 @@
 
 =back
-
 
 =head1 ENVIRONMENT
@@ -984 +1008 @@
 environment.
 
+=head1 BUGS
+
+A deprecated B<-N> flag was used to select testbeds file format.  Only one
+format is supported now, and B<-N> generates a warning, but otherwise does not
+affect B<splitter.pl>.
+
 =head1 SEE ALSO