~ubuntu-branches/ubuntu/precise/slurm-llnl/precise

« back to all changes in this revision

Viewing changes to doc/man/man1/strigger.1

  • Committer: Bazaar Package Importer
  • Author(s): Gennaro Oliva
  • Date: 2011-04-08 11:21:17 UTC
  • mfrom: (3.3.16 sid)
  • Revision ID: james.westby@ubuntu.com-20110408112117-nfnyq9dtm55hqoaw
Tags: 2.2.4-1
* New upstream releases 
* Cleaning spare file and directories, not belonging to the sources
  generated by the building process and not removed by distclean.
  Added debian/clean with spare files and rm -rf inside debian/rules
  for directories.
* Added new packages libslurm-perl, libslurmdb-perl, slurm-llnl-torque
  (Closes: #575822) thanks to Julien Blache

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH STRIGGER "1" "May 2008" "strigger 2.0" "Slurm components"
 
1
.TH STRIGGER "1" "September 2010" "strigger 2.2" "Slurm components"
2
2
 
3
3
.SH "NAME"
4
4
strigger \- Used set, get or clear Slurm trigger information.
45
45
 
46
46
.SH "ARGUMENTS"
47
47
.TP
 
48
\fB\-a\fR, \fB\-\-primary_slurmctld_failure\fR
 
49
Trigger an event when the primary slurmctld fails.
 
50
 
 
51
.TP
 
52
\fB\-A\fR, \fB\-\-primary_slurmctld_resumed_operation\fR
 
53
Trigger an event when the primary slurmctld resuming operation after failure.
 
54
 
 
55
.TP
 
56
\fB\-b\fR, \fB\-\-primary_slurmctld_resumed_control\fR
 
57
Trigger an event when primary slurmctld resumes control.
 
58
 
 
59
.TP
 
60
\fB\-B\fR, \fB\-\-backup_slurmctld_failure\fR
 
61
Trigger an event when the backup slurmctld fails.
 
62
 
 
63
.TP
48
64
\fB\-\-block_err\fP
49
65
Trigger an event when a BlueGene block enters an ERROR state.
50
66
 
51
67
.TP
 
68
\fB\-c\fR, \fB\-\-backup_slurmctld_resumed_operation\fR
 
69
Trigger an event when the backup slurmctld resumes operation after failure.
 
70
 
 
71
.TP
 
72
\fB\-C\fR, \fB\-\-backup_slurmctld_assumed_control\fR
 
73
Trigger event when backup slurmctld assumes control.
 
74
 
 
75
.TP
52
76
\fB\-\-clear\fP
53
77
Clear or delete a previously defined event trigger.
54
78
The \fB\-\-id\fR, \fB\-\-jobid\fR or \fB\-\-userid\fR
65
89
Trigger an event if the specified node goes into a DRAINED state.
66
90
 
67
91
.TP
 
92
\fB\-e\fR, \fB\-\-primary_slurmctld_acct_buffer_full\fR
 
93
Trigger an event when primary slurmctld accounting buffer is full.
 
94
 
 
95
.TP
68
96
\fB\-F\fR, \fB\-\-fail\fR
69
97
Trigger an event if the specified node goes into a FAILING state.
70
98
 
73
101
Trigger an event when the specified job completes execution.
74
102
 
75
103
.TP
 
104
\fB\-g\fR, \fB\-\-primary_slurmdbd_failure\fR
 
105
Trigger an event when the primary slurmdbd fails.
 
106
 
 
107
.TP
 
108
\fB\-G\fR, \fB\-\-primary_slurmdbd_resumed_operation\fR
 
109
Trigger an event when the primary slurmdbd resumes operation after failure.
 
110
 
 
111
.TP
76
112
\fB\-\-get\fP
77
113
Show registered event triggers.
78
114
Options can be used for filtering purposes.
79
115
 
80
116
.TP
 
117
\fB\-h\fR, \fB\-\-primary_database_failure\fR
 
118
Trigger an event when the primary database fails.
 
119
 
 
120
.TP
 
121
\fB\-H\fR, \fB\-\-primary_database_resumed_operation\fR
 
122
Trigger an event when the primary database resumes operation after failure.
 
123
 
 
124
.TP
81
125
\fB\-i\fR, \fB\-\-id\fR=\fIid\fR
82
126
Trigger ID number.
83
127
 
110
154
trigger event.
111
155
 
112
156
.TP
 
157
\fB\-M\fR, \fB\-\-clusters\fR=<\fIstring\fR>
 
158
Clusters to issue commands to.
 
159
 
 
160
.TP
113
161
\fB\-o\fR, \fB\-\-offset\fR=\fIseconds\fR
114
162
The specified action should follow the event by this time interval.
115
163
Specify a negative value if action should preceded the event.
199
247
Pathname of the program to execute when the event occurs
200
248
 
201
249
.SH "EXAMPLES"
 
250
Execute the program "/usr/sbin/primary_slurmctld_failure" whenever the
 
251
primary slurmctld fails.
 
252
 
 
253
.nf
 
254
        > cat /usr/sbin/primary_slurmctld_failure
 
255
        #!/bin/bash
 
256
        # Submit trigger for next primary slurmctld failure event
 
257
        strigger \-\-set \-\-primary_slurmctld_failure \\
 
258
                 \-\-program=/usr/sbin/primary_slurmctld_failure
 
259
        # Notify the administrator of the failure using by e\-mail
 
260
        /usr/bin/mail slurm_admin@site.com \-s Primary_SLURMCTLD_FAILURE
 
261
 
 
262
        > strigger \-\-set \-\-primary_slurmctld_failure \\
 
263
                   \-\-program=/usr/sbin/primary_slurmctld_failure
 
264
.fi
 
265
 
 
266
.PP
202
267
Execute the program "/usr/sbin/slurm_admin_notify" whenever
203
268
any node in the cluster goes down. The subject line will include
204
269
the node names which have entered the down state (passed as an
271
336
 
272
337
.SH "COPYING"
273
338
Copyright (C) 2007 The Regents of the University of California.
 
339
Copyright (C) 2008\-2010 Lawrence Livermore National Security.
274
340
Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
275
341
CODE\-OCEC\-09\-009. All rights reserved.
276
342
.LP