1condor_vacate_job(1)        General Commands Manual       condor_vacate_job(1)
2
3
4

Name

6       condor_vacate_jobvacate jobs in the HTCondor 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_jobfinds one or more jobs from the HTCondor 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. HTCondor will then  restart  the
26       job 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 HTCondor will restart the job from the  beginning
30       somewhere else.
31
32       If  the  -fastoption  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 -nameoption is specified, the named condor_scheddis targeted for
38       processing.  If  the -addroption is used, the condor_scheddat the given
39       address is targeted for processing. Otherwise, the local  condor_sched‐
40       dis  targeted. The jobs to be vacated are identified by one or more job
41       identifiers, as described below. For any given job, only the  owner  of
42       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_jobon 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_jobwith  condor_vacate.  condor_vacateis
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_vacateto   evict   jobs   from  a  given  host.  con‐
121       dor_vacate_jobis 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       Note that the entire constraint, including the quotation marks, must be
138       enclosed in single quote marks for most shells.
139

Exit Status

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

Author

145       Center   for   High   Throughput   Computing,   University  of  Wiscon‐
146       sin&ndash;Madison
147

149       Copyright © 1990-2019 Center for High  Throughput  Computing,  Computer
150       Sciences  Department, University of Wisconsin-Madison, Madison, WI. All
151       Rights Reserved. Licensed under the Apache License, Version 2.0.
152
153
154
155                                     date                 condor_vacate_job(1)
Impressum