condor_set_shutdown Set(1) a program to execute upon condor_mastershut down

Synopsis

condor_set_shutdown [-help -version]

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

Description

condor_set_shutdownsets a program (typically a script) to execute when the condor_masterdaemon shuts down. The -exec programnameargument is required, and specifies the program to run. The string programnamemust match the string that defines Name in the configuration variable MASTER_SHUTDOWN_<Name> in the condor_masterdaemon's configuration. If it does not match, the condor_masterwill 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_masterdaemons run the program /bin/rebootupon shut down, configure the condor_masterto contain a definition similar to:


MASTER_SHUTDOWN_REBOOT = /sbin/reboot

where REBOOT is an invented name for this program that the condor_masterwill 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 (C) 1990-2015 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.