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

NAME

6       condor_off - HTCondor Manual
7
8       Shutdown HTCondor daemons
9
10

SYNOPSIS

12       condor_off [-help | -version ]
13
14       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

DESCRIPTION

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
24       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
30       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
34       For security reasons of authentication and authorization, this  command
35       requires ADMINISTRATOR level of access.
36

OPTIONS

38          -help  Display usage information
39
40          -version
41                 Display version information
42
43          -graceful
44                 Gracefully shutdown daemons (the default)
45
46          -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
50          -peaceful
51                 Wait indefinitely for jobs to finish
52
53          -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
58          -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
63          -debug Causes  debugging  information to be sent to stderr, based on
64                 the value of the configuration variable TOOL_DEBUG.
65
66          -pool centralmanagerhostname[:portnumber]
67                 Specify a pool by giving the central manager's host name  and
68                 an optional port number
69
70          -name hostname
71                 Send the command to a machine identified by hostname
72
73          hostname
74                 Send the command to a machine identified by hostname
75
76          -addr "<a.b.c.d:port>"
77                 Send   the   command   to   a  machine's  master  located  at
78                 "<a.b.c.d:port>"
79
80          "<a.b.c.d:port>"
81                 Send the command to a machine located at "<a.b.c.d:port>"
82
83          -constraint expression
84                 Apply this command only to machines matching the given  Clas‐
85                 sAd expression
86
87          -all   Send the command to all machines in the pool
88
89          -daemon daemonname
90                 Send  the  command  to the named daemon. Without this option,
91                 the command is sent to the condor_master daemon.
92

EXIT STATUS

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

EXAMPLES

98       To shut down all daemons (other than condor_master) on the local host:
99
100          % condor_off
101
102       To shut down only the condor_collector on three named machines:
103
104          % condor_off  cinnamon cloves vanilla -daemon collector
105
106       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
114          % condor_off  -pool condor.cae.wisc.edu -name cae17
115

AUTHOR

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.
123
124
125
126
1278.8                              Jan 19, 2022                    CONDOR_OFF(1)
Impressum