Linux Certif

Toute la documentation sur la certification Linux LPI

arcsub

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)