HP StorageWorks 2/16V Brocade Fabric Manager Administrator's Guide (53-1000019 - Page 162

Call Home Email Messages, Call Home External Executable

Page 162 highlights

10 About Call Home Call Home Email Messages You can configure call home to send an email message to a user-defined email address whenever a call home event is triggered for an unhealthy switch. The email message contains the details of the FTP server location where the supportShow or supportSave information is captured. The supportShow and supportSave commands run in the background. When the operation completes, another email message is sent with the zipped supportShow or supportSave output and XML file attachments. This email has the original call home email subject line plus "with SupportShow" added at the end. The body of this email is the same as the first email. Fabric Manager also sends an XML file as an attachment in the call home email message. You can select the format for the XML file from one of two options. See "Configuring Notification Parameters" on page 7-13 for instructions. If you want to be notified that the server is still running, you can configure call home to send a "server is alive" email message periodically. The default (and minimum) value is one-hour intervals; the maximum value is 32767. The "server is alive" messages include the list of switches in the configuration and the server name and IP address. These messages serve as a notice that call home is functioning properly. Call Home External Executable You can configure call home to run an external executable script whenever a call home event is triggered for an unhealthy switch. You can configure call home to run this executable instead of or in addition to sending an email message. If you configure an external executable, Fabric Manager passes an XML file to the executable whenever a call home event occurs. This XML file is also sent as an attachment in the call home email message. The external executable runs as a background process, and the task manager monitors the process. All other functionality is at your discretion. See "Configuring Notification Parameters" on page 7-13 for instructions on selecting the format for the XML file. Caution Large executables can impair the performance of your server. The external executable must have the following characteristics: • It must reside on the Fabric Manager server. • It must be capable of being executed by the OS where the Fabric Manager server is installed and it must be a valid binary for that OS (Windows, Solaris, or Linux). • It must be able to receive a command-line argument from Fabric Manager. The argument is the name of the XML file that call home generates when an event occurs. For example, if you enter the executable C:\executable.exe in the External Executable on Server field when prompted by the Call Home Configuration wizard, call home launches C:\executable.exe filename.xml, where filename is the name of the file that is passed as an argument to the executable when a call home event is triggered. Note There might be additional executable requirements, depending on your needs. 10-2 Fabric Manager Administrator's Guide Publication Number: 53-1000196-01-HP

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406

10-2
Fabric Manager Administrator’s Guide
Publication Number: 53-1000196-01-HP
About Call Home
10
Call Home Email Messages
You can configure call home to send an email message to a user-defined email address whenever a call
home event is triggered for an unhealthy switch. The email message contains the details of the FTP
server location where the
supportShow
or
supportSave
information is captured.
The
supportShow
and
supportSave
commands run in the background. When the operation completes,
another email message is sent with the zipped
supportShow
or
supportSave
output and XML file
attachments. This email has the original call home email subject line plus “with SupportShow” added at
the end. The body of this email is the same as the first email.
Fabric Manager also sends an XML file as an attachment in the call home email message. You can
select the format for the XML file from one of two options. See
“Configuring Notification Parameters”
on page 7-13
for instructions.
If you want to be notified that the server is still running, you can configure call home to send a “server
is alive” email message periodically. The default (and minimum) value is one-hour intervals; the
maximum value is 32767. The “server is alive” messages include the list of switches in the
configuration and the server name and IP address. These messages serve as a notice that call home is
functioning properly.
Call Home External Executable
You can configure call home to run an external executable script whenever a call home event is
triggered for an unhealthy switch. You can configure call home to run this executable instead of or in
addition to sending an email message.
If you configure an external executable, Fabric Manager passes an XML file to the executable whenever
a call home event occurs. This XML file is also sent as an attachment in the call home email message.
The external executable runs as a background process, and the task manager monitors the process. All
other functionality is at your discretion. See
“Configuring Notification Parameters” on page 7-13
for
instructions on selecting the format for the XML file.
The external executable must have the following characteristics:
It must reside on the Fabric Manager server.
It must be capable of being executed by the OS where the Fabric Manager server is installed and it
must be a valid binary for that OS (Windows, Solaris, or Linux).
It must be able to receive a command-line argument from Fabric Manager. The argument is the
name of the XML file that call home generates when an event occurs.
For example, if you enter the executable
C:\executable.exe
in the
External Executable on Server
field
when prompted by the Call Home Configuration wizard, call home launches
C:\executable.exe
filename
.xml
, where
filename
is the name of the file that is passed as an argument to the executable
when a call home event is triggered.
Caution
Large executables can impair the performance of your server.
Note
There might be additional executable requirements, depending on your needs.