1ARCRESUB(1)                 NorduGrid Users Manual                 ARCRESUB(1)
2
3
4

NAME

6       arcresub - ARC Resubmission
7
8

DESCRIPTION

10       The arcresub command is used for resubmitting jobs to grid enabled com‐
11       puting resources.
12
13

SYNOPSIS

15       arcresub [options] [jobid ...]
16
17

OPTIONS

19       -a, --all
20              all jobs
21
22       -j, --joblist=filename
23              the  file  storing  information  about  active   jobs   (default
24              ~/.arc/jobs.xml)
25
26       -i, --jobids-from-file=filename
27              a file containing a list of jobIDs
28
29       -o, --jobids-to-file=filename
30              the IDs of the submitted jobs will be appended to this file
31
32       -c, --cluster=[-]name
33              explicitly select or reject jobs from a specific cluster
34
35       -q, --qluster=[-]name
36              explicitly select or reject a specific cluster for the new job
37
38       -g, --index=[-]name
39              explicitly select or reject jobs from an index server
40
41       -k, --keep
42              keep the files on the server (do not clean)
43
44       -m, --same
45              resubmit on the same cluster
46
47       -s, --status=statusstr
48              only select jobs whose status is statusstr
49
50       -P, --listplugins
51              list the available plugins
52
53       -t, --timeout=seconds
54              timeout in seconds (default 20)
55
56       -z, --conffile=filename
57              configuration file (default ~/.arc/client.conf)
58
59       -d, --debug=debuglevel
60              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
61
62       -b, --broker=broker
63              selected broker: Random (default), FastestQueue or custom
64
65       -v, --version
66              print version information
67
68       -?, --help
69              print help
70

ARGUMENTS

72       jobid ...
73              jobid or job name of jobs to be resubmitted
74

EXTENDED DESCRIPTION

76       The arcresub command is used for resubmitting jobs on grid enabled com‐
77       puting resources to the same (not default, see below) or new resources.
78       The  job  can  be  referred to either by the jobid that was returned by
79       arcsub(1) at submission time or by its jobname if the  job  description
80       that was submitted contained a jobname attribute.
81
82       More  than  one jobid and/or jobname can be given. If several jobs were
83       submitted with the same jobname all those jobs will be resubmitted.
84
85       Upon resubmission of a job the corresponding job  description  will  be
86       fetched  from  the  local joblist file along with the checksum of local
87       input files. If the checksums does not match the current ones  the  job
88       no longer remains the same job an will therefore not be resubmitted.
89
90       In  case  the  job  description is not found in the joblist, it will be
91       retrieved from the cluster holding the job.  This  description  however
92       might differ from the one originally used to submit the job, since both
93       the submission client and the cluster can have  made  modifications  to
94       the job description.
95
96       Upon  resubmision the job will receive a new jobid. Hence the old jobid
97       will also be stored in the local  joblist  file  enabling  future  back
98       tracing of the resubmitted job.
99
100       The  name of the local joblist file can used specified by the --joblist
101       option. By specifying the --all option, all active jobs  appearing  the
102       in joblist file will be resubmitted.
103
104       The  --cluster  option can be used to select or reject jobs at specific
105       clusters to be resubmitted. See arcsub(1) for a discussion of the  for‐
106       mat  of  arguments to this option.  The --qluster option can be used to
107       force the jobs to be resubmitted to a particular cluster, or to  reject
108       resubmission  to  a particular cluster. Againg see arcsub(1) for a dis‐
109       cussion of the format of arguments to this option.  The --status option
110       can  be  used  to select jobs in a specific state. These options can be
111       repeated several times.  Which servers to query  can  be  specified  by
112       giving  the  --index option to the command. See arcsub(1) for a discus‐
113       sion of the format of arguments to this option.
114
115       The default behaviour of arcresub is to  disregard  the  cluster  which
116       job(s)  resides on. If the desired behaviour is to resubmit to the same
117       cluster it can be obtained by specifying the --same option  which  will
118       force  jobs to be resubmitted to the same cluster as where they initial
119       run.  If the old job was successfully killed the job  will  be  removed
120       from the remote cluster unless the --keep option was specified.
121
122

FILES

124       ~/.arc/client.conf
125              Some  options  can be given default values by specifying them in
126              the ARC client  configuration  file.  By  using  the  --conffile
127              option  a  different  configuration  file  can  be used than the
128              default.
129
130
131       ~/.arc/jobs.xml
132              This a local list of the user's active jobs. When a job is  suc‐
133              cessfully  submitted  it  is  added  to this list and when it is
134              removed from the remote cluster it is removed  from  this  list.
135              This  list  is used as the list of all active jobs when the user
136              specifies the
137
138

ENVIRONMENT VARIABLES

140       X509_USER_PROXY
141              The location of the user's grid proxy  file.  Shouldn't  be  set
142              unless the proxy is in a non-standard location.
143
144
145       ARC_LOCATION
146              The  location  where  ARC  is installed can be specified by this
147              variable. If not specified the install location will  be  deter‐
148              mined  from  the path to the command being executed, and if this
149              fails a WARNING will be given stating the location which will be
150              used.
151
152
153       ARC_PLUGIN_PATH
154              The  location  of ARC plugins can be specified by this variable.
155              Multiple locations can be specified by separating them by  :  (;
156              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
157              Windows).
158
159
161       APACHE LICENSE Version 2.0
162
163

AUTHOR

165       Mattias Ellert <mattias.ellert@fysast.uu.se>
166
167

SEE ALSO

169       arccat(1), arcclean(1), arccp(1),  arcget(1),  arcinfo(1),  arckill(1),
170       arcls(1),   arcmigrate(1),   arcproxy(1),   arcrenew(1),  arcresume(1),
171       arcrm(1), arcstat(1), arcsub(1), arcsync(1), arctest(1)
172
173
174
175
176NorduGrid ARC 1.1.0               2011-10-24                       ARCRESUB(1)
Impressum