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          -exec name
37                 Select the program the master should exec the  next  time  it
38                 shuts  down.   The  master will run the program configured as
39                 MASTER_SHUTDOWN_<name> from the  configuration  of  the  con‐
40                 dor_master.
41
42          -debug Causes  debugging  information to be sent to stderr, based on
43                 the value of the configuration variable TOOL_DEBUG.
44
45          -pool centralmanagerhostname[:portnumber]
46                 Specify a pool by giving the central manager's host name  and
47                 an optional port number
48
49          -name hostname
50                 Send the command to a machine identified by hostname
51
52          hostname
53                 Send the command to a machine identified by hostname
54
55          -addr "<a.b.c.d:port>"
56                 Send   the   command   to   a  machine's  master  located  at
57                 "<a.b.c.d:port>"
58
59          "<a.b.c.d:port>"
60                 Send the command to a machine located at "<a.b.c.d:port>"
61
62          -constraint expression
63                 Apply this command only to machines matching the given  Clas‐
64                 sAd expression
65
66          -all   Send the command to all machines in the pool
67

EXIT STATUS

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

EXAMPLES

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

AUTHOR

87       HTCondor Team
88

90       1990-2023, Center for High Throughput Computing, Computer Sciences  De‐
91       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
92       under the Apache License, Version 2.0.
93
94
95
96
97                                 Oct 02, 2023           CONDOR_SET_SHUTDOWN(1)
Impressum