NAME
arcsub - ARC Submission
DESCRIPTION
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
Flavor:protocol://hostname[:port]/path
Examples:
arcsub -c ARC0:ldap://grid.nbi.dk:2135/nordugrid-cluster-
name=grid.nbi.dk,Mds-Vo-name=local,o=grid -c
ARC0:ldap://grid.tsl.uu.se:2135/nordugrid-cluster-
name=grid.tsl.uu.se,Mds-Vo-name=local,o=grid ...
submit the job to either grid.nbi.dk or grid.tsl.uu.se
arcsub -c -ARC0:ldap://quark.hep.lu.se:2135/nordugrid-cluster-
name=quark.hep.lu.se,Mds-Vo-name=local,o=grid -c
-ARC0:ldap://grid.nbi.dk:2135/nordugrid-cluster-name=grid.nbi.dk,Mds-
Vo-name=local,o=grid ...
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
Flavor:protocol://hostname[:port]/path
Example:
arcsub -i ARC0:ldap://index1.nordugrid.org:2135/Mds-Vo-
name=NorduGrid,o=grid ...
use the NorduGrid index at index1.nordugrid.org
arcsub -i -ARC0:ldap://grid.tsl.uu.se:2135/Mds-Vo-name=Sweden,o=grid
...
do not use the Sweden index at grid.tsl.uu.se
FILES
~/.arc/client.conf
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).
COPYRIGHT
APACHE LICENSE Version 2.0
AUTHOR
Mattias Ellert <mattias.ellert@fysast.uu.se>
SEE ALSO
arccat(1), arcclean(1), arcget(1), arckill(1), arcstat(1), arccp(1),
arcls(1), arcrm(1)