Dell PowerVault MD3620f User manual

Dell PowerVault Modular Disk
Storage Arrays
CLI Guide
book.book Page 1 Wednesday, June 8, 2011 12:20 PM

Notes and Cautions
NOTE: A NOTE indicates important information that helps you make better use of
your computer.
CAUTION: A CAUTION indicates potential damage to hardware or loss of data if
instructions are not followed.
____________________
Information in this publication is subject to change without notice.
© 2010–2011 Dell Inc. All rights reserved.
Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc.
is strictly forbidden.
Trademarks used in this text: Dell™, the DELL logo, and PowerVault™ are trademarks of Dell Inc.
Microsoft®, MS-DOS®, Internet Explorer®, Windows®, and Windows Server®are either trademarks
or registered trademarks of Microsoft Corporation in the United States and/or other countries.
Other trademarks and trade names may be used in this publication to refer to either the entities claiming
the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and
trade names other than its own.
2011 - 06 Rev. A02
book.book Page 2 Wednesday, June 8, 2011 12:20 PM

Contents 3
Contents
1 About the Command Line Interface. . . . . 15
How to Use the Command Line Interface . . . . . . . . 16
Usage Notes . . . . . . . . . . . . . . . . . . . . 17
CLI Commands . . . . . . . . . . . . . . . . . . . 18
Command Line Parameters. . . . . . . . . . . . . 20
Formatting Considerations . . . . . . . . . . . . . . . 26
Detailed Error Reporting. . . . . . . . . . . . . . . . . 26
Exit Status . . . . . . . . . . . . . . . . . . . . . . . . 27
Usage Examples . . . . . . . . . . . . . . . . . . . . . 29
2 About the Script Commands . . . . . . . . . . 31
Script Command Structure . . . . . . . . . . . . . . . 32
Script Command Synopsis. . . . . . . . . . . . . . . . 34
Recurring Syntax Elements . . . . . . . . . . . . . . . 36
Usage Guidelines . . . . . . . . . . . . . . . . . . . . 42
Adding Comments to a Script File . . . . . . . . . . . . 43
3 Configuring a Storage Array . . . . . . . . . . 45
Configuring a Storage Array. . . . . . . . . . . . . . . 46
book.book Page 3 Wednesday, June 8, 2011 12:20 PM

4Contents
Determining What is on Your Storage Array . . . . 46
Saving a Configuration to a File. . . . . . . . . . . 49
Using the Create Virtual Disk Command . . . . . . 50
Using the Auto Configure Command . . . . . . . . 54
Modifying Your Configuration . . . . . . . . . . . . . . 57
Setting the Storage Array Password . . . . . . . . 58
Setting Up SMTP and SNMP Alerts . . . . . . . . 58
Setting the RAID Controller Module Clocks . . . . 59
Setting the Storage Array Host Type . . . . . . . . 59
Setting Modification Priority . . . . . . . . . . . . 60
Assigning Global Hot Spares . . . . . . . . . . . . 61
4 Using the Snapshot Feature . . . . . . . . . 63
Using Host Servers to Create an Initial
Snapshot Virtual Disk . . . . . . . . . . . . . . . . . . 65
Creating a Snapshot Virtual Disk . . . . . . . . . . . . 66
Enabling the Snapshot Virtual Disk Feature . . . . 67
Creating a Snapshot Virtual Disk with
User-Assigned Physical Disks . . . . . . . . . . . 67
Preparing Host Servers to Create an
Initial Snapshot Virtual Disk . . . . . . . . . . . . 67
Creating the Initial Snapshot Virtual Disk. . . . . . 68
Creating a Snapshot Virtual Disk
with Software-Assigned Physical Disks . . . . . . 70
Creating a Snapshot Virtual Disk by
Specifying a Number of Physical Disks. . . . . . . 71
User-Defined Parameters. . . . . . . . . . . . . . 72
Names of Snapshot Virtual Disks and
Repository Virtual Disks. . . . . . . . . . . . . . . 74
Changing Snapshot Virtual Disk Settings . . . . . . . . 75
Stopping and Deleting a Snapshot Virtual Disk . . . . . 76
book.book Page 4 Wednesday, June 8, 2011 12:20 PM

Contents 5
Re-creating the Snapshot Virtual Disk . . . . . . . 77
Preparing Host Servers to Re-create a
Snapshot Virtual Disk. . . . . . . . . . . . . . . . 77
Re-creating a Snapshot Virtual Disk . . . . . . . . 78
5 Using the Virtual Disk Copy Feature . . . . 79
Creating a Virtual Disk Copy. . . . . . . . . . . . . . . 80
Enabling the Virtual Disk Copy Feature. . . . . . . 81
Determining Virtual Disk Copy Candidates . . . . . 81
Creating a Virtual Disk Copy . . . . . . . . . . . . 82
Preparing Host Servers to Create a
Virtual Disk Copy . . . . . . . . . . . . . . . . . . 82
Copying the Virtual Disk . . . . . . . . . . . . . . 83
Viewing Virtual Disk Copy Properties. . . . . . . . . . 84
Changing Virtual Disk Copy Settings . . . . . . . . . . 85
Recopying a Virtual Disk . . . . . . . . . . . . . . . . 87
Preparing Host Servers to Recopy
a Virtual Disk . . . . . . . . . . . . . . . . . . . . 87
Recopying the Virtual Disk . . . . . . . . . . . . . 88
Stopping a Virtual Disk Copy . . . . . . . . . . . . . . 89
Removing Copy Pairs . . . . . . . . . . . . . . . . . . 90
Interaction With Other Features. . . . . . . . . . . . . 90
Storage Partitioning . . . . . . . . . . . . . . . . 91
Snapshot Virtual Disks . . . . . . . . . . . . . . . 91
6 Using the Remote Replication
Premium Feature . . . . . . . . . . . . . . . . . . . 93
How Remote Replication Works . . . . . . . . . . . . 94
book.book Page 5 Wednesday, June 8, 2011 12:20 PM

6Contents
Replication Repository Virtual Disks . . . . . . . . 94
Replication Relationships . . . . . . . . . . . . . . 95
Data Replication . . . . . . . . . . . . . . . . . . 95
Link Interruptions or Secondary
Virtual Disk Errors. . . . . . . . . . . . . . . . . . 97
Resynchronization . . . . . . . . . . . . . . . . . 98
Creating a Remote Replicated Pair . . . . . . . . . . . 99
Performance Considerations . . . . . . . . . . . 100
Enabling the Remote Replication
Premium Feature . . . . . . . . . . . . . . . . . 101
Activating the Remote Replication
Premium Feature . . . . . . . . . . . . . . . . . 101
Determining Candidates for a
Remote Replicated Pair. . . . . . . . . . . . . . 105
Creating a Remote Replicated Pair . . . . . . . . 105
Changing Remote Replication Settings . . . . . . . . 107
Suspending and Resuming a
Replication Relationship. . . . . . . . . . . . . . . . 108
Removing a Replication Relationship . . . . . . . . . 110
Deleting a Primary Virtual Disk or a
Secondary Virtual Disk . . . . . . . . . . . . . . . . 110
Disabling the Remote Replication
Premium Feature . . . . . . . . . . . . . . . . . . . . 111
Deactivating the Remote Replication
Premium Feature . . . . . . . . . . . . . . . . . . . . 111
Interaction with Other Premium Features. . . . . . . 111
Snapshot Virtual Disks . . . . . . . . . . . . . . 112
Virtual Disk Copy . . . . . . . . . . . . . . . . . 112
Storage Partitioning. . . . . . . . . . . . . . . . 113
Virtual Disk Expansion . . . . . . . . . . . . . . 113
book.book Page 6 Wednesday, June 8, 2011 12:20 PM

Contents 7
7 Maintaining a Storage Array. . . . . . . . . 115
Routine Maintenance . . . . . . . . . . . . . . . . . . 115
Running a Media Scan . . . . . . . . . . . . . . . 115
Running a Consistency Check . . . . . . . . . . . 117
Resetting a RAID Controller Module . . . . . . . . 118
Enabling RAID Controller
Module Data Transfer . . . . . . . . . . . . . . . 118
Resetting Battery Age . . . . . . . . . . . . . . . 118
Removing Persistent Reservations . . . . . . . . . 118
Synchronizing RAID
Controller Module Clocks. . . . . . . . . . . . . . 119
Locating Physical Disks. . . . . . . . . . . . . . . 119
Performance Tuning . . . . . . . . . . . . . . . . . . . 120
Monitoring Performance . . . . . . . . . . . . . . 120
Changing RAID Levels . . . . . . . . . . . . . . . 121
Changing Segment Size . . . . . . . . . . . . . . 121
Defragmenting a Disk Group . . . . . . . . . . . . 122
Troubleshooting and Diagnostics . . . . . . . . . . . . 123
Collecting Physical Disk Data. . . . . . . . . . . . 123
Diagnosing a RAID Controller Module . . . . . . . 123
Recovery Operations. . . . . . . . . . . . . . . . . . . 124
Setting RAID Controller
Module Operational Mode . . . . . . . . . . . . . 124
Changing RAID Controller
Module Ownership . . . . . . . . . . . . . . . . . 126
Initializing a Physical Disk . . . . . . . . . . . . . 126
Reconstructing a Physical Disk. . . . . . . . . . . 127
Initializing a Virtual Disk . . . . . . . . . . . . . . 127
Redistributing Virtual Disks. . . . . . . . . . . . . 128
book.book Page 7 Wednesday, June 8, 2011 12:20 PM

8Contents
8 Script Commands. . . . . . . . . . . . . . . . . . 129
Command Formatting Rules . . . . . . . . . . . . . . 130
Firmware Compatibility Levels . . . . . . . . . . . . 132
Commands Listed by Function . . . . . . . . . . . . . 132
Disk Group Commands . . . . . . . . . . . . . . 132
Enclosure Commands. . . . . . . . . . . . . . . 133
Host Topology Commands . . . . . . . . . . . . 133
iSCSI Commands . . . . . . . . . . . . . . . . . 134
Physical Disk Commands . . . . . . . . . . . . . 134
RAID Controller Module Commands . . . . . . . 135
Remote Replication Commands . . . . . . . . . 136
Session Command . . . . . . . . . . . . . . . . 136
Show String Command . . . . . . . . . . . . . . 136
Snapshot Commands . . . . . . . . . . . . . . . 137
Storage Array Commands . . . . . . . . . . . . 137
Virtual Disk Commands . . . . . . . . . . . . . . 139
Virtual Disk Copy Commands . . . . . . . . . . . 139
Commands Listed Alphabetically . . . . . . . . . . . 140
Activate Remote Replication Feature. . . . . . . 140
Activate Storage Array Firmware. . . . . . . . . 144
Autoconfigure Storage Array . . . . . . . . . . . 144
Autoconfigure Storage Array Hot Spares . . . . 147
Check Remote Replication Status . . . . . . . . 147
Check Virtual Disk Consistency. . . . . . . . . . 148
Clear Physical Disk Port Statistics . . . . . . . . 149
Clear Storage Array Configuration . . . . . . . . 150
Clear Storage Array Event Log . . . . . . . . . . 151
Clear Storage Array
Firmware Pending Area. . . . . . . . . . . . . . 151
Clear Virtual Disk Reservations . . . . . . . . . . 152
Clear Virtual Disk Unreadable Sectors . . . . . . 153
book.book Page 8 Wednesday, June 8, 2011 12:20 PM

Contents 9
Create Disk Group . . . . . . . . . . . . . . . . . 154
Create Host . . . . . . . . . . . . . . . . . . . . . 159
Create Host Group . . . . . . . . . . . . . . . . . 160
Create Host Port . . . . . . . . . . . . . . . . . . 160
Create iSCSI Initiator . . . . . . . . . . . . . . . . 162
Create RAID Virtual Disk
(Automatic Physical Disk Select) . . . . . . . . . . 162
Create RAID Virtual Disk
(Free Capacity Base Select) . . . . . . . . . . . . 166
Create RAID Virtual Disk
(Manual Physical Disk Select) . . . . . . . . . . . 169
Create Remote Replication . . . . . . . . . . . . . 173
Create Snapshot Virtual Disk . . . . . . . . . . . . 175
Create Storage Array Security Key. . . . . . . . . 181
Create Virtual Disk Copy . . . . . . . . . . . . . . 183
Deactivate Remote Replication . . . . . . . . . . 185
Delete Disk Group . . . . . . . . . . . . . . . . . 186
Delete Host . . . . . . . . . . . . . . . . . . . . . 186
Delete Host Group . . . . . . . . . . . . . . . . . 186
Delete Host Port . . . . . . . . . . . . . . . . . . 188
Delete iSCSI Initiator . . . . . . . . . . . . . . . . 189
Delete Virtual Disk . . . . . . . . . . . . . . . . . 189
Diagnose RAID Controller Module . . . . . . . . . 190
Diagnose Remote Replication . . . . . . . . . . . 193
Disable Storage Array Feature . . . . . . . . . . . 193
Download Enclosure
Management Module Firmware . . . . . . . . . . 194
Download Physical Disk Firmware . . . . . . . . . 195
Download Storage
Array Firmware/NVSRAM . . . . . . . . . . . . . 197
Download Storage
Array Physical Disk Firmware . . . . . . . . . . . 198
Download Storage Array NVSRAM . . . . . . . . 199
Enable Disk Group Security . . . . . . . . . . . . 199
book.book Page 9 Wednesday, June 8, 2011 12:20 PM

10 Contents
Enable RAID Controller
Module Data Transfer. . . . . . . . . . . . . . . 201
Enable Storage Array Feature . . . . . . . . . . 201
Recopy Virtual Disk Copy . . . . . . . . . . . . . 202
Re-create Remote Replication
Repository Virtual Disk . . . . . . . . . . . . . . 204
Re-create Snapshot. . . . . . . . . . . . . . . . 206
Remove Remote Replication . . . . . . . . . . . 209
Remove Virtual Disk Copy. . . . . . . . . . . . . 210
Remove Virtual Disk LUN Mapping . . . . . . . . 211
Repair Virtual Disk Consistency . . . . . . . . . 212
Replace Physical Disk. . . . . . . . . . . . . . . 213
Reset RAID Controller Module . . . . . . . . . . 214
Reset Storage Array Battery Install Date. . . . . 215
Reset Storage Array iSCSI Baseline . . . . . . . 216
Reset Storage Array SAS PHY Baseline . . . . . 216
Reset Storage Array
Virtual Disk Distribution . . . . . . . . . . . . . . 217
Resume Remote Replication . . . . . . . . . . . 217
Revive Disk Group. . . . . . . . . . . . . . . . . 218
Revive Physical Disk . . . . . . . . . . . . . . . 219
Save Enclosure Log Data . . . . . . . . . . . . . 219
Save Physical Disk Channel
Fault Isolation Diagnostic Status . . . . . . . . . 220
Save Physical Disk Log . . . . . . . . . . . . . . 221
Save RAID Controller Module NVSRAM . . . . . 221
Save Storage Array Configuration . . . . . . . . 222
Save Storage Array Events . . . . . . . . . . . . 223
Save Storage Array iSCSI Statistics . . . . . . . 224
Save Storage Array Performance Statistics . . . . . 225
Save Storage Array SAS PHY Counts . . . . . . 225
Save Storage Array State Capture . . . . . . . . 226
Save Storage Array Support Data . . . . . . . . 226
Set Disk Group . . . . . . . . . . . . . . . . . . 227
book.book Page 10 Wednesday, June 8, 2011 12:20 PM