The
arcsub
command is used for submitting jobs to grid enabled computing resources.
SYNOPSIS
arcsub [options] [filename ...]
OPTIONS
-c, --cluster=[-]name
explicitly select or reject a specific cluster
-i, --index=[-]name
explicitly select or reject an index server
-e, --jobdescrstring=string
jobdescription string describing the job to be submitted
-f, --jobdescrfile=filename
jobdescription file describing the job to be submitted
-j, --joblist=filename
file where the jobs will be stored
-x, --dumpdescription
do not submit - dump job description in the language accepted by the target
-t, --timeout=seconds
timeout in seconds (default 20)
-z, --conffile=filename
configuration file (default ~/.arc/client.conf)
-d, --debug=debuglevel
FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
-b, --broker
selected broker (default Random)
-v, --version
print version information
-?, --help
print help
ARGUMENTS
filename ...
job description files describing the jobs to be submitted
EXTENDED DESCRIPTION
The
arcsub
command is used for submitting jobs to grid enabled computing
resources.
The
--cluster
option can be used to force the job to be submitted to a particular
cluster, or to reject submission to a particular cluster. The
--cluster
option can be repeated several times. The name of the cluster should
be given in the format
don't submit the job to quark.hep.lu.se or grid.nbi.dk
The job description that describes the job can be given either on the
command line using the --jobdescrstring option or be read from a
file using the --jobdescrfile option. Several jobs can be
requested at the same time by giving more than one
--jobdescrstring or --jobdescrfile option. It is also
possible to mix --jobdescrstring and --jobdescrfile options
in the same arcsub command.
If the job is successfully submitted a jobid is printed to
stdout. This jobid uniquely identifies the job while it is being
executed.
Before submitting a job description to a target, it might get modified
by arcsub to fit the chosen target. The modified job description
can be printed to stdout by specifying the --dumpdescription
option. The format of the printed job description cannot be specified,
and will be that accepted by the chosen target.
Information about active jobs are stored in a local joblist file. By
using the
--joblist
option a customized location for this file can be defined. If this
option is used when submitting a job using
arcsub,
the same joblist
file must be specified using the
--joblist
option for all subsequent handling of the job using
arcstat(1),
arcget(1),
etc.
The
arcsub
command locates the available clusters by querying information index
servers. Which servers to query can be specified by giving the
--index
option to the command. The name of the index server should be given in
the format
Some options can be given default values by specifying them in the
ARC client configuration file. By using the
--conffile
option a different configuration file can be used than the default.
~/.arc/jobs.xml
This a local list of the user's active jobs. When a job is
successfully submitted it is added to this list and when it is removed
from the remote cluster it is removed from this list. This list is
used as the list of all active jobs when the user specifies the
--all
option to the various NorduGrid ARC user interface commands. By using the
--joblist
option a different file can be used than the default.
ENVIRONMENT VARIABLES
X509_USER_PROXY
The location of the user's grid proxy file. Shouldn't be set unless
the proxy is in a non-standard location.
ARC_LOCATION
The location where ARC is installed can be specified by this variable. If not
specified the install location will be determined from the path to the
command being executed, and if this fails a WARNING will be given stating the
location which will be used.
ARC_PLUGIN_PATH
The location of ARC plugins can be specified by this variable. Multiple
locations can be specified by separating them by : (; in Windows). The
default location is $ARC_LOCATION/lib/arc (\ in Windows).