TWiki> RmiGrid Web>WmsxSoftware>WmsxReference (revision 1)EditAttach


Basic usage

There are two program you will be using: Provider and Requestor.


is the background process which does the actual work. There can be only one provider runnung on a machine per user. Start with

./wmsx-provider -v /tmp/myworkdir


Specified you want debug output on the console. Leave this out once you feel comfortable.
Location of the work directory. This is where all your output goes. You may want to set this to a location inside your home directory.


is an application to submit commands to the system for execution. Start with:

./wmsx-requestor -option

A complete list of options is available with -h. Some options are:

Check if the provider is running
kill provider
Will ask for your AFS password and renew AFS tokens until you use
to forget the password
Will ask for yout Grid password and renew the Grid tokens until there are no more managed jobs
set the maximum number of concurrently running jobs
set the VO for all future job submissions

JDL Files

Can be sumbitted and managed through the framework. A sample usage is:

./wmsx-requestor -j example.jdl -o /tmp/StdOut -r /tmp/resultDir

Where the options are:

name of the JDL file
If the JDL file has "JobType" set to "Interactive", then StdOut / StdError will be retrieved while the Job is running and stored in the given filename
When the job is done, results are retrieved and stored in the given directory.

ArgList Files

Can specify multiple jobs to create one "larger" jpb.

ArgList Format:

COMMAND parameters

./wmsx-requestor options:


name of this execution. Is used as directory to distinguish different runs with the same commands.

Custom JDL files.

for Each command, there may be a file command.jdl, with custom JDL contents. sup ported are:

name of the archive, defaults to COMMAND.tar.gz (must be tar-gz format!)
name of the program dir inside the tar file, defaults to COMMAND
name of the executable to run inside the program dir, defaults to COMMAND
Which directory to retrieve, defaults to "out"
If set to "Interactive", the jobs will be run as interactive
List of software that must be present (executable) on the target machine. The special key "AFS" checks for AFS presence
Extra requirements, as specified by the original JDL spec.


must be calles COMMAND_preexec and COMMAND_postexec. MUST be executable. Will be run directly before submission and after job output is retrieved.

Preexec is called with the name of the command and its full directory as first argument, and with all the given args as following arguments.

Postexec is called with the name of the command and its full directory as first argument, , the name of the output directory as second argument, and with all the given args as following arguments.

The output of your job will always be in a file "out.tar.gz" in the output directory.

If postexec return with 0 nothing further happens. If postexec returns with 1, COMMAND_chain is called.


The _chain command's output is interpreted just as a line from the args file. It can therefore be used to start further jobs.

Edit | Attach | Watch | Print version | History: r15 | r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r1 - 2007-09-05 - MaxBerger
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright &© by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback