Dell PowerVault Owner's manual

Category
Software
Type
Owner's manual
Dell PowerVault MD 34XX/38XX Series
Storage Arrays
CLI Guide
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your computer.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you
how to avoid the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 2016 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual
property laws. Dell and the Dell logo are trademarks of Dell Inc. in the United States and/or other jurisdictions. All other
marks and names mentioned herein may be trademarks of their respective companies.
2016 - 07
Rev. A03
Contents
1 CLI Command Updates......................................................................................16
New Commands..................................................................................................................................16
Updated Commands........................................................................................................................... 16
2 About The Command Line Interface............................................................... 17
How To Use The Command Line Interface....................................................................................... 18
Usage Notes...................................................................................................................................18
CLI Commands..............................................................................................................................18
Command Line Parameters..........................................................................................................20
Formatting Considerations.................................................................................................................24
Detailed Error Reporting.....................................................................................................................24
Exit Status............................................................................................................................................ 25
Usage Examples.................................................................................................................................. 26
3 About The Script Commands........................................................................... 28
Script Command Structure.................................................................................................................29
Script Command Synopsis..................................................................................................................30
Recurring Syntax Elements................................................................................................................. 32
Usage Guidelines.................................................................................................................................38
Data Assurance (DA) Feature.............................................................................................................. 38
Adding Comments To A Script File.................................................................................................... 39
4 Configuring A Storage Array............................................................................ 40
Configuring A Storage Array...............................................................................................................40
Determining What Is On Your Storage Array................................................................................41
Saving A Configuration To A File.................................................................................................. 43
Using The Create Virtual Disk Command.................................................................................... 43
Using The Auto Configure Command......................................................................................... 46
Modifying Your Configuration............................................................................................................48
Setting The Storage Array Password............................................................................................ 48
Setting Up SMTP And SNMP Alerts...............................................................................................49
Setting The RAID Controller Module Clocks................................................................................49
Setting The Storage Array Host Type........................................................................................... 49
Setting Modification Priority......................................................................................................... 50
Assigning Global Hot Spares......................................................................................................... 51
Selecting The Event Levels For Alert Notifications.......................................................................51
Configuring Alert Notifications..................................................................................................... 52
3
5 Using The Snapshot Feature.............................................................................53
Before Using Snapshot CLI Commands.............................................................................................53
Snapshot Images And Groups............................................................................................................ 53
Snapshot Groups And Snapshot Consistency Groups...................................................................... 54
Snapshot Groups...........................................................................................................................54
Snapshot Consistency Groups..................................................................................................... 54
Understanding Snapshot Repositories............................................................................................... 55
Snapshot Consistency Group Repositories..................................................................................55
Consistency Groups And Remote Replication...................................................................................55
Creating Snapshot Images..................................................................................................................56
Creating A Snapshot Image.......................................................................................................... 56
Deleting A Snapshot Image...........................................................................................................56
Creating A Consistency Group Snapshot Virtual Disk................................................................. 57
Creating A Consistency Group Snapshot Image......................................................................... 58
Deleting A Snapshot Virtual Disk Or A Consistency Group Snapshot Virtual Disk.....................58
Deleting A Consistency Group Snapshot Image..........................................................................58
Scheduling Snapshot Images........................................................................................................59
Starting, Stopping And Resuming A Snapshot Rollback.............................................................. 59
Creating A Snapshot Group..........................................................................................................60
Deleting A Snapshot Group...........................................................................................................61
Reviving A Snapshot Group...........................................................................................................61
Creating A Consistency Group..................................................................................................... 61
Deleting A Consistency Group..................................................................................................... 62
Setting Consistency Group Attributes..........................................................................................62
Adding A Member Virtual Disk To A Consistency Group.............................................................63
Removing A Member Virtual Disk From A Consistency Group................................................... 63
Changing The Pre-read Consistency Check Setting Of An Overall Repository Virtual Disk..... 64
Setting Snapshot Virtual Disk Repository Virtual Disk Capacity.................................................. 65
Setting Snapshot Group Repository Virtual Disk Capacity.......................................................... 66
Reviving Disk Groups, Physical Disks, Snapshot Groups, And Snapshot Virtual Disks...............66
6 Using The Snapshot (Legacy) Feature............................................................ 68
Using Host Servers To Create An Initial Snapshot Virtual Disk......................................................... 69
Creating A Snapshot Virtual Disk........................................................................................................70
Enabling The Snapshot Virtual Disk Feature.................................................................................70
Creating A Snapshot Virtual Disk With User-Assigned Physical Disks.........................................70
Preparing Host Servers To Create An Initial Snapshot Virtual Disk..............................................71
Creating The Initial Snapshot Virtual Disk.....................................................................................71
Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks..................................72
Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks............................ 73
User-Defined Parameters............................................................................................................. 74
4
Names Of Snapshot Virtual Disks And Repository Virtual Disks..................................................76
Changing Snapshot Virtual Disk Settings........................................................................................... 76
Stopping And Deleting A Snapshot Virtual Disk................................................................................. 77
Re-creating The Snapshot Virtual Disk ........................................................................................ 77
Preparing Host Servers To Re-create A Snapshot Virtual Disk....................................................78
Re-creating A Snapshot Virtual Disk.............................................................................................78
7 Using The Virtual Disk Copy Feature...............................................................79
About Virtual Disk Copy...................................................................................................................... 79
Virtual Disk Copy Types...................................................................................................................... 79
Creating A Virtual Disk Copy...............................................................................................................81
Enabling The Virtual Disk Copy Feature....................................................................................... 81
Determining Virtual Disk Copy Candidates.................................................................................. 81
Creating A Virtual Disk Copy.........................................................................................................81
Preparing Host Servers To Create A Virtual Disk Copy................................................................82
Copying The Virtual Disk...............................................................................................................82
Viewing Virtual Disk Copy Properties.................................................................................................83
Changing Virtual Disk Copy Settings................................................................................................. 84
Recopying A Virtual Disk.....................................................................................................................85
Preparing Host Servers To Recopy A Virtual Disk........................................................................ 85
Recopying The Virtual Disk...........................................................................................................86
Stopping A Virtual Disk Copy..............................................................................................................86
Removing Copy Pairs..........................................................................................................................87
Interaction With Other Features.........................................................................................................87
About Snapshot (Legacy) Premium Features With Virtual Disk Copy...............................................87
8 Using The Remote Replication Premium Feature........................................88
How Remote Replication Works........................................................................................................ 88
Replication Pairs And Replication Repositories................................................................................. 89
Differences Between Remote Replication And Remote Replication (Legacy) Features..................89
Link Interruptions Or Secondary Virtual Disk Errors..........................................................................89
Resynchronization.............................................................................................................................. 90
Remote Replication Group................................................................................................................. 91
Previous Users Of Remote Replication (Legacy) Premium Feature.................................................. 91
Remote Replication Requirements And Restrictions.........................................................................91
Primary And Secondary Virtual Disks................................................................................................. 92
Setting Up Remote Replication.......................................................................................................... 92
Enabling The Remote Replication Premium Feature........................................................................ 92
Activating The Remote Replication Premium Feature...................................................................... 92
Creating A Remote Replication Group...............................................................................................92
Adding Primary Virtual Disk To Remote Replication Group..............................................................93
Changing Remote Replication Group Settings..................................................................................93
5
Adding Secondary Virtual Disk To Remote Replication Group.........................................................94
Suspending A Remote Replication Group......................................................................................... 94
Deleting A Remote Replication Group...............................................................................................95
Removing A Virtual Disk Or Repository Virtual Disk From A Remote Replication Group................95
Disabling The Remote Replication Premium Feature....................................................................... 96
Deactivating The Remote Replication Premium Feature..................................................................96
Interaction With Other Premium Features.........................................................................................96
Standard Remote Replication Commands........................................................................................ 96
9 Using The Remote Replication (Legacy) Premium Feature........................98
How Remote Replication (Legacy) Works......................................................................................... 98
Replication Repository Virtual Disks.............................................................................................99
Replication Relationships..............................................................................................................99
Data Replication..........................................................................................................................100
Link Interruptions Or Secondary Virtual Disk Errors...................................................................101
Resynchronization.......................................................................................................................101
Creating A Remote Replicated Pair..................................................................................................102
Performance Considerations......................................................................................................102
Enabling The Remote Replication (Legacy) Premium Feature..................................................103
Activating The Remote Replication (Legacy) Premium Feature................................................103
Determining Candidates For A Remote Replicated Pair............................................................105
Creating A Remote Replicated Pair............................................................................................ 105
Changing Remote Replication (Legacy) Settings............................................................................ 106
Suspending And Resuming A Replication Relationship...................................................................107
Removing A Replication Relationship.............................................................................................. 108
Deleting A Primary Virtual Disk Or A Secondary Virtual Disk.......................................................... 108
Disabling The Remote Replication (Legacy) Premium Feature.......................................................109
Deactivating The Remote Replication (Legacy) Premium Feature................................................. 109
Interaction With Other Premium Features.......................................................................................109
Snapshot Virtual Disks.................................................................................................................109
Virtual Disk Copy......................................................................................................................... 110
Storage Partitioning.....................................................................................................................110
Virtual Disk Expansion..................................................................................................................111
10 Maintaining A Storage Array.........................................................................112
Routine Maintenance.........................................................................................................................112
Running A Media Scan.................................................................................................................112
Running A Consistency Check With A Media Scan.................................................................... 113
Resetting A RAID Controller Module.......................................................................................... 114
Enabling RAID Controller Module Data Transfer........................................................................114
Resetting Battery Age.................................................................................................................. 114
Removing Persistent Reservations.............................................................................................. 115
6
Synchronizing RAID Controller Module Clocks......................................................................... 115
Locating Physical Disks................................................................................................................115
Performance Tuning..........................................................................................................................115
Monitoring Performance............................................................................................................. 115
Changing RAID Levels................................................................................................................. 116
Changing Segment Size.............................................................................................................. 116
Defragmenting A Disk Group...................................................................................................... 117
Using SSD Cache............................................................................................................................... 117
Enabling SSD Cache For A Virtual Disk........................................................................................117
Creating SSD Cache.................................................................................................................... 118
Adding Physical Disks To Existing SSD Cache............................................................................118
Removing Physical Disks From Existing SSD Cache.................................................................. 118
SSD Cache Performance Modeling............................................................................................ 118
Additional Information About SSD Cache And Performance Modeling....................................119
Troubleshooting and Diagnostics.....................................................................................................119
Collecting Physical Disk Data......................................................................................................119
Diagnosing A RAID Controller Module....................................................................................... 119
Recovery Operations........................................................................................................................ 120
Setting RAID Controller Module Operational Mode..................................................................120
Changing RAID Controller Module Ownership.......................................................................... 121
Initializing A Physical Disk............................................................................................................121
Reconstructing A Physical Disk...................................................................................................122
Initializing A Virtual Disk.............................................................................................................. 122
Redistributing Virtual Disks .........................................................................................................122
11 Script Commands........................................................................................... 123
Command Formatting Rules.............................................................................................................123
Firmware Compatibility Levels..........................................................................................................125
Commands Listed By Function.........................................................................................................125
Disk Group Commands...............................................................................................................125
Enclosure Commands.................................................................................................................126
Host Topology Commands........................................................................................................ 126
iSCSI Commands.........................................................................................................................127
Physical Disk Commands............................................................................................................ 127
RAID Controller Module Commands......................................................................................... 128
Remote Replication Commands................................................................................................ 129
Session Command...................................................................................................................... 130
Show String Command...............................................................................................................130
Snapshot Commands..................................................................................................................130
SSD Cache Commands...............................................................................................................130
Storage Array Commands........................................................................................................... 131
Virtual Disk Commands...............................................................................................................133
7
Virtual Disk Copy Commands.....................................................................................................133
12 Commands Listed Alphabetically................................................................134
Activate Remote Replication Feature...............................................................................................134
Activate Storage Array Firmware.......................................................................................................137
Add Member To Consistency Group................................................................................................137
Add Physical Disks To SSD Cache.................................................................................................... 139
Add Virtual Disk To Remote Replication Group.............................................................................. 140
Autoconfigure Storage Array............................................................................................................ 142
Set FIPS drive security identifier..................................................................................................144
Autoconfigure Storage Array Hot Spares......................................................................................... 145
Blink SSD Cache................................................................................................................................146
Cancel Remote Replication Group Role Reversal........................................................................... 146
Change SSD Cache Application Type.............................................................................................. 147
Check Remote Replication Status.................................................................................................... 147
Check Remote Replication Group Consistency..............................................................................148
Check Repository Consistency........................................................................................................ 149
Check Storage Array Connectivity................................................................................................... 150
Check Virtual Disk Consistency........................................................................................................ 151
Clear Physical Disk Port Statistics.....................................................................................................152
Clear Remote Replication Fault........................................................................................................ 152
Clear Storage Array Configuration................................................................................................... 154
Set Storage Array Controller Health Image......................................................................................154
Clear Storage Array Event Log..........................................................................................................155
Clear Storage Array Firmware Pending Area....................................................................................155
Clear Storage Array Recovery Mode................................................................................................ 156
Clear Virtual Disk Reservations......................................................................................................... 156
Clear Virtual Disk Unreadable Sectors..............................................................................................157
Configure Automatic Support Bundle Collection............................................................................157
Convert Snapshot (Legacy) Virtual Disk To Snapshot Group..........................................................158
Create Consistency Group............................................................................................................... 158
Create Consistency Group Snapshot Image....................................................................................161
Create Consistency Group Snapshot Virtual Disk............................................................................161
Create Consistency Group Snapshot Virtual Disk Mapping............................................................163
Create Disk Group.............................................................................................................................164
Create Disk Pool................................................................................................................................168
Create Host........................................................................................................................................172
Create Host Group............................................................................................................................ 173
Create Host Port................................................................................................................................173
Create iSCSI Initiator......................................................................................................................... 174
Create RAID Virtual Disk (Automatic Physical Disk Select).............................................................. 175
Create RAID Virtual Disk (Free Extent Base Select).......................................................................... 177
8
Create RAID Virtual Disk (Manual Physical Disk Select)...................................................................180
Create RAID Virtual Disk On A Disk Pool......................................................................................... 184
Create Read-Only Snapshot Virtual Disk......................................................................................... 186
Create Remote Replication.............................................................................................................. 188
Create Remote Replication Group...................................................................................................190
Create Snapshot Group.................................................................................................................... 192
Create Snapshot Image.....................................................................................................................195
Create Snapshot (Legacy) Virtual Disk............................................................................................. 196
Create Snapshot Virtual Disk............................................................................................................202
Create SSD Cache............................................................................................................................ 203
Create Storage Array Security Key................................................................................................... 205
Create Virtual Disk Copy.................................................................................................................. 206
Deactivate Remote Replication (Legacy).........................................................................................208
Delete Consistency Group...............................................................................................................209
Delete Consistency Group Snapshot Image................................................................................... 209
Delete Consistency Group Snapshot Virtual Disk............................................................................210
Delete Disk Group............................................................................................................................. 211
Delete Disk Pool................................................................................................................................ 211
Delete Host........................................................................................................................................212
Delete Host Group............................................................................................................................ 212
Delete Host Port................................................................................................................................213
Delete iSCSI Initiator......................................................................................................................... 214
Delete Snapshot Group.....................................................................................................................214
Delete Snapshot Image.....................................................................................................................215
Delete Snapshot (Legacy) Virtual Disk.............................................................................................. 217
Delete Snapshot Virtual Disk.............................................................................................................217
Delete Snapshot Virtual Disk or Delete Snapshot Virtual Disk Schedule........................................218
Delete SSD Cache............................................................................................................................. 219
Delete Virtual Disk.............................................................................................................................219
Delete Virtual Disk On A Disk Pool...................................................................................................220
Diagnose RAID Controller Module................................................................................................... 221
Diagnose RAID Controller Module iSCSI Host Cable......................................................................222
Diagnose Remote Replication..........................................................................................................224
Disable Storage Array Feature.......................................................................................................... 224
Display Automatic Support Bundle Collection Configuration........................................................226
Display Support Bundle Collection Schedule..................................................................................226
Download Enclosure Management Module Firmware....................................................................227
Download Physical Disk Firmware................................................................................................... 227
Download Storage Array Firmware/NVSRAM..................................................................................228
Download Storage Array Physical Disk Firmware............................................................................229
Download Storage Array NVSRAM...................................................................................................230
Enable Disk Group Security.............................................................................................................. 231
9
Enable Disk Pool Security................................................................................................................. 232
Enable or Disable ODX..................................................................................................................... 232
Enable Or Disable SSD Cache For A Virtual Disk............................................................................. 233
Enable or Disable VAAI......................................................................................................................233
Enable RAID Controller Module Data Transfer................................................................................234
Enable Storage Array Feature........................................................................................................... 234
Establish Remote Replicated Pair.....................................................................................................235
Increase Virtual Disk Capacity On A Disk Pool................................................................................ 236
Load Storage Array DBM Database.................................................................................................. 237
Modify Disk Pool............................................................................................................................... 239
Recopy Virtual Disk Copy................................................................................................................. 239
Recover disabled drive ports............................................................................................................ 241
Recover RAID Virtual Disk.................................................................................................................241
Re-Create Remote Replication Repository Virtual Disk..................................................................245
Re-Create Snapshot......................................................................................................................... 248
Reduce Disk Pool Capacity.............................................................................................................. 250
Register SNMP Community.............................................................................................................. 251
Register SNMP Trap Destination.......................................................................................................251
Reinitialize Thin Virtual Disk..............................................................................................................252
Remove Incomplete Remote Replicated Pair From Remote Replication Group...........................253
Remove Member Virtual Disk From Consistency Group................................................................ 254
Remove Physical Disks From SSD Cache........................................................................................ 254
Remove Remote Replication............................................................................................................255
Remove Virtual Disk Copy................................................................................................................256
Remove Virtual Disk From Remote Replication Group...................................................................256
Remove Virtual Disk LUN Mapping.................................................................................................. 257
Rename A Snapshot Virtual Disk...................................................................................................... 258
Rename SSD Cache..........................................................................................................................258
Repair Virtual Disk Consistency........................................................................................................259
Replace Physical Disk....................................................................................................................... 260
Reset iSCSI IP Address.......................................................................................................................261
Reset Physical Disk........................................................................................................................... 262
Reset RAID Controller Module......................................................................................................... 263
Reset Remote Replication Group Statistics.....................................................................................264
Reset Storage Array Battery Install Date.......................................................................................... 265
Reset Storage Array iSCSI Baseline.................................................................................................. 266
Reset Storage Array SAS PHY Baseline.............................................................................................266
Reset Storage Array Virtual Disk Distribution...................................................................................267
Resume Consistency Group Snapshot Virtual Disk.........................................................................267
Resume Remote Replication............................................................................................................268
Resume Remote Replication Group................................................................................................ 269
Resume Snapshot Image Rollback...................................................................................................270
10
Resume Snapshot (Legacy) Rollback................................................................................................271
Resume Snapshot Virtual Disk.......................................................................................................... 271
Resume SSD Cache...........................................................................................................................273
Revive Disk Group.............................................................................................................................273
Revive Disk Pool................................................................................................................................274
Revive Physical Disk.......................................................................................................................... 274
Revive Snapshot Group.....................................................................................................................275
Revive Snapshot Virtual Disk.............................................................................................................275
Save Enclosure Log Data.................................................................................................................. 276
Save Input Output RAID Controller Module (IOC) Dump............................................................... 276
Save Physical Disk Log...................................................................................................................... 277
Save RAID Controller Module NVSRAM............................................................................................277
Save Remote Replication Group Statistics.......................................................................................278
Save Storage Array Configuration....................................................................................................280
Save Storage Array Controller Health Image................................................................................... 281
Save Storage Array DBM Database...................................................................................................281
Save Storage Array DBM Validator Information File........................................................................ 283
Save Storage Array Events................................................................................................................ 284
Save Storage Array iSCSI Statistics................................................................................................... 285
Save Storage Array Performance Statistics......................................................................................286
Save Storage Array SAS PHY Counts................................................................................................286
Save Storage Array State Capture.....................................................................................................287
Save Storage Array Support Data..................................................................................................... 287
Schedule Support Bundle Collection Configuration...................................................................... 288
Scheduling Snapshots...................................................................................................................... 289
Set Consistency Group Attributes....................................................................................................290
Set Consistency Group Snapshot Virtual Disk................................................................................. 291
Set Disk Group ................................................................................................................................. 292
Set Disk Group Forced State............................................................................................................ 294
Set Disk Pool..................................................................................................................................... 294
Set Disk Pool Complete....................................................................................................................295
Set Enclosure Attribute.....................................................................................................................296
Set Enclosure Identification............................................................................................................. 296
Set Event Alert Filtering.....................................................................................................................297
Set FIPS physical disk security identifier.......................................................................................... 298
Set Foreign Physical Disk to Native..................................................................................................299
Set Host.............................................................................................................................................300
Set Host Channel.............................................................................................................................. 301
Set Host Group................................................................................................................................. 302
Set Host Port.....................................................................................................................................302
Set iSCSI Initiator...............................................................................................................................303
Set iSCSI Target Properties...............................................................................................................304
11
Set Physical Disk Channel Status..................................................................................................... 304
Set Physical Disk Hot Spare..............................................................................................................305
Set Physical Disk State......................................................................................................................306
Set RAID Controller Module.............................................................................................................306
Set RAID controller NTP settings......................................................................................................310
Set Read-Only Snapshot Virtual Disk To A Read/Write Virtual Disk................................................ 311
Set Remote Replication.....................................................................................................................312
Set Remote Replication Group.........................................................................................................314
Set Session.........................................................................................................................................318
Set Snapshot Group Attributes......................................................................................................... 319
Set Snapshot Group Media Scan......................................................................................................320
Set Snapshot Group Repository Virtual Disk Capacity.....................................................................321
Set Snapshot Group Schedule..........................................................................................................321
Set Snapshot (Legacy) Virtual Disk................................................................................................... 322
Set Snapshot Virtual Disk Media Scan..............................................................................................326
Set Snapshot Virtual Disk Repository Virtual Disk Capacity............................................................ 327
Set Storage Array...............................................................................................................................327
Set Storage Array Enclosure Positions.............................................................................................330
Set Storage Array ICMP Response....................................................................................................331
Set Storage Array iSNS Server IPv4 Address.....................................................................................332
Set Storage Array iSNS Server IPv6 Address.....................................................................................332
Set Storage Array iSNS Server Listening Port...................................................................................333
Set Storage Array Learn Cycle..........................................................................................................333
Set Storage Array Consistency Mode...............................................................................................334
Set Storage Array Security Key......................................................................................................... 334
Set Storage Array Time..................................................................................................................... 335
Set Storage Array Unnamed Discovery Session...............................................................................335
Set Thin Virtual Disk Attributes......................................................................................................... 336
Set Virtual Disk...................................................................................................................................337
Set Virtual Disk Attributes For A Disk Pool........................................................................................341
Set Virtual Disk Copy........................................................................................................................ 346
Set Virtual Disk Mapping................................................................................................................... 347
Show Blocked Events....................................................................................................................... 349
Show Consistency Group Snapshot Image.....................................................................................349
Show Current iSCSI Sessions........................................................................................................... 350
Show Disk Group...............................................................................................................................351
Show Disk Group Export Dependencies..........................................................................................352
Show Disk Group Import Dependencies......................................................................................... 352
Show Disk Pool................................................................................................................................. 353
Show Host Ports............................................................................................................................... 353
Show Physical Disk........................................................................................................................... 354
Show Physical Disk Channel Statistics.............................................................................................356
12
Show Physical Disk Download Progress..........................................................................................356
Show RAID Controller Module......................................................................................................... 357
Show RAID Controller Module NVSRAM......................................................................................... 358
Show Remote Replication Group.................................................................................................... 358
Show Remote Replication Group Synchronization Progress......................................................... 359
Show Remote Replication Virtual Disk Candidates.........................................................................360
Show Remote Replication Virtual Disk Synchronization Progress..................................................361
Show SNMP Communities................................................................................................................361
Show SNMP MIB II System Group Variables....................................................................................363
Show Snapshot Group......................................................................................................................363
Show Snapshot Image......................................................................................................................365
Show Snapshot Virtual Disks............................................................................................................366
Show SSD Cache...............................................................................................................................367
Show SSD Cache Statistics...............................................................................................................368
Show Storage Array...........................................................................................................................372
Show Storage Array Auto Configure................................................................................................ 374
Show Storage Array Controller Health Image................................................................................. 376
Show Storage Array DBM Database................................................................................................. 376
Show Storage Array Host Topology.................................................................................................376
Show Storage Array LUN Mappings..................................................................................................377
Show Storage Array Negotiation Defaults....................................................................................... 378
Show Storage Array ODX Setting..................................................................................................... 378
Show Storage Array Power Information.......................................................................................... 379
Show Storage Array Unconfigured iSCSI Initiators..........................................................................379
Show Storage Array Unreadable Sectors.........................................................................................380
Show String.......................................................................................................................................380
Show Thin Virtual Disk...................................................................................................................... 381
Show Virtual Disk.............................................................................................................................. 382
Show Virtual Disk Action Progress................................................................................................... 383
Show Virtual Disk Copy.................................................................................................................... 384
Show Virtual Disk Copy Source Candidates.................................................................................... 385
Show Virtual Disk Copy Target Candidates..................................................................................... 385
Show Virtual Disk Performance Statistics........................................................................................386
Show Virtual Disk Reservations........................................................................................................ 386
Start Configuration Database Diagnostic.........................................................................................387
Start Consistency Group Snapshot Rollback...................................................................................387
Start Disk Group Blink.......................................................................................................................389
Start Disk Group Defragment...........................................................................................................389
Start Disk Group Export....................................................................................................................389
Start Disk Group Import................................................................................................................... 390
Start Disk Pool Locate.......................................................................................................................391
Start Enclosure Blink......................................................................................................................... 391
13
Start Input Output RAID Controller Module (IOC) Dump............................................................... 392
Start iSCSI DHCP Refresh................................................................................................................. 392
Start Physical Disk Blink.................................................................................................................... 393
Start Physical Disk Channel Blink..................................................................................................... 393
Start Physical Disk Initialize.............................................................................................................. 394
Start Physical Disk Reconstruction.................................................................................................. 394
Start Remote Replication Synchronization......................................................................................395
Start Remote Replication (Legacy) Synchronization.......................................................................395
Start SED Secure Physical Disk Erase...............................................................................................396
Start Snapshot Rollback....................................................................................................................396
Start Snapshot Image Rollback.........................................................................................................397
Start SSD Cache Performance Modeling.........................................................................................398
Start Storage Array Blink...................................................................................................................399
Start Storage Array Configuration Database Diagnostic.................................................................399
Start Storage Array iSCSI Refresh..................................................................................................... 401
Start Virtual Disk Initialization........................................................................................................... 401
Stop Configuration Database Diagnostic........................................................................................ 402
Stop Consistency Group Snapshot Rollback...................................................................................402
Stop Consistency Group Snapshot Virtual Disk.............................................................................. 403
Stop Disk Group Blink...................................................................................................................... 404
Stop Disk Pool Locate...................................................................................................................... 404
Stop Enclosure Blink.........................................................................................................................404
Stop Pending Snapshot Images On Consistency Group................................................................ 405
Stop Physical Disk Blink....................................................................................................................405
Stop Physical Disk Channel Blink.....................................................................................................405
Stop Physical Disk Replace.............................................................................................................. 406
Stop Snapshot Group Image............................................................................................................407
Stop Snapshot Group Pending Snapshot Images........................................................................... 407
Stop Snapshot (Legacy)....................................................................................................................408
Stop Snapshot (Legacy) Rollback.....................................................................................................409
Stop Snapshot Rollback....................................................................................................................410
Stop Snapshot Image Rollback.........................................................................................................410
Stop Snapshot Virtual Disk................................................................................................................ 411
Stop SSD Cache Performance Modeling......................................................................................... 412
Stop Storage Array Blink................................................................................................................... 414
Stop Storage Array Configuration Database Diagnostic................................................................. 414
Stop Storage Array iSCSI Session......................................................................................................415
Stop Storage Array Physical Disk Firmware Download................................................................... 415
Stop Virtual Disk Copy...................................................................................................................... 415
Suspend Remote Replication........................................................................................................... 416
Suspend Remote Replication Group................................................................................................ 417
Suspend SSD Cache.......................................................................................................................... 417
14
Test Remote Replication Group Connectivity.................................................................................418
Test SNMP Trap Destination.............................................................................................................419
Unregister SNMP Community..........................................................................................................420
Unregister SNMP Trap Destination.................................................................................................. 420
Update SNMP Community...............................................................................................................420
Update SNMP MIB II System Group Variables..................................................................................421
Update SNMP Trap Destination........................................................................................................422
Validate Storage Array Security Key................................................................................................. 422
13 Sample Script Files......................................................................................... 424
Configuration Script Example 1........................................................................................................424
Configuration Script Example 2....................................................................................................... 426
15
1
CLI Command Updates
This chapter reflects new and updated commands that are available for use with the Dell PowerVault MD
34XX/38XX Series storage arrays.
NOTE: Not all commands are valid with all storage arrays. Some commands are specific to certain
platforms.
CAUTION: Script commands are capable of changing the configuration and may cause loss of
data if not used correctly. Command operations are performed as soon as you run the
commands. Before using the script commands, ensure that you have backed up all data, and have
saved the current configuration so that you can reinstall it if the changes do not work.
New Commands
The following command is added to this guide to reflect the additional functionality available in the
PowerVault MD34XX and MD38XX.
• UNMAP
Updated Commands
The syntax of the following commands has been modified, updated, or enhanced since the last release of
this document.
NOTE: Not all commands are valid with all storage arrays. Some commands are specific to certain
platforms.
• Set Thin Virtual Disk Attributes
• Set Virtual Disk
16
2
About The Command Line Interface
This guide is intended for system administrators, developers, and engineers who need to use the
command line interface (CLI) tool and its associated commands and script files. Selected CLI commands
perform functions that can also be accessed from the Modular Disk (MD) Storage Manager, which is the
graphical user interface (GUI) to the storage array. See the Administrator's Guide, which describes the
Storage Manager software that is used to create and manage multiple storage arrays. For additional
information, see the hardware and software manuals that shipped with your system.
NOTE: Always check for updates on dell.com/support and read the updates first because they often
supersede information in other documents.
NOTE: CLI commands do not have interactive warnings for destructive commands.
CLI is a software tool that enables storage array installers, developers, and engineers to configure and
monitor storage arrays. Using the command line interface, you can issue commands from an operating
system prompt, such as the Microsoft Windows command prompt (C:\) or a Linux operating system
terminal.
Each command performs a specific action for managing a storage array or returning information about
the status of a storage array. You can enter individual commands, or run script files when you need to
perform operations more than once (such as installing the same configuration on several storage arrays).
A script file can be loaded and run from the command line interface. You can also run commands in an
interactive mode. Interactive mode enables you to connect to a specific storage array and rapidly enter a
command, determine the effect on the storage array, and then enter a new command.
The command line interface gives you direct access to a script engine utility in the Dell PowerVault
Modular Disk Storage Manager software (MD Storage Manager). The script engine reads the commands,
or runs a script file, from the command line and performs the operations instructed by the commands.
You can use the command line interface to perform the following functions:
• Directly access the script engine and run commands in interactive mode or using a script file.
• Create script command batch files to be run on multiple storage arrays when you need to install the
same configuration on different storage arrays.
• Run script commands on a storage array directly connected to a host, a storage array connected to a
host by an Ethernet, or a combination of both.
• Display configuration information about the storage arrays.
• Add storage arrays to and remove storage arrays from the management domain.
• Perform automatic discovery of all storage arrays attached to the local subnet.
• Add or delete Simple Network Management Protocol (SNMP) trap destinations and e-mail alert
notifications.
• Specify the mail server and sender e-mail address or Simple Mail Transport Protocol (SMTP) server for
alert notifications.
• Direct the output to a standard command line display or to a named file.
17
How To Use The Command Line Interface
Using the CLI commands, you can access the script engine, specify which storage array receives the
script commands, and set operation environment parameters.
A CLI command consists of the following elements:
• The term SMcli
• Storage array identifier
• Parameters
• Script commands
The following syntax is the general form of a CLI command:
SMcli storageArray parameters script-commands;
where,
SMcli invokes the command line interface.
storageArray is the host name or IP address of the storage array.
parameters are the CLI parameters that define the environment and purpose of the command.
script-commands are the commands or name of the script file containing the script commands.
The script commands are the storage array configuration commands. About The Script Commands
presents an overview of the script commands. Script commands provide definitions, syntax, and
parameters for the script commands.
Usage Notes
If you enter SMcli and a storage array name but do not specify CLI parameters, script commands, or a
script file, the command line interface runs in interactive mode. Interactive mode enables you to run
individual commands without prefixing the commands with SMcli. You can enter a single command, view
the results, and enter the next command without typing the complete SMcli string. Interactive mode is
useful for determining configuration errors and quickly testing configuration changes.
If you enter SMcli without any parameters or with an incorrect parameter, the script engine returns usage
information.
NOTE: The SMcli command is installed under the client directory of the selected path during a
management station install of the MD Storage Manager software.
NOTE: The SMcli command should be a component of the system environment command path.
CLI Commands
This section lists the CLI commands you can use to perform the following functions:
• Identify storage arrays
18
• Set passwords
• Add storage arrays
• Specify communication parameters
• Enter individual script configuration commands
• Specify a file containing script configuration commands
The following are general forms of the CLI commands, showing the parameters and terminals used in
each command. The table below lists definitions for the parameters shown in the CLI commands.
Table 1. Command Name Conventions
Parameter Definition
a|b
pipe symbol indicating alternative ("a" or "b")
italicized-words terminals
[...] (square brackets) zero or one occurrence
{...} (curly brackets) zero or more occurrences
(a|b|c)
choose only one of the alternatives
bold terminals
SMcli host-name-or-IP-address [host-name-or-IPaddress]
[-c "
command; {command2};"]
[-n storage-array-name | -w WWID]
[-o outputfile][-p password][-e][-S]
SMcli host-name-or-IP-address
[host-name-or-IP-address] [-f scriptfile]
[-n storage-array-name | -w WWID]
[-o
outputfile] [-p password] [-e] [-S]
SMcli (-n storage-array-name | -w WWID)
[-c "command; {command2};"]
[-o outputfile][-p password][-e][-S]
SMcli (-n storage-array-name | -w WWID)
[-f scriptfile]
[-o outputfile] [-p password] [-e] [-S]
SMcli (-n storage-array-name | -w WWID)
[-o
outputfile][-p password][-e][-S]
SMcli -a email:email-address
[host-name-or-IP-address1
[host-name-or-IP-address2]]
[-n storage-array-name | -w WWID | -h host-name |
-r (host_sa | direct_sa)]
[-I
information-to-include][-q frequency][-S]
SMcli -x email:email-address
[host-name-or-IP-address1
[host-name-or-IP-address2]]
[-n storage-array-name | -w WWID | -h host-name |
-r (host_sa | direct_sa)] [-S]
SMcli (-a | -x) trap:community,
host-name-or-IP-address [host-name-or-IP-address1
[host-name-or-IP-address2]]
19
[-n storage-array-name | -w WWID | -h host-name |
-r (host_sa | direct_sa)] [-S]
SMcli -d [-w][-i][-s][-v][-S]
SMcli -m host-name-or-IP-address -F email-address
[-g contactInfoFile][-S]
SMcli -A [host-name-or-IP-address
[host-name-or-IP-address]] [-S]
SMcli -X (-n storage-array-name | -w WWID |
-h host-name)
SMcli -?
Command Line Parameters
Table 2. Command Line Parameters
Parameter Definition
host‑name-or-IP-address
Specify either the host name or the Internet
Protocol (IP) address of an in-band managed
storage array (IPv4 or IPv6) or an out-of-band
managed storage array (IPv4 or IPv6).
• If you manage a storage array by using a host
connected directly to the storage array (in‑band
storage management), you must use the -n
parameter if more than one storage array is
connected to the host.
• If you manage a storage array through an
Ethernet connection (out-of-band storage
management), you must specify the
host‑name‑or‑IP‑address of the redundant array
of independent disks (RAID) controller modules.
• If you have previously configured a storage
array in the graphical user interface (GUI) of the
MD Storage Manager, you can specify the
storage array by its user‑supplied name by
using the -n parameter.
-A
Use to add a storage array to the configuration
files. If you do not follow the -A parameter with a
host‑name‑or‑IP‑address, automatic discovery
scans the local subnet for storage arrays.
-a
Use to add an SNMP trap destination or an e-mail
address alert destination.
• When adding an SNMP trap destination, the
SNMP community is automatically defined as
the community name for the trap and the host
is the IP address or Domain Name Server (DNS)
host name of the system to which the trap
should be sent.
• When adding an e-mail address for an alert
destination, the email-address is the e-mail
address to which to send the alert message.
20
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203
  • Page 204 204
  • Page 205 205
  • Page 206 206
  • Page 207 207
  • Page 208 208
  • Page 209 209
  • Page 210 210
  • Page 211 211
  • Page 212 212
  • Page 213 213
  • Page 214 214
  • Page 215 215
  • Page 216 216
  • Page 217 217
  • Page 218 218
  • Page 219 219
  • Page 220 220
  • Page 221 221
  • Page 222 222
  • Page 223 223
  • Page 224 224
  • Page 225 225
  • Page 226 226
  • Page 227 227
  • Page 228 228
  • Page 229 229
  • Page 230 230
  • Page 231 231
  • Page 232 232
  • Page 233 233
  • Page 234 234
  • Page 235 235
  • Page 236 236
  • Page 237 237
  • Page 238 238
  • Page 239 239
  • Page 240 240
  • Page 241 241
  • Page 242 242
  • Page 243 243
  • Page 244 244
  • Page 245 245
  • Page 246 246
  • Page 247 247
  • Page 248 248
  • Page 249 249
  • Page 250 250
  • Page 251 251
  • Page 252 252
  • Page 253 253
  • Page 254 254
  • Page 255 255
  • Page 256 256
  • Page 257 257
  • Page 258 258
  • Page 259 259
  • Page 260 260
  • Page 261 261
  • Page 262 262
  • Page 263 263
  • Page 264 264
  • Page 265 265
  • Page 266 266
  • Page 267 267
  • Page 268 268
  • Page 269 269
  • Page 270 270
  • Page 271 271
  • Page 272 272
  • Page 273 273
  • Page 274 274
  • Page 275 275
  • Page 276 276
  • Page 277 277
  • Page 278 278
  • Page 279 279
  • Page 280 280
  • Page 281 281
  • Page 282 282
  • Page 283 283
  • Page 284 284
  • Page 285 285
  • Page 286 286
  • Page 287 287
  • Page 288 288
  • Page 289 289
  • Page 290 290
  • Page 291 291
  • Page 292 292
  • Page 293 293
  • Page 294 294
  • Page 295 295
  • Page 296 296
  • Page 297 297
  • Page 298 298
  • Page 299 299
  • Page 300 300
  • Page 301 301
  • Page 302 302
  • Page 303 303
  • Page 304 304
  • Page 305 305
  • Page 306 306
  • Page 307 307
  • Page 308 308
  • Page 309 309
  • Page 310 310
  • Page 311 311
  • Page 312 312
  • Page 313 313
  • Page 314 314
  • Page 315 315
  • Page 316 316
  • Page 317 317
  • Page 318 318
  • Page 319 319
  • Page 320 320
  • Page 321 321
  • Page 322 322
  • Page 323 323
  • Page 324 324
  • Page 325 325
  • Page 326 326
  • Page 327 327
  • Page 328 328
  • Page 329 329
  • Page 330 330
  • Page 331 331
  • Page 332 332
  • Page 333 333
  • Page 334 334
  • Page 335 335
  • Page 336 336
  • Page 337 337
  • Page 338 338
  • Page 339 339
  • Page 340 340
  • Page 341 341
  • Page 342 342
  • Page 343 343
  • Page 344 344
  • Page 345 345
  • Page 346 346
  • Page 347 347
  • Page 348 348
  • Page 349 349
  • Page 350 350
  • Page 351 351
  • Page 352 352
  • Page 353 353
  • Page 354 354
  • Page 355 355
  • Page 356 356
  • Page 357 357
  • Page 358 358
  • Page 359 359
  • Page 360 360
  • Page 361 361
  • Page 362 362
  • Page 363 363
  • Page 364 364
  • Page 365 365
  • Page 366 366
  • Page 367 367
  • Page 368 368
  • Page 369 369
  • Page 370 370
  • Page 371 371
  • Page 372 372
  • Page 373 373
  • Page 374 374
  • Page 375 375
  • Page 376 376
  • Page 377 377
  • Page 378 378
  • Page 379 379
  • Page 380 380
  • Page 381 381
  • Page 382 382
  • Page 383 383
  • Page 384 384
  • Page 385 385
  • Page 386 386
  • Page 387 387
  • Page 388 388
  • Page 389 389
  • Page 390 390
  • Page 391 391
  • Page 392 392
  • Page 393 393
  • Page 394 394
  • Page 395 395
  • Page 396 396
  • Page 397 397
  • Page 398 398
  • Page 399 399
  • Page 400 400
  • Page 401 401
  • Page 402 402
  • Page 403 403
  • Page 404 404
  • Page 405 405
  • Page 406 406
  • Page 407 407
  • Page 408 408
  • Page 409 409
  • Page 410 410
  • Page 411 411
  • Page 412 412
  • Page 413 413
  • Page 414 414
  • Page 415 415
  • Page 416 416
  • Page 417 417
  • Page 418 418
  • Page 419 419
  • Page 420 420
  • Page 421 421
  • Page 422 422
  • Page 423 423
  • Page 424 424
  • Page 425 425
  • Page 426 426

Dell PowerVault Owner's manual

Category
Software
Type
Owner's manual

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI