1CONDOR_OFF(1) HTCondor Manual CONDOR_OFF(1)
2
6 condor_off - HTCondor Manual
7 Shutdown HTCondor daemons
9
12 condor_off [-help | -version ]
13 condor_off [-graceful | -fast | -peaceful | -force-graceful ] [-annex
15 name] [-debug ] [-pool centralmanagerhostname[:portnumber]] [ -name
16 hostname | hostname | -addr "<a.b.c.d:port>" | "<a.b.c.d:port>" | -con‐
17 straint expression | -all ] [-daemon daemonname]
18
20 condor_off shuts down a set of the HTCondor daemons running on a set of
21 one or more machines. It does this cleanly so that checkpointable jobs
22 may gracefully exit with minimal loss of work.
23 The command condor_off without any arguments will shut down all daemons
25 except condor_master, unless -annex name is specified. The condor_mas‐
26 ter can then handle both local and remote requests to restart the other
27 HTCondor daemons if need be. To restart HTCondor running on a machine,
28 see the condor_on command.
29 With the -daemon master option, condor_off will shut down all daemons
31 including the condor_master. Specification using the -daemon option
32 will shut down only the specified daemon.
33 For security reasons of authentication and authorization, this command
35 requires ADMINISTRATOR level of access.
36
38 -help Display usage information
39 -version
41 Display version information
42 -graceful
44 Gracefully shutdown daemons (the default)
45 -fast Quickly shutdown daemons. A minimum of the first two charac‐
47 ters of this option must be specified, to distinguish it from
48 the -force-graceful command.
49 -peaceful
51 Wait indefinitely for jobs to finish
52 -force-graceful
54 Force a graceful shutdown, even after issuing a -peaceful
55 command. A minimum of the first two characters of this option
56 must be specified, to distinguish it from the -fast command.
57 -annex name
59 Turn off master daemons in the specified annex. By default
60 this will result in the corresponding instances shutting
61 down.
62 -debug Causes debugging information to be sent to stderr, based on
64 the value of the configuration variable TOOL_DEBUG.
65 -pool centralmanagerhostname[:portnumber]
67 Specify a pool by giving the central manager's host name and
68 an optional port number
69 -name hostname
71 Send the command to a machine identified by hostname
72 hostname
74 Send the command to a machine identified by hostname
75 -addr "<a.b.c.d:port>"
77 Send the command to a machine's master located at
78 "<a.b.c.d:port>"
79 "<a.b.c.d:port>"
81 Send the command to a machine located at "<a.b.c.d:port>"
82 -constraint expression
84 Apply this command only to machines matching the given Clas‐
85 sAd expression
86 -all Send the command to all machines in the pool
88 -daemon daemonname
90 Send the command to the named daemon. Without this option,
91 the command is sent to the condor_master daemon.
92
94 condor_off will exit with a status value of 0 (zero) upon success, and
95 it will exit with the value 1 (one) upon failure.
96
98 To shut down all daemons (other than condor_master) on the local host:
99 % condor_off
101 To shut down only the condor_collector on three named machines:
103 % condor_off cinnamon cloves vanilla -daemon collector
105 To shut down daemons within a pool of machines other than the local
107 pool, use the -pool option. The argument is the name of the central
108 manager for the pool. Note that one or more machines within the pool
109 must be specified as the targets for the command. This command shuts
110 down all daemons except the condor_master on the single machine named
111 cae17 within the pool of machines that has condor.cae.wisc.edu as its
112 central manager:
113 % condor_off -pool condor.cae.wisc.edu -name cae17
115
117 HTCondor Team
118
120 1990-2022, Center for High Throughput Computing, Computer Sciences De‐
121 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
122 under the Apache License, Version 2.0.
1238.8 Jan 19, 2022 CONDOR_OFF(1)