CONDOR_RESTART(1)

📦
version 25.14.1 · 12 versions
, in fedora 43

💖 CONDOR_RESTART(1) — the HTCondor Manual, bestie edition 💖

okay so you opened the manual page for condor_restart, part of the HTCondor Manual, and honestly? iconic choice. this is the ✨ restart a set of HTCondor daemons ✨ page. let's get into it 🫶

✨ 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]

(yes there's a stray ] in there, no i'm not fixing it, it's canon 💅)

🌸 DESCRIPTION 🌸

condor_restart restarts a set of HTCondor daemons on a set of machines. the daemons get put into a consistent state, killed, and then invoked anew. like a glow-up but for processes. ✨

if, for example, the condor_master needs to be restarted again with a fresh state, this is the command you reach for, no cap. and if the DAEMON_LIST variable in the configuration file has been changed, this command is what you use to restart the condor_master so it actually sees that change. the condor_reconfigure command cannot be used in the case where the DAEMON_LIST expression changes — so don't even try it 💀

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. it's giving full system reset, main character energy 👑

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. pick your faves 🎀

for security reasons of authentication and authorization, this command requires ADMINISTRATOR level of access. no admin card, no entry, babes. 🔐

💅 OPTIONS 💅

  • -help — display usage information
  • -version — display version information
  • -debug[:opts] — causes debugging information to be sent to stderr. you can set the debug level by specifying an optional opts value. otherwise, the configuration variable TOOL_DEBUG sets the debug level. lowkey the tool spill the tea to stderr 🫖
  • -graceful — gracefully shutdown daemons (the default) before restarting them
  • -fast — quickly shutdown daemons before restarting them. zoom zoom 🏃♀️
  • -peaceful — wait indefinitely for jobs to finish before shutting down daemons, prior to restarting them. patient queen behavior 🌸
  • -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 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. everyone gets a turn 💖
  • -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. slay = 0, not slay = 1, fr fr.

🦋 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. periodt.

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

and that's the whole page, bestie 🫶 this was CONDOR_RESTART(1) from the HTCondor Manual, dated Oct 16, 2026 — go forth and restart responsibly, you absolute admin-level icon 💅✨

📦 where this page comes from