1condor_off(1) General Commands Manual condor_off(1)
2
3
4
6 condor_offShutdown HTCondor daemons
7
9 condor_off[-help | -version]
10
11 condor_off[-graceful | -fast | -peaceful | -force-graceful] [-annex
12 name] [-debug] [-pool centralmanagerhostname[:portnumber]] [ -name
13 hostname| hostname| -addr "<a.b.c.d:port>"| "<a.b.c.d:port>"| -con‐
14 straint expression| -all] [-daemon daemonname]
15
17 condor_offshuts down a set of the HTCondor daemons running on a set of
18 one or more machines. It does this cleanly so that checkpointable jobs
19 may gracefully exit with minimal loss of work.
20
21 The command condor_offwithout any arguments will shut down all daemons
22 except condor_master, unless -annex nameis specified. The condor_mas‐
23 tercan then handle both local and remote requests to restart the other
24 HTCondor daemons if need be. To restart HTCondor running on a machine,
25 see the condor_oncommand.
26
27 With the -daemon masteroption, condor_offwill shut down all daemons
28 including the condor_master. Specification using the -daemonoption will
29 shut down only the specified daemon.
30
31 For security reasons of authentication and authorization, this command
32 requires ADMINISTRATORlevel of access.
33
35 -help
36
37 Display usage information
38
39
40
41 -version
42
43 Display version information
44
45
46
47 -graceful
48
49 Gracefully shutdown daemons (the default)
50
51
52
53 -fast
54
55 Quickly shutdown daemons. A minimum of the first two characters of
56 this option must be specified, to distinguish it from the -force-
57 gracefulcommand.
58
59
60
61 -peaceful
62
63 Wait indefinitely for jobs to finish
64
65
66
67 -force-graceful
68
69 Force a graceful shutdown, even after issuing a -peacefulcommand. A
70 minimum of the first two characters of this option must be speci‐
71 fied, to distinguish it from the -fastcommand.
72
73
74
75 -annex name
76
77 Turn off master daemons in the specified annex. By default this will
78 result in the corresponding instances shutting down.
79
80
81
82 -debug
83
84 Causes debugging information to be sent to stderr, based on the
85 value of the configuration variable TOOL_DEBUG.
86
87
88
89 -pool centralmanagerhostname[:portnumber]
90
91 Specify a pool by giving the central manager's host name and an
92 optional port number
93
94
95
96 -name hostname
97
98 Send the command to a machine identified by hostname
99
100
101
102 hostname
103
104 Send the command to a machine identified by hostname
105
106
107
108 -addr <a.b.c.d:port>
109
110 Send the command to a machine's master located at "<a.b.c.d:port>"
111
112
113
114 <a.b.c.d:port>
115
116 Send the command to a machine located at "<a.b.c.d:port>"
117
118
119
120 -constraint expression
121
122 Apply this command only to machines matching the given ClassAd
123 expression
124
125
126
127 -all
128
129 Send the command to all machines in the pool
130
131
132
133 -daemon daemonname
134
135 Send the command to the named daemon. Without this option, the com‐
136 mand is sent to the condor_masterdaemon.
137
138
139
141 condor_offwill exit with a status value of 0 (zero) upon success, and
142 it will exit with the value 1 (one) upon failure.
143
145 To shut down all daemons (other than condor_master) on the local host:
146
147 % condor_off
148
149 To shut down only the condor_collectoron three named machines:
150
151 % condor_off cinnamon cloves vanilla -daemon collector
152
153 To shut down daemons within a pool of machines other than the local
154 pool, use the -pooloption. The argument is the name of the central man‐
155 ager for the pool. Note that one or more machines within the pool must
156 be specified as the targets for the command. This command shuts down
157 all daemons except the condor_masteron the single machine named
158 cae17within the pool of machines that has condor.cae.wisc.eduas its
159 central manager:
160
161 % condor_off -pool condor.cae.wisc.edu -name cae17
162
164 Center for High Throughput Computing, University of Wiscon‐
165 sin–Madison
166
168 Copyright © 1990-2019 Center for High Throughput Computing, Computer
169 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
170 Rights Reserved. Licensed under the Apache License, Version 2.0.
171
172
173
174 date condor_off(1)