.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CONDOR_RESTART" "1" "Apr 01, 2024" "" "HTCondor Manual" .SH NAME condor_restart \- HTCondor Manual .sp Restart a set of HTCondor daemons .SH SYNOPSIS .sp \fBcondor_restart\fP [\fB\-help | \-version\fP ] .sp \fBcondor_restart\fP [\fB\-debug[:opts]\fP] ] [\fB\-graceful | \-fast | \-peaceful | \-drain\fP ] [\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP] [ \fB\-name\fP \fIhostname\fP | \fIhostname\fP | \fB\-addr\fP \fI\(dq\(dq\fP | \fI\(dq\(dq\fP | \fB\-constraint\fP \fIexpression\fP | \fB\-all\fP ] [\fB\-daemon\fP \fIdaemonname\fP | \fB\-master\fP] [\fB\-exec\fP \fIname\fP] [\fB\-reason\fP \fI\(dqreason\-string\(dq\fP] [\fB\-request\-id\fP \fIid\fP] [\fB\-check\fP \fIexpr\fP] [\fB\-start\fP \fIexpr\fP] .SH DESCRIPTION .sp \fIcondor_restart\fP 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. .sp If, for example, the \fIcondor_master\fP needs to be restarted again with a fresh state, this is the command that should be used to do so. If the \fI\%DAEMON_LIST\fP variable in the configuration file has been changed, this command is used to restart the \fIcondor_master\fP in order to see this change. The \fIcondor_reconfigure\fP command cannot be used in the case where the \fI\%DAEMON_LIST\fP expression changes. .sp The command \fIcondor_restart\fP with no arguments or with the \fB\-daemon\fP \fImaster\fP 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 \fIcondor_master\fP, and then restart the \fIcondor_master\fP\&. This, in turn, will allow the \fIcondor_master\fP to start up other daemons as specified in the \fI\%DAEMON_LIST\fP configuration file entry. .sp When restarting down all daemons including the \fIcondor_master\fP, the \fB\-exec\fP argument can be used to tell the master to run a configured \fI\%MASTER_SHUTDOWN_\fP script before it restarts. .sp When the \fB\-drain\fP option is chosen, draining options can be specified by using the optional \fB\-reason\fP, \fB\-request\-id\fP, \fB\-check\fP, and \fB\-start\fP arguments. .sp For security reasons of authentication and authorization, this command requires ADMINISTRATOR level of access. .SH OPTIONS .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP \fB\-help\fP Display usage information .TP \fB\-version\fP Display version information .TP \fB\-debug[:opts]\fP Causes debugging information to be sent to \fBstderr\fP\&. The debug level can be set by specifying an optional \fIopts\fP value. Otherwise, the configuration variable \fI\%TOOL_DEBUG\fP sets the debug level. .TP \fB\-graceful\fP Gracefully shutdown daemons (the default) before restarting them .TP \fB\-fast\fP Quickly shutdown daemons before restarting them .TP \fB\-peaceful\fP Wait indefinitely for jobs to finish before shutting down daemons, prior to restarting them .TP \fB\-drain\fP Send a \fIcondor_drain\fP command with the \fI\-exit\-on\-completion\fP option to all \fIcondor_startd\fP daemons that are managed by this master. Then wait for all \fIcondor_startd\fP daemons to exit before before restarting. .TP \fB\-reason\fP \fI\(dqreason\-string\(dq\fP Use with \fB\-drain\fP to set a \fB\-reason\fP \fI\(dqreason\-string\(dq\fP value for the \fIcondor_drain\fP command. .TP \fB\-request\-id\fP \fIid\fP Use with \fB\-drain\fP to set a \fB\-request\-id\fP \fIid\fP value for the \fIcondor_drain\fP command. .TP \fB\-check\fP \fIexpr\fP Use with \fB\-drain\fP to set a \fB\-check\fP \fIexpr\fP value for the \fIcondor_drain\fP command. .TP \fB\-start\fP \fIexpr\fP Use with \fB\-drain\fP to set a \fB\-start\fP \fIexpr\fP value for the \fIcondor_drain\fP command. .TP \fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP Specify a pool by giving the central manager\(aqs host name and an optional port number .TP \fB\-name\fP \fIhostname\fP Send the command to a machine identified by \fIhostname\fP .TP .B \fIhostname\fP Send the command to a machine identified by \fIhostname\fP .TP \fB\-addr\fP \fI\(dq\(dq\fP Send the command to a machine\(aqs master located at \fI\(dq\(dq\fP .TP .B \fI\(dq\(dq\fP Send the command to a machine located at \fI\(dq\(dq\fP .TP \fB\-constraint\fP \fIexpression\fP Apply this command only to machines matching the given ClassAd \fIexpression\fP .TP \fB\-all\fP Send the command to all machines in the pool .TP \fB\-master\fP Restart the \fIcondor_master\fP after shutting down all other daemons. This will have the effect of restarting all of the daemons. .TP \fB\-exec\fP \fIname\fP When used with \fB\-master\fP, the \fIcondor_master\fP will run the program configured as \fI\%MASTER_SHUTDOWN_\fP after shutting down all other daemons. .TP \fB\-daemon\fP \fIdaemonname\fP Send the command to the named daemon. Without this option, the command is sent to the \fIcondor_master\fP daemon. .UNINDENT .UNINDENT .UNINDENT .SH EXIT STATUS .sp \fIcondor_restart\fP will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. .SH EXAMPLES .sp To restart the \fIcondor_master\fP and all its children on the local host: .INDENT 0.0 .INDENT 3.5 .sp .EX $ condor_restart .EE .UNINDENT .UNINDENT .sp To restart only the \fIcondor_startd\fP on a named machine: .INDENT 0.0 .INDENT 3.5 .sp .EX $ condor_restart \-name bluejay \-daemon startd .EE .UNINDENT .UNINDENT .sp To restart a machine within a pool other than the local pool, use the \fB\-pool\fP 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 \fBcae17\fP within the pool of machines that has \fBcondor.cae.wisc.edu\fP as its central manager: .INDENT 0.0 .INDENT 3.5 .sp .EX $ condor_restart \-pool condor.cae.wisc.edu \-name cae17 .EE .UNINDENT .UNINDENT .SH AUTHOR HTCondor Team .SH 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. .\" Generated by docutils manpage writer. .