Difference between revisions of "jobserver.pl"

Latest revision as of 12:46, 30 July 2009

Usage

usage:    jobserver.pl [options] tag
options:  [-dir workdir]
          [-runs [from:]to]
          [-use proptag]
          [-log logfile]

Show source

Description

This script is used to start a job server manually for running ensemble-based jobs in a parallel distributed computing environment. The utilities ensmin.pl, enslatsim.pl, ensrun.pl may then be used as clients by giving the server host, port and ID through their -rserv option.

Starting the job server manually is most useful when remote execution via rsh/ssh is not possible in a distributed environment. Otherwise the -hosts option for the ensemble utilities is a more convenient way since it will start the server automatically and submit clients via rsh/ssh.

This utility requires the tag name of the ensemble structures as argument. Additional options are available to select the ensemble directory (-dir), the desired runs for which a job list should be created (-runs), the property that is used for identifying which jobs need to be run (-use, by default: etot), and to request a log file with -log.

The script writes to standard output the host name, port, and server ID in the format expected by the client -rserv option. Since the script waits for the server to exit after spawning a new process for the server it is recommended to start the script in the background with &.

Options

-help: usage information
-dir directory: data directory
-runs [from:]to: limit to subset of ensemble
-use name: provide property tag to be used to determine which part of the ensemble is incomplete
-log file: output log file

Examples

jobserver.pl -dir data -runs 50 vacmin &
starts an ensemble job server for the vacmin structures in the ensemble stored under the data directory. The joblist is generated for missing structures up to run index 50.

cassatt:4001:211938 started

@@ Line 8: / Line 8: @@
 This script is used to start a job server manually for running
 ensemble-based jobs in a parallel distributed computing environment.
-The utilities <docmark>ensmin.pl</docmark>, <docmark>enslatsim.pl</docmark>,
+The utilities [[ensmin.pl]], [[enslatsim.pl]],
-<docmark>ensrun.pl</docmark> may then be used as clients by giving the
+[[ensrun.pl]] may then be used as clients by giving the
 server host, port and ID through their <B>-rserv</B> option.<BR>
 Starting the job server manually is most useful when remote
-execution via <font color=#508060>rsh</font> is not possible in a distributed
+execution via <font color=#508060>rsh/ssh</font> is not possible in a distributed environment. Otherwise the <B>-hosts</B> option for the ensemble
-environment. Otherwise the <B>-hosts</B> option for the ensemble
 utilities is a more convenient way since it will start the server
-automatically and submit clients via <font color=#508060>rsh</font>.<BR>
+automatically and submit clients via <font color=#508060>rsh/ssh</font>.<BR>
 This utility requires the tag name of the ensemble structures as argument.
 Additional options are available to select the ensemble directory (<B>-dir</B>),
@@ Line 21: / Line 22: @@
 the property that is used for identifying which jobs need to be run (<B>-use</B>,
 by default: <font color=#508060>etot</font>), and to request a log file with <B>-log</B>.<BR>
 The script writes to standard output the host name, port, and server ID in the
 format expected by the client <B>-rserv</B> option. Since the script waits for the
 server to exit after spawning a new process for the server it is recommended
 to start the script in the background with <font color=#508060>&</font>.
 == Options ==
 ; -help : usage information
+; -dir directory : data directory
+; -runs [from&#58;]to : limit to subset of ensemble
+; -use name : provide property tag to be used to determine which part of the ensemble is incomplete
+; -log file : output log file
 == Examples ==
 <mmtsbToolExample cmd="jobserver.pl" set="/apps/mmtsb/bench/jobserver.pl-test/test1"></mmtsbToolExample>