HP MSA 1040 HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 340

trust, Steps for running the trust command

Page 340 highlights

trust Description Enables an offline vdisk to be brought online for emergency data recovery. This command must be enabled before each use. If used improperly this command can cause unstable operation and data loss; before use, carefully read the cautions and procedures below. The trust command provides an opportunity to recover data from a vdisk that has gone offline due to disk failure. The command forces a resynchronization of the metadata (as well as time and date stamps) that unifies members of a vdisk, and essentially puts the vdisk back into an accessible state. As long as the failed disks are operable, data can be read from the disks and restored to another location. From examining the state of the disks, if the command determines that the trust operation is unsafe-that it may result in an unstable vdisk with data corruption-the command will fail. You may then seek assistance from technical support or run the command with a special parameter to acknowledge the risk of proceeding. Otherwise, if the command determines the operation to be safe, the command will proceed. When the "trusted" vdisk is back online, back up its data and audit the data to make sure that it is intact. Then delete that vdisk, create a new vdisk, and restore data from the backup to the new vdisk. Using a trusted vdisk is only a disaster-recovery measure; the vdisk has no tolerance for any additional failures. The following procedure outlines the general steps for performing a trust operation, but the best procedure to follow for your situation may vary from this procedure. Before starting this procedure, consult the online troubleshooting guide at http://www.hp.com/support/msa2040/Troubleshooting to determine if the trust operation is applicable to your situation and for guidance to perform it. CAUTION: 1. Do not use the trust command when the storage system is unstable; for example, if there are many power or topology-change events. 2. The trust command cannot be run on a quarantined vdisk. In many cases the vdisk will be automatically dequarantined. If you cannot resolve the issue that caused the disk to become quarantined such that it is automatically dequarantined, and if the trust operation is applicable to your situation, dequarantine the vdisk, confirm it is in offline state by using the show vdisks command, and then proceed to trust. 3. Never update controller-module, expansion-module, or disk firmware when the vdisk is offline. 4. Never clear unwritten data cache when a vdisk is offline. 5. Do not use the trust command on a vdisk that went offline during vdisk expansion. 6. Do not use the trust command on a vdisk with status CRIT. Instead, add spares and let the system reconstruct the vdisk. The trust command must be used in CLI console mode. Steps for running the trust command 1. Disable background scrub of disks and vdisks to avoid running scrubs automatically. 2. Identify the cause for the vdisk going offline. 3. If an external issue (power, cabling, and so forth) caused the vdisk to go offline, fix the external issue before continuing to the next step. 4. Disable host access to the offline vdisk. In a single-controller configuration, disconnect the host-port cables. In a dual-controller configuration: a. Determine the owning controller of the offline vdisk. b. As a precautionary measure, remove the host-port cables of the owning controller of the offline vdisk. 340

  • 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

340
trust
Description
Enables an offline vdisk to be brought online for emergency data recovery. This command must be
enabled before each use. If used improperly this command can cause unstable operation and data
loss; before use, carefully read the cautions and procedures below.
The
trust
command provides an opportunity to recover data from a vdisk that has gone offline due
to disk failure. The command forces a resynchronization of the metadata (as well as time and date
stamps) that unifies members of a vdisk, and essentially puts the vdisk back into an accessible state.
As long as the failed disks are operable, data can be read from the disks and restored to another
location.
From examining the state of the disks, if the command determines that the trust operation is
unsafe—that it may result in an unstable vdisk with data corruption—the command will fail. You may
then seek assistance from technical support or run the command with a special parameter to
acknowledge the risk of proceeding. Otherwise, if the command determines the operation to be
safe, the command will proceed.
When the “trusted” vdisk is back online, back up its data and audit the data to make sure that it is
intact. Then delete that vdisk, create a new vdisk, and restore data from the backup to the new vdisk.
Using a trusted vdisk is only a disaster-recovery measure; the vdisk has no tolerance for any
additional failures.
The following procedure outlines the general steps for performing a trust operation, but the best
procedure to follow for your situation may vary from this procedure. Before starting this procedure,
consult the online troubleshooting guide at
to determine if the trust operation is applicable to your situation and for guidance to perform it.
CAUTION:
1.
Do not use the
trust
command when the storage system is unstable; for example, if there are
many power or topology-change events.
2.
The
trust
command cannot be run on a quarantined vdisk. In many cases the vdisk will be
automatically dequarantined. If you cannot resolve the issue that caused the disk to become
quarantined such that it is automatically dequarantined, and if the trust operation is applicable to
your situation, dequarantine the vdisk, confirm it is in offline state by using the
show vdisks
command, and then proceed to trust.
3.
Never update controller-module, expansion-module, or disk firmware when the vdisk is offline.
4.
Never clear unwritten data cache when a vdisk is offline.
5.
Do not use the
trust
command on a vdisk that went offline during vdisk expansion.
6.
Do not use the
trust
command on a vdisk with status
CRIT
. Instead, add spares and let the
system reconstruct the vdisk.
The
trust
command must be used in CLI console mode.
Steps for running the trust command
1.
Disable background scrub of disks and vdisks to avoid running scrubs automatically.
2.
Identify the cause for the vdisk going offline.
3.
If an external issue (power, cabling, and so forth) caused the vdisk to go offline, fix the external
issue before continuing to the next step.
4.
Disable host access to the offline vdisk. In a single-controller configuration, disconnect the
host-port cables. In a dual-controller configuration:
a.
Determine the owning controller of the offline vdisk.
b.
As a precautionary measure, remove the host-port cables of the owning controller of the
offline vdisk.