1just-man-pages/condor_vacate_Gjeonbe(r1a)l CommandsjuMsatn-umaaln-pages/condor_vacate_job(1)
2
3
4

Name

6       condor_vacate_job  vacate jobs in the Condor queue from the hosts where
7       they are running
8

Synopsis

10       condor_vacate_job [ -help -version ]
11
12       condor_vacate_job  [  -pool  centralmanagerhostname[:portnumber]  -name
13       scheddname  ][  -addr  <a.b.c.d:port>  ]  [  -fast  ]  cluster... clus‐
14       ter.process... user...  -constraint expression ...
15
16       condor_vacate_job  [  -pool  centralmanagerhostname[:portnumber]  -name
17       scheddname ][ -addr <a.b.c.d:port> ] [ -fast ] -all
18

Description

20       condor_vacate_job  finds one or more jobs from the Condor job queue and
21       vacates them from the host(s) where they  are  currently  running.  The
22       jobs remain in the job queue and return to the idle state.
23
24       A  job  running under the standard universe will first produce a check‐
25       point and then the job will be killed. Condor will then restart the job
26       somewhere  else,  using  the  checkpoint to continue from where it left
27       off. A job running under any other universe will be sent  a  soft  kill
28       signal (SIGTERM by default, or whatever is defined as the SoftKillSigin
29       the job ClassAd), and Condor will restart the job  from  the  beginning
30       somewhere else.
31
32       If  the  -fast  option  is used, the job(s) will be immediately killed,
33       meaning that standard universe jobs will not be allowed to  checkpoint,
34       and  the  job  will have to revert to the last checkpoint or start over
35       from the beginning.
36
37       If the -name option is specified, the named condor_schedd  is  targeted
38       for  processing.  If the -addr option is used, the condor_schedd at the
39       given address is targeted for processing.  Otherwise,  the  local  con‐
40       dor_schedd is targeted. The jobs to be vacated are identified by one or
41       more job identifiers, as described below. For any given job,  only  the
42       owner  of  the  job  or  one  of  the queue super users (defined by the
43       QUEUE_SUPER_USERSmacro) can vacate the job.
44
45       Using condor_vacate_job on jobs which are not currently running has  no
46       effect.
47

Options

49       -help
50
51          Display usage information
52
53
54
55       -version
56
57          Display version information
58
59
60
61       -pool centralmanagerhostname[:portnumber]
62
63          Specify  a  pool  by  giving  the central manager's host name and an
64          optional port number
65
66
67
68       -name scheddname
69
70          Send the command to a machine identified by scheddname
71
72
73
74       -addr <a.b.c.d:port>
75
76          Send the command to a machine located at <a.b.c.d:port>
77
78
79
80       cluster
81
82          Vacate all jobs in the specified cluster
83
84
85
86       cluster.process
87
88          Vacate the specific job in the cluster
89
90
91
92       user
93
94          Vacate jobs belonging to specified user
95
96
97
98       -constraint expression
99
100          Vacate all jobs which match the job ClassAd expression constraint
101
102
103
104       -all
105
106          Vacate all the jobs in the queue
107
108
109
110       -fast
111
112          Perform a fast vacate and hard kill the jobs
113
114
115

General Remarks

117       Do not confuse condor_vacate_job with condor_vacate .  condor_vacate is
118       given  a  list of hosts to vacate, regardless of what jobs happen to be
119       running on them. Only machine owners and administrators have permission
120       to   use   condor_vacate  to  evict  jobs  from  a  given  host.   con‐
121       dor_vacate_job is given a list of job to vacate,  regardless  of  which
122       hosts they happen to be running on. Only the owner of the jobs or queue
123       super users have permission to use condor_vacate_job .
124

Examples

126       To vacate job 23.0:
127
128       % condor_vacate_job 23.0
129
130       To vacate all jobs of a user named Mary:
131
132       % condor_vacate_job mary
133
134       To vacate all standard universe jobs owned by Mary:
135
136       % condor_vacate_job -constraint 'JobUniverse == 1 && Owner == "mary"'
137
138       Note that the entire constraint, including the quotation marks, must be
139       enclosed in single quote marks for most shells.
140

Exit Status

142       condor_vacate_job  will  exit with a status value of 0 (zero) upon suc‐
143       cess, and it will exit with the value 1 (one) upon failure.
144

Author

146       Condor Team, University of Wisconsin-Madison
147

149       Copyright (C) 1990-2009 Condor Team, Computer Sciences Department, Uni‐
150       versity   of  Wisconsin-Madison,  Madison,  WI.  All  Rights  Reserved.
151       Licensed under the Apache License, Version 2.0.
152
153       See  the  Condor  Version   7.4.2   Manual   or   http://www.condorpro‐
154       ject.org/licensefor additional notices. condor-admin@cs.wisc.edu
155
156
157
158                                     date  just-man-pages/condor_vacate_job(1)
Impressum