NAME

       condor_restart - HTCondor Manual

       Restart a set of HTCondor daemons

SYNOPSIS

       condor_restart [-help | -version ]

       condor_restart    [-debug[:opts]]    ]   [-graceful   |   -fast   |   -peaceful   |   -drain   ]   [-pool
       centralmanagerhostname[:portnumber]]  [  -name  hostname  |   hostname   |   -addr   "<a.b.c.d:port>"   |
       "<a.b.c.d:port>"  |  -constraint expression | -all ] [-daemon daemonname | -master] [-exec name] [-reason
       "reason-string"] [-request-id id] [-check expr] [-start expr]

DESCRIPTION

       condor_restart restarts a set of HTCondor daemons on a set of machines. The daemons will be  put  into  a
       consistent state, killed, and then invoked anew.

       If,  for  example,  the condor_master needs to be restarted again with a fresh state, this is the command
       that should be used to do so. If the DAEMON_LIST variable in the configuration  file  has  been  changed,
       this  command  is  used  to restart the condor_master in order to see this change. The condor_reconfigure
       command cannot be used in the case where the DAEMON_LIST expression changes.

       The command condor_restart with no arguments or with the -daemon master option will safely shut down  all
       running  jobs  and  all  submitted jobs from the machine(s) being restarted, then shut down all the child
       daemons of the condor_master, and  then  restart  the  condor_master.  This,  in  turn,  will  allow  the
       condor_master to start up other daemons as specified in the DAEMON_LIST configuration file entry.

       When  restarting down all daemons including the condor_master, the -exec argument can be used to tell the
       master to run a configured MASTER_SHUTDOWN_<Name> script before it restarts.

       When the -drain option is chosen, draining options can  be  specified  by  using  the  optional  -reason,
       -request-id, -check, and -start arguments.

       For  security  reasons  of authentication and authorization, this command requires ADMINISTRATOR level of
       access.

OPTIONS

          -help  Display usage information

          -version
                 Display version information

          -debug[:opts]
                 Causes debugging information to be sent to stderr. The debug level can be set by specifying  an
                 optional opts value. Otherwise, the configuration variable TOOL_DEBUG sets the debug level.

          -graceful
                 Gracefully shutdown daemons (the default) before restarting them

          -fast  Quickly shutdown daemons before restarting them

          -peaceful
                 Wait indefinitely for jobs to finish before shutting down daemons, prior to restarting them

          -drain Send  a  condor_drain  command with the -exit-on-completion option to all condor_startd daemons
                 that are managed by this master. Then wait for all condor_startd daemons to exit before  before
                 restarting.

          -reason "reason-string"
                 Use with -drain to set a -reason "reason-string" value for the condor_drain command.

          -request-id id
                 Use with -drain to set a -request-id id value for the condor_drain command.

          -check expr
                 Use with -drain to set a -check expr value for the condor_drain command.

          -start expr
                 Use with -drain to set a -start expr value for the condor_drain command.

          -pool centralmanagerhostname[:portnumber]
                 Specify a pool by giving the central manager's host name and an optional port number

          -name hostname
                 Send the command to a machine identified by hostname

          hostname
                 Send the command to a machine identified by hostname

          -addr "<a.b.c.d:port>"
                 Send the command to a machine's master located at "<a.b.c.d:port>"

          "<a.b.c.d:port>"
                 Send the command to a machine located at "<a.b.c.d:port>"

          -constraint expression
                 Apply this command only to machines matching the given ClassAd expression

          -all   Send the command to all machines in the pool

          -master
                 Restart  the  condor_master after shutting down all other daemons. This will have the effect of
                 restarting all of the daemons.

          -exec name
                 When  used  with  -master,   the   condor_master   will   run   the   program   configured   as
                 MASTER_SHUTDOWN_<Name> after shutting down all other daemons.

          -daemon daemonname
                 Send  the  command  to  the  named  daemon.  Without  this  option,  the command is sent to the
                 condor_master daemon.

EXIT STATUS

       condor_restart will exit with a status value of 0 (zero) upon success, and it will exit with the value  1
       (one) upon failure.

EXAMPLES

       To restart the condor_master and all its children on the local host:

          $ condor_restart

       To restart only the condor_startd on a named machine:

          $ condor_restart -name bluejay -daemon startd

       To  restart  a machine within a pool other than the local pool, use the -pool option. The argument is the
       name of the central manager for the pool. Note that  one  or  more  machines  within  the  pool  must  be
       specified as the targets for the command. This command restarts the single machine named cae17 within the
       pool of machines that has condor.cae.wisc.edu as its central manager:

          $ condor_restart -pool condor.cae.wisc.edu -name cae17

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024,  Center  for High Throughput Computing, Computer Sciences Department, University of Wisconsin-
       Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                                  Aug 06, 2025                                 CONDOR_RESTART(1)