1CONDOR_RESTART(1) HTCondor Manual CONDOR_RESTART(1)
2
6 condor_restart - HTCondor Manual
7 Restart a set of HTCondor daemons
9
12 condor_restart [-help | -version ]
13 condor_restart [-debug[:opts]] ] [-graceful | -fast | -peaceful |
15 -drain ] [-pool centralmanagerhostname[:portnumber]] [ -name hostname |
16 hostname | -addr "<a.b.c.d:port>" | "<a.b.c.d:port>" | -constraint ex‐
17 pression | -all ] [-daemon daemonname | -master] [-exec name] [-reason
18 "reason-string"] [-request-id id] [-check expr] [-start expr]
19
21 condor_restart restarts a set of HTCondor daemons on a set of machines.
22 The daemons will be put into a consistent state, killed, and then in‐
23 voked anew.
24 If, for example, the condor_master needs to be restarted again with a
26 fresh state, this is the command that should be used to do so. If the
27 DAEMON_LIST variable in the configuration file has been changed, this
28 command is used to restart the condor_master in order to see this
29 change. The condor_reconfigure command cannot be used in the case where
30 the DAEMON_LIST expression changes.
31 The command condor_restart with no arguments or with the -daemon master
33 option will safely shut down all running jobs and all submitted jobs
34 from the machine(s) being restarted, then shut down all the child dae‐
35 mons of the condor_master, and then restart the condor_master. This, in
36 turn, will allow the condor_master to start up other daemons as speci‐
37 fied in the DAEMON_LIST configuration file entry.
38 When restarting down all daemons including the condor_master, the -exec
40 argument can be used to tell the master to run a configured
41 MASTER_SHUTDOWN_<Name> script before it restarts.
42 When the -drain option is chosen, draining options can be specified by
44 using the optional -reason, -request-id, -check, and -start arguments.
45 For security reasons of authentication and authorization, this command
47 requires ADMINISTRATOR level of access.
48
50 -help Display usage information
51 -version
53 Display version information
54 -debug[:opts]
56 Causes debugging information to be sent to stderr. The debug
57 level can be set by specifying an optional opts value. Other‐
58 wise, the configuration variable TOOL_DEBUG sets the debug
59 level.
60 -graceful
62 Gracefully shutdown daemons (the default) before restarting
63 them
64 -fast Quickly shutdown daemons before restarting them
66 -peaceful
68 Wait indefinitely for jobs to finish before shutting down
69 daemons, prior to restarting them
70 -drain Send a condor_drain command with the -exit-on-completion op‐
72 tion to all condor_startd daemons that are managed by this
73 master. Then wait for all condor_startd daemons to exit be‐
74 fore before restarting.
75 -reason "reason-string"
77 Use with -drain to set a -reason "reason-string" value for
78 the condor_drain command.
79 -request-id id
81 Use with -drain to set a -request-id id value for the con‐
82 dor_drain command.
83 -check expr
85 Use with -drain to set a -check expr value for the con‐
86 dor_drain command.
87 -start expr
89 Use with -drain to set a -start expr value for the con‐
90 dor_drain command.
91 -pool centralmanagerhostname[:portnumber]
93 Specify a pool by giving the central manager's host name and
94 an optional port number
95 -name hostname
97 Send the command to a machine identified by hostname
98 hostname
100 Send the command to a machine identified by hostname
101 -addr "<a.b.c.d:port>"
103 Send the command to a machine's master located at
104 "<a.b.c.d:port>"
105 "<a.b.c.d:port>"
107 Send the command to a machine located at "<a.b.c.d:port>"
108 -constraint expression
110 Apply this command only to machines matching the given Clas‐
111 sAd expression
112 -all Send the command to all machines in the pool
114 -master
116 Restart the condor_master after shutting down all other dae‐
117 mons. This will have the effect of restarting all of the dae‐
118 mons.
119 -exec name
121 When used with -master, the condor_master will run the pro‐
122 gram configured as MASTER_SHUTDOWN_<Name> after shutting down
123 all other daemons.
124 -daemon daemonname
126 Send the command to the named daemon. Without this option,
127 the command is sent to the condor_master daemon.
128
130 condor_restart will exit with a status value of 0 (zero) upon success,
131 and it will exit with the value 1 (one) upon failure.
132
134 To restart the condor_master and all its children on the local host:
135 $ condor_restart
137 To restart only the condor_startd on a named machine:
139 $ condor_restart -name bluejay -daemon startd
141 To restart a machine within a pool other than the local pool, use the
143 -pool option. The argument is the name of the central manager for the
144 pool. Note that one or more machines within the pool must be specified
145 as the targets for the command. This command restarts the single ma‐
146 chine named cae17 within the pool of machines that has con‐
147 dor.cae.wisc.edu as its central manager:
148 $ condor_restart -pool condor.cae.wisc.edu -name cae17
150
152 HTCondor Team
153
155 1990-2023, Center for High Throughput Computing, Computer Sciences De‐
156 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
157 under the Apache License, Version 2.0.
158 Oct 02, 2023 CONDOR_RESTART(1)