1CONDOR_SET_SHUTDOWN(1)          HTCondor Manual         CONDOR_SET_SHUTDOWN(1)
2
3
4

NAME

6       condor_set_shutdown - HTCondor Manual
7
8       Set a program to execute upon condor_master shut down
9
10

SYNOPSIS

12       condor_set_shutdown [-help | -version ]
13
14       condor_set_shutdown  -exec programname [-debug ] [-pool centralmanager‐
15       hostname[:portnumber]]  [   -name   hostname   |   hostname   |   -addr
16       "<a.b.c.d:port>" | "<a.b.c.d:port>" | -constraint expression | -all ]
17

DESCRIPTION

19       condor_set_shutdown sets a program (typically a script) to execute when
20       the condor_master daemon shuts down. The -exec programname argument  is
21       required, and specifies the program to run. The string programname must
22       match the string that defines Name in the configuration  variable  MAS‐
23       TER_SHUTDOWN_<Name>  in the condor_master daemon's configuration. If it
24       does not match, the condor_master will log an error and ignore the  re‐
25       quest.
26
27       For  security reasons of authentication and authorization, this command
28       requires ADMINISTRATOR level of access.
29

OPTIONS

31          -help  Display usage information
32
33          -version
34                 Display version information
35
36          -debug Causes debugging information to be sent to stderr,  based  on
37                 the value of the configuration variable TOOL_DEBUG.
38
39          -pool centralmanagerhostname[:portnumber]
40                 Specify  a pool by giving the central manager's host name and
41                 an optional port number
42
43          -name hostname
44                 Send the command to a machine identified by hostname
45
46          hostname
47                 Send the command to a machine identified by hostname
48
49          -addr "<a.b.c.d:port>"
50                 Send  the  command  to  a   machine's   master   located   at
51                 "<a.b.c.d:port>"
52
53          "<a.b.c.d:port>"
54                 Send the command to a machine located at "<a.b.c.d:port>"
55
56          -constraint expression
57                 Apply  this command only to machines matching the given Clas‐
58                 sAd expression
59
60          -all   Send the command to all machines in the pool
61

EXIT STATUS

63       condor_set_shutdown will exit with a status value of 0 (zero) upon suc‐
64       cess, and it will exit with the value 1 (one) upon failure.
65

EXAMPLES

67       To have all condor_master daemons run the program /bin/reboot upon shut
68       down, configure the condor_master to contain a definition similar to:
69
70          MASTER_SHUTDOWN_REBOOT = /sbin/reboot
71
72       where REBOOT is an invented name for this program that the  condor_mas‐
73       ter will execute. On the command line, run
74
75          % condor_set_shutdown -exec reboot -all
76          % condor_off -graceful -all
77
78       where the string reboot matches the invented name.
79

AUTHOR

81       HTCondor Team
82
84       1990-2021,  Center for High Throughput Computing, Computer Sciences De‐
85       partment, University of Wisconsin-Madison, Madison,  WI,  US.  Licensed
86       under the Apache License, Version 2.0.
87
88
89
90
918.8                              Aug 23, 2021           CONDOR_SET_SHUTDOWN(1)
Impressum