1CONDOR_RESTART(1) HTCondor Manual CONDOR_RESTART(1)
2
3
4
6 condor_restart - HTCondor Manual
7
8 Restart a set of HTCondor daemons
9
10
12 condor_restart [-help | -version ]
13
14 condor_restart [-debug ] [-graceful | -fast | -peaceful ] [-pool cen‐
15 tralmanagerhostname[:portnumber]] [ -name hostname | hostname | -addr
16 "<a.b.c.d:port>" | "<a.b.c.d:port>" | -constraint expression | -all ]
17 [-daemon daemonname]
18
20 condor_restart restarts a set of HTCondor daemons on a set of machines.
21 The daemons will be put into a consistent state, killed, and then in‐
22 voked anew.
23
24 If, for example, the condor_master needs to be restarted again with a
25 fresh state, this is the command that should be used to do so. If the
26 DAEMON_LIST variable in the configuration file has been changed, this
27 command is used to restart the condor_master in order to see this
28 change. The condor_reconfigure command cannot be used in the case where
29 the DAEMON_LIST expression changes.
30
31 The command condor_restart with no arguments or with the -daemon master
32 option will safely shut down all running jobs and all submitted jobs
33 from the machine(s) being restarted, then shut down all the child dae‐
34 mons of the condor_master, and then restart the condor_master. This, in
35 turn, will allow the condor_master to start up other daemons as speci‐
36 fied in the DAEMON_LIST configuration file entry.
37
38 For security reasons of authentication and authorization, this command
39 requires ADMINISTRATOR level of access.
40
42 -help Display usage information
43
44 -version
45 Display version information
46
47 -debug Causes debugging information to be sent to stderr, based on
48 the value of the configuration variable TOOL_DEBUG.
49
50 -graceful
51 Gracefully shutdown daemons (the default) before restarting
52 them
53
54 -fast Quickly shutdown daemons before restarting them
55
56 -peaceful
57 Wait indefinitely for jobs to finish before shutting down
58 daemons, prior to restarting them
59
60 -pool centralmanagerhostname[:portnumber]
61 Specify a pool by giving the central manager's host name and
62 an optional port number
63
64 -name hostname
65 Send the command to a machine identified by hostname
66
67 hostname
68 Send the command to a machine identified by hostname
69
70 -addr "<a.b.c.d:port>"
71 Send the command to a machine's master located at
72 "<a.b.c.d:port>"
73
74 "<a.b.c.d:port>"
75 Send the command to a machine located at "<a.b.c.d:port>"
76
77 -constraint expression
78 Apply this command only to machines matching the given Clas‐
79 sAd expression
80
81 -all Send the command to all machines in the pool
82
83 -daemon daemonname
84 Send the command to the named daemon. Without this option,
85 the command is sent to the condor_master daemon.
86
88 condor_restart will exit with a status value of 0 (zero) upon success,
89 and it will exit with the value 1 (one) upon failure.
90
92 To restart the condor_master and all its children on the local host:
93
94 % condor_restart
95
96 To restart only the condor_startd on a named machine:
97
98 % condor_restart -name bluejay -daemon startd
99
100 To restart a machine within a pool other than the local pool, use the
101 -pool option. The argument is the name of the central manager for the
102 pool. Note that one or more machines within the pool must be specified
103 as the targets for the command. This command restarts the single ma‐
104 chine named cae17 within the pool of machines that has con‐
105 dor.cae.wisc.edu as its central manager:
106
107 % condor_restart -pool condor.cae.wisc.edu -name cae17
108
110 HTCondor Team
111
113 1990-2021, Center for High Throughput Computing, Computer Sciences De‐
114 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
115 under the Apache License, Version 2.0.
116
117
118
119
1208.8 Jan 26, 2021 CONDOR_RESTART(1)