HP StorageWorks 8/80 Brocade Fabric OS Administrator's Guide v6.3.0 (53-100133 - Page 426

Adding custom filter-based monitors, Encryption Switch, Brocade DCX, and DCX-4S platforms.

Page 426 highlights

17 Filter-based performance monitoring To define a custom filter, you must specify a series of offsets, masks, and values. For all transmitted frames, the switch performs these tasks: • Locates the byte found in the frame at the specified offset. • Applies the mask to the byte found in the frame. • Compares the value with the given values in the perfAddUserMonitor command. • Increments the filter counter if a match is found. To illustrate, if you were to enter: perfaddusermonitor 30 "4, 0xff, 0x06; 6, 0xff, 0x02; 7, 0xff, 0xd4" the operation would be successful because offset 4 is a canned monitor and has a resource already reserved for it. Offsets 6 and 7 would exhaust all unique filter monitor resources on port 30. Therefore, any additional filter monitors created on port 30 would have to be canned filter monitors. The number of different offsets per port depends on the switch platform, as follows: • Brocade 4100, 4900, 5000, 5100, 5300, 7500, 7500E, 7600, 7800, 8000, 48000, Brocade Encryption Switch, Brocade DCX, and DCX-4S platforms. Up to 15 different offsets per port (14 offsets when FICON Management Server mode, or fmsmode, is enabled). • Brocade 300 platforms. Up to 7 different offsets per port (6 offsets when fmsmode is enabled). You can specify up to four values to compare against each offset. If more than one offset is required to properly define a filter, the bytes found at each offset must match one of the given values for the filter to increment its counter. If one or more of the given offsets does not match any of the given values, the counter does not increment. The value of the offset must be between 0 and 63, in decimal format. Byte 0 indicates the first byte of the Start of Frame (SOF), byte 4 is the first byte of the frame header, and byte 28 is the first byte of the payload. Thus only the SOF, frame header, and first 36 bytes of payload can be selected as part of a filter definition. Offset 0 is a special case, which can be used to monitor the first 4 bytes of the frame (SOF). When the offset is set to 0, the values 0-7 that are checked against that offset are predefined as shown in Table 79. TABLE 79 Predefined values at offset 0 Value SOF Value SOF 0 SOFf 4 SOFi2 1 SOFc1 5 SOFn2 2 SOFi1 6 SOFi3 3 SOFn1 7 SOFn3 If the switch does not have enough resources to create a given filter, then other filters might have to be deleted to free resources. Adding custom filter-based monitors 1. Connect to the switch and log in as admin. 2. Enter the perfAddUserMonitor command: perfaddusermonitor [slotnumber/]portnumber "grouplist" [ alias ] 384 Fabric OS Administrator's Guide 53-1001336-01

  • 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
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426
  • 427
  • 428
  • 429
  • 430
  • 431
  • 432
  • 433
  • 434
  • 435
  • 436
  • 437
  • 438
  • 439
  • 440
  • 441
  • 442
  • 443
  • 444
  • 445
  • 446
  • 447
  • 448
  • 449
  • 450
  • 451
  • 452
  • 453
  • 454
  • 455
  • 456
  • 457
  • 458
  • 459
  • 460
  • 461
  • 462
  • 463
  • 464
  • 465
  • 466
  • 467
  • 468
  • 469
  • 470
  • 471
  • 472
  • 473
  • 474
  • 475
  • 476
  • 477
  • 478
  • 479
  • 480
  • 481
  • 482
  • 483
  • 484
  • 485
  • 486
  • 487
  • 488
  • 489
  • 490
  • 491
  • 492
  • 493
  • 494
  • 495
  • 496
  • 497
  • 498
  • 499
  • 500
  • 501
  • 502
  • 503
  • 504
  • 505
  • 506
  • 507
  • 508
  • 509
  • 510
  • 511
  • 512
  • 513
  • 514
  • 515
  • 516
  • 517
  • 518
  • 519
  • 520
  • 521
  • 522
  • 523
  • 524
  • 525
  • 526
  • 527
  • 528
  • 529
  • 530
  • 531
  • 532
  • 533
  • 534
  • 535
  • 536
  • 537
  • 538
  • 539
  • 540
  • 541
  • 542
  • 543
  • 544
  • 545
  • 546
  • 547
  • 548
  • 549
  • 550
  • 551
  • 552
  • 553
  • 554
  • 555
  • 556
  • 557
  • 558
  • 559
  • 560
  • 561
  • 562
  • 563
  • 564
  • 565
  • 566
  • 567
  • 568
  • 569
  • 570
  • 571
  • 572
  • 573
  • 574
  • 575
  • 576
  • 577
  • 578
  • 579
  • 580
  • 581
  • 582
  • 583
  • 584
  • 585
  • 586
  • 587
  • 588
  • 589
  • 590
  • 591
  • 592

384
Fabric OS Administrator’s Guide
53-1001336-01
Filter-based performance monitoring
17
To define a custom filter, you must specify a series of
offsets
,
masks
, and
values
. For all
transmitted frames, the switch performs these tasks:
Locates the byte found in the frame at the specified
offset.
Applies the
mask
to the byte found in the frame.
Compares the value with the given
values
in the
perfAddUserMonitor
command.
Increments the filter counter if a match is found.
To illustrate, if you were to enter:
perfaddusermonitor 30 "4, 0xff, 0x06; 6, 0xff, 0x02; 7, 0xff, 0xd4"
the operation would be successful because offset 4 is a canned monitor and has a resource
already reserved for it. Offsets 6 and 7 would exhaust all unique filter monitor resources on port
30. Therefore, any additional filter monitors created on port 30 would have to be canned filter
monitors.
The number of different offsets per port depends on the switch platform, as follows:
Brocade 4100, 4900, 5000, 5100, 5300, 7500, 7500E, 7600, 7800, 8000, 48000, Brocade
Encryption Switch, Brocade DCX, and DCX-4S platforms.
Up to 15 different offsets per port (14 offsets when FICON Management Server mode, or
fmsmode, is enabled).
Brocade 300 platforms.
Up to 7 different offsets per port (6 offsets when fmsmode is enabled).
You can specify up to four values to compare against each offset. If more than one offset is
required to properly define a filter, the bytes found at each offset must match one of the given
values for the filter to increment its counter. If one or more of the given offsets does not match any
of the given values, the counter does not increment. The value of the offset must be between 0 and
63, in decimal format. Byte 0 indicates the first byte of the Start of Frame (SOF), byte 4 is the first
byte of the frame header, and byte 28 is the first byte of the payload. Thus only the SOF, frame
header, and first 36 bytes of payload can be selected as part of a filter definition. Offset 0 is a
special case, which can be used to monitor the first 4 bytes of the frame (SOF). When the offset is
set to 0, the values 0–7 that are checked against that offset are predefined as shown in
Table 79
.
If the switch does not have enough resources to create a given filter, then other filters might have
to be deleted to free resources.
Adding custom filter-based monitors
1.
Connect to the switch and log in as admin.
2.
Enter the
perfAddUserMonitor
command:
perfaddusermonitor
[
slotnumber
/
]
portnumber
"
grouplist
"
[
alias
]
TABLE 79
Predefined values at offset 0
Value
SOF
Value
SOF
0
SOFf
4
SOFi2
1
SOFc1
5
SOFn2
2
SOFi1
6
SOFi3
3
SOFn1
7
SOFn3