arcsub

Langue: en

Version: 2010-05-15 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

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).

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)