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
25       request.
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-2020,  Center  for  High  Throughput  Computing, Computer Sciences
85       Department, University of Wisconsin-Madison, Madison, WI, US.  Licensed
86       under the Apache License, Version 2.0.
87
88
89
90
918.8                              Aug 06, 2020           CONDOR_SET_SHUTDOWN(1)
Impressum