MMTSB
Tool Set Documentation

Difference between revisions of "Jobserver.pl"

From MMTSB
Jump to: navigation, search
 
 
Line 8: Line 8:
 
This script is used to start a job server manually for running
 
This script is used to start a job server manually for running
 
ensemble-based jobs in a parallel distributed computing environment.
 
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>
 
server host, port and ID through their <B>-rserv</B> option.<BR>
 +
 
Starting the job server manually is most useful when remote
 
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
 
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.
 
This utility requires the tag name of the ensemble structures as argument.
 
Additional options are available to select the ensemble directory (<B>-dir</B>),
 
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>,
 
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>
 
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
 
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
 
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
 
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>.
 
to start the script in the background with <font color=#508060>&</font>.
 +
 
== Options ==
 
== Options ==
  
 
; -help : usage information
 
; -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 ==
 
== Examples ==
  
 
<mmtsbToolExample cmd="jobserver.pl" set="/apps/mmtsb/bench/jobserver.pl-test/test1"></mmtsbToolExample>
 
<mmtsbToolExample cmd="jobserver.pl" set="/apps/mmtsb/bench/jobserver.pl-test/test1"></mmtsbToolExample>

Latest revision as of 22:52, 13 September 2010

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