1CONDOR_VACATE(1)                HTCondor Manual               CONDOR_VACATE(1)
2
3
4

NAME

6       condor_vacate - HTCondor Manual
7
8       Vacate jobs that are running on the specified hosts
9
10

SYNOPSIS

12       condor_vacate [-help | -version ]
13
14       condor_vacate [-graceful | -fast ] [-debug ] [-pool centralmanagerhost‐
15       name[:portnumber]] [ -name hostname | hostname | -addr "<a.b.c.d:port>"
16       | "<a.b.c.d:port>" | -constraint expression | -all ]
17

DESCRIPTION

19       condor_vacate  causes HTCondor force jobs to vacate from a given set of
20       machines. The job(s) remains in the submitting machine's job queue.
21
22       Given the (default) -graceful option,  jobs  are  killed  and  HTCondor
23       restarts  the  job from the beginning somewhere else. condor_vacate has
24       no effect on a machine with no HTCondor job currently running.
25
26       There is generally no need for the user or administrator to  explicitly
27       run  condor_vacate.  HTCondor  takes care of jobs in this way automati‐
28       cally following the policies given in configuration files.
29

OPTIONS

31          -help  Display usage information
32
33          -version
34                 Display version information
35
36          -graceful
37                 Give the job a change to shut down  cleanly,  then  soft-kill
38                 it.
39
40          -fast  Hard-kill jobs instead of giving them to shut down cleanly.
41
42          -debug Causes  debugging  information to be sent to stderr, based on
43                 the value of the configuration variable TOOL_DEBUG.
44
45          -pool centralmanagerhostname[:portnumber]
46                 Specify a pool by giving the central manager's host name  and
47                 an optional port number
48
49          -name hostname
50                 Send the command to a machine identified by hostname
51
52          hostname
53                 Send the command to a machine identified by hostname
54
55          -addr "<a.b.c.d:port>"
56                 Send   the   command   to   a  machine's  master  located  at
57                 "<a.b.c.d:port>"
58
59          "<a.b.c.d:port>"
60                 Send the command to a machine located at "<a.b.c.d:port>"
61
62          -constraint expression
63                 Apply this command only to machines matching the given  Clas‐
64                 sAd expression
65
66          -all   Send the command to all machines in the pool
67

EXIT STATUS

69       condor_vacate  will  exit with a status value of 0 (zero) upon success,
70       and it will exit with the value 1 (one) upon failure.
71

EXAMPLES

73       To send a condor_vacate command to two named machines:
74
75          $ condor_vacate  robin cardinal
76
77       To send the condor_vacate command to a machine within  a  pool  of  ma‐
78       chines other than the local pool, use the -pool option. The argument is
79       the name of the central manager for the pool. Note that one or more ma‐
80       chines  within  the  pool must be specified as the targets for the com‐
81       mand. This command sends the command to  a  the  single  machine  named
82       cae17  within  the pool of machines that has condor.cae.wisc.edu as its
83       central manager:
84
85          $ condor_vacate -pool condor.cae.wisc.edu -name cae17
86

AUTHOR

88       HTCondor Team
89

91       1990-2023, Center for High Throughput Computing, Computer Sciences  De‐
92       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
93       under the Apache License, Version 2.0.
94
95
96
97
98                                 Oct 02, 2023                 CONDOR_VACATE(1)
Impressum