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

Contents 11
Set Disk Group Forced State . . . . . . . . . . . . 228
Set Enclosure Attribute. . . . . . . . . . . . . . . 229
Set Enclosure Identification . . . . . . . . . . . . 230
Set Foreign Physical Disk to Native . . . . . . . . 231
Set Host . . . . . . . . . . . . . . . . . . . . . . . 232
Set Host Channel . . . . . . . . . . . . . . . . . . 234
Set Host Group . . . . . . . . . . . . . . . . . . . 235
Set Host Port . . . . . . . . . . . . . . . . . . . . 236
Set iSCSI Initiator . . . . . . . . . . . . . . . . . . 237
Set iSCSI Target Properties . . . . . . . . . . . . 238
Set Physical Disk Channel Status . . . . . . . . . 239
Set Physical Disk Hot Spare . . . . . . . . . . . . 240
Set Physical Disk State . . . . . . . . . . . . . . . 241
Set RAID Controller Module . . . . . . . . . . . . 241
Set Remote Replication. . . . . . . . . . . . . . . 246
Set Session . . . . . . . . . . . . . . . . . . . . . 249
Set Snapshot Virtual Disk. . . . . . . . . . . . . . 250
Set Storage Array. . . . . . . . . . . . . . . . . . 251
Set Storage Array Enclosure Positions . . . . . . 256
Set Storage Array ICMP Response. . . . . . . . . 257
Set Storage Array iSNS
Server IPv4 Address . . . . . . . . . . . . . . . . 257
Set Storage Array iSNS
Server IPv6 Address . . . . . . . . . . . . . . . . 258
Set Storage Array iSNS
Server Listening Port . . . . . . . . . . . . . . . . 258
Set Storage Array Learn Cycle . . . . . . . . . . . 259
Set Storage Array Redundancy Mode . . . . . . . 260
Set Storage Array Security Key . . . . . . . . . . 260
Set Storage Array Time . . . . . . . . . . . . . . . 261
Set Storage Array Unnamed
Discovery Session . . . . . . . . . . . . . . . . . 262
Set Virtual Disk . . . . . . . . . . . . . . . . . . . 262
Set Virtual Disk Copy . . . . . . . . . . . . . . . . 268
book.book Page 11 Wednesday, June 8, 2011 12:20 PM

12 Contents
Show Current iSCSI Sessions . . . . . . . . . . 269
Show Disk Group . . . . . . . . . . . . . . . . . 270
Show Disk Group Export Dependencies . . . . . 270
Show Disk Group Import Dependencies . . . . . 271
Show Host Ports . . . . . . . . . . . . . . . . . 272
Show Physical Disk . . . . . . . . . . . . . . . . 272
Show Physical Disk Channel Statistics . . . . . . 275
Show Physical Disk Download Progress . . . . . 276
Show RAID Controller Module . . . . . . . . . . 276
Show RAID Controller
Module NVSRAM . . . . . . . . . . . . . . . . . 278
Show Remote Replication
Virtual Disk Candidates . . . . . . . . . . . . . . 279
Show Remote Replication
Virtual Disk Synchronization Progress . . . . . . 280
Show Storage Array . . . . . . . . . . . . . . . 280
Show Storage Array Auto Configure . . . . . . . 282
Show Storage Array Host Topology . . . . . . . 284
Show Storage Array LUN Mappings . . . . . . . 285
Show Storage Array
Negotiation Defaults . . . . . . . . . . . . . . . 285
Show Storage Array
Unconfigured iSCSI Initiators. . . . . . . . . . . 286
Show Storage Array
Unreadable Sectors. . . . . . . . . . . . . . . . 286
Show String . . . . . . . . . . . . . . . . . . . . 287
Show Virtual Disk . . . . . . . . . . . . . . . . . 287
Show Virtual Disk Action Progress . . . . . . . . 289
Show Virtual Disk Copy . . . . . . . . . . . . . . 289
Show Virtual Disk
Copy Source Candidates . . . . . . . . . . . . . 290
Show Virtual Disk
Copy Target Candidates. . . . . . . . . . . . . . 291
Show Virtual Disk
Performance Statistics . . . . . . . . . . . . . . 291
book.book Page 12 Wednesday, June 8, 2011 12:20 PM

Contents 13
Show Virtual Disk Reservations . . . . . . . . . . 292
Start Configuration Database Diagnostic . . . . . 293
Start Disk Group Blink . . . . . . . . . . . . . . . 294
Start Disk Group Defragment. . . . . . . . . . . . 294
Start Disk Group Export. . . . . . . . . . . . . . . 295
Start Disk Group Import. . . . . . . . . . . . . . . 296
Start Enclosure Blink . . . . . . . . . . . . . . . . 297
Start iSCSI DHCP Refresh . . . . . . . . . . . . . 297
Start Physical Disk Blink . . . . . . . . . . . . . . 298
Start Physical Disk Channel Blink . . . . . . . . . 298
Start Physical Disk Channel
Fault Isolation Diagnostics . . . . . . . . . . . . . 299
Start Physical Disk Initialize . . . . . . . . . . . . 300
Start Physical Disk Reconstruction. . . . . . . . . 301
Start Secure Physical Disk Erase. . . . . . . . . . 301
Start Remote Replication Synchronization. . . . . 302
Start Storage Array Blink. . . . . . . . . . . . . . 302
Start Storage Array iSCSI Refresh . . . . . . . . . 303
Start Virtual Disk Initialization . . . . . . . . . . . 303
Stop Configuration Database Diagnostic. . . . . . 304
Stop Disk Group Blink . . . . . . . . . . . . . . . 304
Stop Enclosure Blink . . . . . . . . . . . . . . . . 304
Stop Physical Disk Blink . . . . . . . . . . . . . . 305
Stop Physical Disk Channel Blink. . . . . . . . . . 305
Stop Physical Disk Channel
Fault Isolation Diagnostics . . . . . . . . . . . . . 305
Stop Snapshot . . . . . . . . . . . . . . . . . . . 306
Stop Storage Array Blink . . . . . . . . . . . . . . 306
Stop Storage Array iSCSI Session . . . . . . . . . 307
Stop Storage Array Physical
Disk Firmware Download . . . . . . . . . . . . . . 307
Stop Virtual Disk Copy . . . . . . . . . . . . . . . 307
Suspend Remote Replication. . . . . . . . . . . . 308
Validate Storage Array Security Key . . . . . . . . 310
book.book Page 13 Wednesday, June 8, 2011 12:20 PM

14 Contents
A Sample Script Files . . . . . . . . . . . . . . . . 313
Configuration Script Example 1 . . . . . . . . . . . . 314
Configuration Script Example 2 . . . . . . . . . . . . 316
B CLI Command Updates . . . . . . . . . . . . . . 319
New Commands . . . . . . . . . . . . . . . . . . . . 319
Updated Commands . . . . . . . . . . . . . . . . . . 320
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
book.book Page 14 Wednesday, June 8, 2011 12:20 PM

About the Command Line Interface 15
1
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 Owner’s
Manual, 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 support.dell.com 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.
book.book Page 15 Wednesday, June 8, 2011 12:20 PM

16 About the Command Line Interface
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.
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:
•Theterm SMcli
• Storage array identifier
• Parameters
• Script commands
book.book Page 16 Wednesday, June 8, 2011 12:20 PM

About the Command Line Interface 17
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" on page 31 presents an overview of the script
commands. "Script Commands" on page 129 provides 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.
book.book Page 17 Wednesday, June 8, 2011 12:20 PM

18 About the Command Line Interface
CLI Commands
This section lists the CLI commands you can use to perform the
following functions:
• Identify storage arrays
•Setpasswords
• 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. Table 1-1 lists definitions
for the parameters shown in the CLI commands.
SMcli host-name-or-IP-address [host-name-or-IP-
address] [-c "command; {command2};"]
[-n storage-array-name | -w WWID]
[-ooutputfile][-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]
Table 1-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
<...> (angle brackets) occurrence exceeds maximum limit of 30 characters
(a|b|c) choose only one of the alternatives
bold terminals
book.book Page 18 Wednesday, June 8, 2011 12:20 PM

About the Command Line Interface 19
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]]
[-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 -?
book.book Page 19 Wednesday, June 8, 2011 12:20 PM

20 About the Command Line Interface
Command Line Parameters
Table 1-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.
book.book Page 20 Wednesday, June 8, 2011 12:20 PM