This is an outdated version of the HTCondor Manual. You can find current documentation at http://htcondor.org/manual.
next up previous contents index
Next: condor_ssh_to_job Up: 11. Command Reference Manual Previous: condor_run   Contents   Index

Subsections


condor_set_shutdown

Set a program to execute upon condor_master shut down

Synopsis

condor_set_shutdown [-help $\vert$ -version]

condor_set_shutdown -exec programname [-debug] [-pool centralmanagerhostname[:portnumber]] [-name hostname $\vert$ hostname $\vert$ -addr "$<$a.b.c.d:port$>$" $\vert$ "$<$a.b.c.d:port$>$" $\vert$ -constraint expression $\vert$ -all ]

Description

condor_set_shutdown sets a program (typically a script) to execute when the condor_master daemon shuts down. The -exec programname argument is required, and specifies the program to run. The string programname must match the string that defines Name in the configuration variable MASTER_SHUTDOWN_$<$Name$>$ in the condor_master daemon's configuration. If it does not match, the condor_master will log an error and ignore the request.

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

Options

-help
Display usage information
-version
Display version information
-debug
Causes debugging information to be sent to stderr, based on the value of the configuration variable TOOL_DEBUG
-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

Exit Status

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

Examples

To have all condor_master daemons run the program /bin/reboot upon shut down, configure the condor_master to contain a definition similar to:
MASTER_SHUTDOWN_REBOOT = /sbin/reboot
where REBOOT is an invented name for this program that the condor_master will execute. On the command line, run
% condor_set_shutdown -exec reboot -all
% condor_off -graceful -all
where the string reboot matches the invented name.

Author

Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

Copyright © 1990-2013 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.
next up previous contents index
Next: condor_ssh_to_job Up: 11. Command Reference Manual Previous: condor_run   Contents   Index