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  HTCondor queue from the hosts
7       where 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 HTCondor job queue
21       and 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  SoftKillSig
29       in the job ClassAd), and HTCondor will restart the job from the  begin‐
30       ning 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_USERS macro) 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       Center for High Throughput Computing, University of Wisconsin-Madison
147

149       Copyright (C) 1990-2018 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  just-man-pages/condor_vacate_job(1)
Impressum