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

NAME

6       condor_restart - HTCondor Manual
7
8       Restart a set of HTCondor daemons
9
10

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

EXIT STATUS

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

EXAMPLES

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

AUTHOR

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)
Impressum