Cisco MDS-9124 Troubleshooting Guide - Page 309

Resolving Merge Failures in Mixed Fabric

Page 309 highlights

Chapter 15 Troubleshooting Distributed Device Alias Services Merge Failure Issues Send documentation comments to [email protected] Step 3 Verify the device alias mode for each of the fabrics by using the show device-alias status command. In this example, switch-1 is running in enhanced mode, while switch-2 is running in basic mode. switch-1# show device-alias status Fabric Distribution: Enabled Database:- Device Aliases 2 Mode: Enhanced switch-2# show device-alias status Fabric Distribution: Enabled Database:- Device Aliases 2 Mode: Basic Step 4 Make the appropriate change to the device alias mode for one of the fabrics. Try doing a blank commit to change the mode. A blank commit occurs when you lock the fabric, but do not make any database definition changes, and then perform a commit. This results in the distribution of the effective database of the local switch to all other switches in the fabric. In this case, change the device alias mode only, and then commit that change. Note If you need to change the device alias mode from enhanced to basic, and any application contains a device alias configuration in native format, the device alias mode cannot be changed until you explicitly remove all the native device alias configurations or replace all the device alias members with the corresponding pWWNs. Refer to the Cisco MDS 9000 Family CLI Configuration Guide for details. Resolving Merge Failures in Mixed Fabric A mixed fabric is a fabric consisting of switches running different software versions. Prior to SAN-OS Release 3.1(x), the limit for device aliases in a merged fabric was 8K. In Release 3.1(1) and later, this limit has been expanded to 20K. If you attempt to merge a fabric that includes switches running Release 3.0(x) or earlier with a fabric that includes switches running Release 3.1(x) or later, and the merged device alias database would exceed 8K, the merge will fail. To verify that the mixed fabric merge is failing because of database size, follow these steps: Step 1 Step 2 Step 3 Review the CFS or device alias merge failure syslogs to confirm that the merge failed, or issue the show cfs merge status name device-alias command to view the status of the merge. Verify that the reason for the merge failure is incompatible capabilities or configurations by using the show device-alias merge status command. switch-1# show device-alias merge status Result: Failure Reason: The merging fabrics have incompatible capabilities or configurations. Upgrade all switches in the problem fabric to SAN-OS Release 3.1(x) or later, and then attempt the merge again. Otherwise, if you must merge the fabrics, you will have to reduce the number of entries in the combined device alias database. OL-9285-05 Cisco MDS 9000 Family Troubleshooting Guide, Release 3.x 15-7

  • 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

Send documentation comments to [email protected]
15-7
Cisco MDS 9000 Family Troubleshooting Guide, Release 3.x
OL-9285-05
Chapter 15
Troubleshooting Distributed Device Alias Services
Merge Failure Issues
Step 3
Verify the device alias mode for each of the fabrics by using the
show device-alias status
command. In
this example, switch-1 is running in enhanced mode, while switch-2 is running in basic mode.
switch-1#
show device-alias status
Fabric Distribution: Enabled
Database:- Device Aliases 2 Mode: Enhanced
switch-2#
show device-alias status
Fabric Distribution: Enabled
Database:- Device Aliases 2 Mode: Basic
Step 4
Make the appropriate change to the device alias mode for one of the fabrics. Try doing a blank commit
to change the mode. A
blank commit
occurs when you lock the fabric, but do not make any database
definition changes, and then perform a commit. This results in the distribution of the effective database
of the local switch to all other switches in the fabric. In this case, change the device alias mode only, and
then commit that change.
Note
If you need to change the device alias mode from enhanced to basic, and any application contains
a device alias configuration in native format, the device alias mode cannot be changed until you
explicitly remove all the native device alias configurations or replace all the device alias
members with the corresponding pWWNs. Refer to the
Cisco MDS 9000 Family CLI
Configuration Guide
for details.
Resolving Merge Failures in Mixed Fabric
A mixed fabric is a fabric consisting of switches running different software versions. Prior to SAN-OS
Release 3.1(x), the limit for device aliases in a merged fabric was 8K. In Release 3.1(1) and later, this
limit has been expanded to 20K. If you attempt to merge a fabric that includes switches running Release
3.0(x) or earlier with a fabric that includes switches running Release 3.1(x) or later, and the merged
device alias database would exceed 8K, the merge will fail.
To verify that the mixed fabric merge is failing because of database size, follow these steps:
Step 1
Review the CFS or device alias merge failure syslogs to confirm that the merge failed, or issue the
show
cfs merge status name device-alias
command to view the status of the merge.
Step 2
Verify that the reason for the merge failure is incompatible capabilities or configurations by using the
show device-alias merge status
command.
switch-1#
show device-alias merge status
Result: Failure
Reason: The merging fabrics have incompatible capabilities or configurations.
Step 3
Upgrade all switches in the problem fabric to SAN-OS Release 3.1(x) or later, and then attempt the
merge again. Otherwise, if you must merge the fabrics, you will have to reduce the number of entries in
the combined device alias database.