Dell PowerVault MD3000i User manual

www.dell.com | support.dell.com
Dell™ PowerVault™ Modular Disk
Storage Manager CLI Guide

Notes and Notices
NOTE: A NOTE indicates important information that helps you make better use of
your computer.
NOTICE: A NOTICE indicates either potential damage to hardware or loss of data
and tells you how to avoid the problem.
____________________
Information in this document is subject to change without notice.
© 2008 Dell Inc. All rights reserved.
Reproduction 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,InternetExplorer,andWindowsare eitherregisteredtrademarksor trademarksof Microsoft
Corporation in the United States and/or other countries.
Other trademarks and trade names may be used in this document 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.
February 2008

Contents 3
Contents
1 About the Command Line Interface . . . . 13
How to Use the Command Line Interface . . . . . . . . 14
Usage Notes . . . . . . . . . . . . . . . . . . . . 15
CLI Commands . . . . . . . . . . . . . . . . . . . 16
Command Line Parameters . . . . . . . . . . . . 18
Formatting Considerations . . . . . . . . . . . . . . . 24
Detailed Error Reporting . . . . . . . . . . . . . . . . 24
Exit Status . . . . . . . . . . . . . . . . . . . . . . . . 25
Usage Examples . . . . . . . . . . . . . . . . . . . . . 27
2 About the Script Commands . . . . . . . . . . 29
Script Command Structure . . . . . . . . . . . . . . . 30
Script Command Synopsis . . . . . . . . . . . . . . . 32
Recurring Syntax Elements . . . . . . . . . . . . . . . 34
Usage Guidelines . . . . . . . . . . . . . . . . . . . . 40
Adding Comments to a Script File . . . . . . . . . . . 41

4Contents
3 Configuring a Storage Array . . . . . . . . . . 43
Configuring a Storage Array . . . . . . . . . . . . . . . 44
Determining What is on Your Storage Array . . . . 44
Saving a Configuration to a File . . . . . . . . . . 47
Using the Create Virtual Disk Command . . . . . . 48
Using the Auto Configure Command . . . . . . . . 53
Modifying Your Configuration . . . . . . . . . . . . . . 55
Setting the Storage Array Password . . . . . . . . 56
Setting Up SMTP and SNMP Alerts . . . . . . . . 56
Setting the RAID Controller Module Clocks . . . . 57
Setting the Storage Array Host Type . . . . . . . . 57
Setting Modification Priority . . . . . . . . . . . . 58
Assigning Global Hot Spares . . . . . . . . . . . . 59
4 Using the Snapshot Feature . . . . . . . . . . 61
Using Host Servers to Create an Initial Snapshot
Virtual Disk . . . . . . . . . . . . . . . . . . . . . . . 63
Creating a Snapshot Virtual Disk . . . . . . . . . . . . 63
Enabling the Snapshot Virtual Disk Feature . . . . 64
Creating a Snapshot Virtual Disk with
User-Assigned Physical Disks . . . . . . . . . . . 64
Preparing Host Servers to Create an Initial
Snapshot Virtual Disk . . . . . . . . . . . . . . . . 65
Creating the Initial Snapshot Virtual Disk . . . . . 66
Creating a Snapshot Virtual Disk with
Software-Assigned Physical Disks . . . . . . . . . 67
Creating a Snapshot Virtual Disk by
Specifying a Number of Physical Disks . . . . . . 69
User-Defined Parameters . . . . . . . . . . . . . 70
Names of Snapshot Virtual Disks and
Repository Virtual Disks . . . . . . . . . . . . . . 72

Contents 5
Changing Snapshot Virtual Disk Settings . . . . . . . 73
Stopping and Deleting a Snapshot Virtual Disk . . . . 74
Re-creating the Snapshot Virtual Disk . . . . . . 75
Preparing Host Servers to Re-create a
Snapshot Virtual Disk . . . . . . . . . . . . . . . 75
Re-creating a Snapshot Virtual Disk . . . . . . . . 76
5 Using the Virtual Disk Copy Feature . . . . 77
Creating a Virtual Disk Copy . . . . . . . . . . . . . . 78
Enabling the Virtual Disk Copy Feature . . . . . . 79
Determining Virtual Disk Copy Candidates . . . . 79
Creating a Virtual Disk Copy . . . . . . . . . . . . 79
Preparing Host Servers to Create a Virtual
Disk Copy . . . . . . . . . . . . . . . . . . . . . . 80
Copying the Virtual Disk . . . . . . . . . . . . . . 81
Viewing Virtual Disk Copy Properties . . . . . . . . . 82
Changing Virtual Disk Copy Settings . . . . . . . . . . 83
Recopying a Virtual Disk . . . . . . . . . . . . . . . . 84
Preparing Host Servers to Recopy a
Virtual Disk . . . . . . . . . . . . . . . . . . . . . 85
Recopying the Virtual Disk . . . . . . . . . . . . . 86
Stopping a Virtual Disk Copy . . . . . . . . . . . . . . 87
Removing Copy Pairs . . . . . . . . . . . . . . . . . . 87
Interaction with Other Features . . . . . . . . . . . . . 88
Storage Partitioning . . . . . . . . . . . . . . . . 88
Snapshot Virtual Disks . . . . . . . . . . . . . . . 89

6Contents
6 Maintaining a Storage Array . . . . . . . . . . 91
Routine Maintenance . . . . . . . . . . . . . . . . . . 91
Running a Media Scan . . . . . . . . . . . . . . . 91
Running a Consistency Check . . . . . . . . . . . 93
Resetting a RAID Controller Module . . . . . . . . 94
Enabling RAID Controller Module Data
Transfer . . . . . . . . . . . . . . . . . . . . . . . 94
Resetting Battery Age . . . . . . . . . . . . . . . 94
Removing Persistent Reservations . . . . . . . . . 94
Synchronizing RAID Controller Module
Clocks . . . . . . . . . . . . . . . . . . . . . . . . 95
Locating Physical Disks . . . . . . . . . . . . . . 95
Performance Tuning . . . . . . . . . . . . . . . . . . . 95
Monitoring Performance . . . . . . . . . . . . . . 96
Changing RAID Levels . . . . . . . . . . . . . . . 97
Changing Segment Size . . . . . . . . . . . . . . 97
Defragmenting a Disk Group . . . . . . . . . . . . 98
Troubleshooting and Diagnostics . . . . . . . . . . . . 98
Collecting Physical Disk Data . . . . . . . . . . . 98
Diagnosing a RAID Controller Module . . . . . . . 99
Recovery Operations . . . . . . . . . . . . . . . . . . 100
Setting RAID Controller Module
Operational Mode . . . . . . . . . . . . . . . . . 100
Changing RAID Controller Module
Ownership . . . . . . . . . . . . . . . . . . . . . 101
Initializing a Physical Disk . . . . . . . . . . . . . 101
Reconstructing a Physical Disk . . . . . . . . . . 102
Initializing a Virtual Disk . . . . . . . . . . . . . . 102
Redistributing Virtual Disks . . . . . . . . . . . . . 103

Contents 7
7 Script Commands . . . . . . . . . . . . . . . . . 105
Command Formatting Rules . . . . . . . . . . . . . . . 106
Commands Listed by Function . . . . . . . . . . . . . 108
Disk Group Commands . . . . . . . . . . . . . . . 108
Enclosure Commands . . . . . . . . . . . . . . . 108
Host Topology Commands . . . . . . . . . . . . . 109
iSCSI Commands . . . . . . . . . . . . . . . . . . 109
Physical Disk Commands . . . . . . . . . . . . . . 110
RAID Controller Module Commands . . . . . . . . 111
Session Command . . . . . . . . . . . . . . . . . 111
Show String Command . . . . . . . . . . . . . . . 111
Snapshot Commands . . . . . . . . . . . . . . . . 111
Storage Array Commands . . . . . . . . . . . . . 111
Virtual Disk Commands . . . . . . . . . . . . . . 113
Virtual Disk Copy Commands . . . . . . . . . . . 113
Commands Listed Alphabetically . . . . . . . . . . . . 114
Accept Storage Array Pending Topology . . . . . 114
Activate Storage Array Firmware . . . . . . . . . 114
Autoconfigure Storage Array . . . . . . . . . . . 114
Autoconfigure Storage Array Hot Spares . . . . . 116
Check Disk Consistency . . . . . . . . . . . . . . 117
Clear Physical Disk Channel Statistics . . . . . . . 118
Clear Storage Array Configuration . . . . . . . . . 118
Clear Storage Array Event Log . . . . . . . . . . . 118
Clear Storage Array Firmware Pending Area . . . 119
Clear Virtual Disk Reservations . . . . . . . . . . 119
Create Host . . . . . . . . . . . . . . . . . . . . . 120
Create Host Group . . . . . . . . . . . . . . . . . 121
Create Host Port . . . . . . . . . . . . . . . . . . 121
Create iSCSI Initiator . . . . . . . . . . . . . . . . 122

8Contents
Create RAID Virtual Disk (Automatic Physical
Disk Select) . . . . . . . . . . . . . . . . . . . . . 123
Create RAID Virtual Disk (Free Capacity
Base Select) . . . . . . . . . . . . . . . . . . . . 126
Create RAID Virtual Disk (Manual Physical
Disk Select) . . . . . . . . . . . . . . . . . . . . . 128
Create Snapshot Virtual Disk . . . . . . . . . . . . 131
Create Virtual Disk Copy . . . . . . . . . . . . . . 135
Delete Disk Group . . . . . . . . . . . . . . . . . 137
Delete Host . . . . . . . . . . . . . . . . . . . . . 138
Delete Host Group . . . . . . . . . . . . . . . . . 138
Delete Host Port . . . . . . . . . . . . . . . . . . 139
Delete iSCSI Initiator . . . . . . . . . . . . . . . . 139
Delete Virtual Disk . . . . . . . . . . . . . . . . . 140
Diagnose RAID Controller Module . . . . . . . . . 141
Disable Storage Array Feature . . . . . . . . . . . 144
Download Enclosure Management
Module Firmware . . . . . . . . . . . . . . . . . . 144
Download Physical Disk Firmware . . . . . . . . . 145
Download Storage Array
Firmware/NVSRAM . . . . . . . . . . . . . . . . . 146
Download Storage Array NVSRAM . . . . . . . . 147
Download Storage Array Physical Disk
Firmware . . . . . . . . . . . . . . . . . . . . . . 148
Enable RAID Controller Module . . . . . . . . . . 149
Enable Storage Array Feature Key . . . . . . . . . 149
Recopy Virtual Disk Copy . . . . . . . . . . . . . . 150
Recover RAID Virtual Disk . . . . . . . . . . . . . 151
Re-create Snapshot . . . . . . . . . . . . . . . . 153
Remove Virtual Disk Copy . . . . . . . . . . . . . 155
Remove Virtual Disk LUN Mapping . . . . . . . . . 156
Repair Virtual Disk Consistency . . . . . . . . . . 157
Reset RAID Controller Module . . . . . . . . . . . 157
Reset Storage Array Battery Install Date . . . . . 158
Reset Storage Array iSCSI Baseline . . . . . . . . 158

Contents 9
Reset Storage Array SAS PHY Baseline . . . . . . 159
Reset Storage Array Virtual Disk Distribution . . . 159
Revive Disk Group . . . . . . . . . . . . . . . . . 160
Revive Physical Disk . . . . . . . . . . . . . . . . 160
Save Enclosure Log Data . . . . . . . . . . . . . 161
Save Physical Disk Log . . . . . . . . . . . . . . . 161
Save RAID Controller Module NVSRAM . . . . . . 162
Save Storage Array Configuration . . . . . . . . . 162
Save Storage Array Events . . . . . . . . . . . . 163
Save Storage Array iSCSI Statistics . . . . . . . . 164
Save Storage Array Performance Statistics . . . . 165
Save Storage Array SAS PHY Counts . . . . . . . 165
Save Storage Array State Capture . . . . . . . . . 166
Save Storage Array Support Data . . . . . . . . . 166
Set Controller . . . . . . . . . . . . . . . . . . . . 166
Set Disk Group . . . . . . . . . . . . . . . . . . . 169
Set Enclosure Attribute . . . . . . . . . . . . . . 170
Set Enclosure Identification . . . . . . . . . . . . 171
Set Host . . . . . . . . . . . . . . . . . . . . . . 171
Set Host Group . . . . . . . . . . . . . . . . . . . 173
Set Host Port . . . . . . . . . . . . . . . . . . . . 174
Set iSCSI Initiator . . . . . . . . . . . . . . . . . 175
Set iSCSI Target Properties . . . . . . . . . . . . 176
Set Physical Disk Channel Status . . . . . . . . . 177
Set Physical Disk Hot Spare . . . . . . . . . . . . 178
Set Physical Disk State . . . . . . . . . . . . . . . 178
Set Session . . . . . . . . . . . . . . . . . . . . . 179
Set Snapshot Virtual Disk . . . . . . . . . . . . . 180
Set Storage Array . . . . . . . . . . . . . . . . . 182
Set Storage Array Enclosure Positions . . . . . . 184
Set Storage Array ICMP Response . . . . . . . . 184
Set Storage Array iSNS Server IPv4 Address . . . 185
Set Storage Array iSNS Server IPv6 Address . . . 186

10 Contents
Set Storage Array iSNS Server Listening
Port . . . . . . . . . . . . . . . . . . . . . . . . . 187
Set Storage Array iSNS Server Refresh . . . . . . 188
Set Storage Array Time . . . . . . . . . . . . . . . 188
Set Unnamed Discovery Session . . . . . . . . . 188
Set Virtual Disk . . . . . . . . . . . . . . . . . . . 189
Set Virtual Disk Copy . . . . . . . . . . . . . . . . 194
Show Current iSCSI Sessions . . . . . . . . . . . 194
Show Disk Group . . . . . . . . . . . . . . . . . . 195
Show Host Ports . . . . . . . . . . . . . . . . . . 196
Show Physical Disk . . . . . . . . . . . . . . . . . 196
Show Physical Disk Channel Statistics . . . . . . 198
Show Physical Disk Download Progress . . . . . . 199
Show RAID Controller Module . . . . . . . . . . . 200
Show RAID Controller Module NVSRAM . . . . . 201
Show Storage Array . . . . . . . . . . . . . . . . 202
Show Storage Array Autoconfigure . . . . . . . . 204
Show Storage Array Host Topology . . . . . . . . 206
Show Storage Array LUN Mappings . . . . . . . . 206
Show Storage Array Negotiation Defaults . . . . . 206
Show Storage Array Pending Topology . . . . . . 207
Show Storage Array Unreadable Sectors . . . . . 207
Show String . . . . . . . . . . . . . . . . . . . . . 208
Show Unconfigured iSCSI Initiators . . . . . . . . 208
Show Virtual Disk . . . . . . . . . . . . . . . . . . 209
Show Virtual Disk Action Progress . . . . . . . . . 210
Show Virtual Disk Copy . . . . . . . . . . . . . . . 211
Show Virtual Disk Copy Source Candidates . . . . 212
Show Virtual Disk Copy Target Candidates . . . . 212
Show Virtual Disk Performance Statistics . . . . . 212
Show Virtual Disk Reservations . . . . . . . . . . 213
Start Disk Group Blink . . . . . . . . . . . . . . . 214
Start Disk Group Defragment . . . . . . . . . . . . 214

Contents 11
Start Enclosure Blink . . . . . . . . . . . . . . . . 215
Start iSCSI DHCP Refresh . . . . . . . . . . . . . 215
Start Physical Disk Blink . . . . . . . . . . . . . . 216
Start Physical Disk Initialize . . . . . . . . . . . . 216
Start Physical Disk Reconstruction . . . . . . . . 217
Start Storage Array Blink . . . . . . . . . . . . . 217
Start Virtual Disk Initialization . . . . . . . . . . . 217
Stop Disk Group Blink . . . . . . . . . . . . . . . 218
Stop Enclosure Blink . . . . . . . . . . . . . . . . 218
Stop iSCSI Session . . . . . . . . . . . . . . . . . 218
Stop Physical Disk Blink . . . . . . . . . . . . . . 219
Stop Snapshot . . . . . . . . . . . . . . . . . . . 219
Stop Storage Array Blink . . . . . . . . . . . . . . 220
Stop Storage Array Physical Disk Firmware
Download . . . . . . . . . . . . . . . . . . . . . 220
Stop Virtual Disk Copy . . . . . . . . . . . . . . . 220
A Sample Script Files . . . . . . . . . . . . . . . . 223
Configuration Script Example 1 . . . . . . . . . . . . . 223
Configuration Script Example 2 . . . . . . . . . . . . . 226
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

12 Contents

About the Command Line Interface 13
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
you can also access from the Modular Disk (MD) Storage Manager, which is
the graphical user interface (GUI) to the storage array. See the User’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 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.
The command line interface (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.

14 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 email alert notifications.
• Specify the mail server and sender email 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

About the Command Line Interface 15
The following syntax is the general form of a CLI command:
SMcli
storageArray parameters script-commands;
The script commands are the storage array configuration commands. "About
the Script Commands" on page 29 presents an overview of the script
commands. "Script Commands" on page 105 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.
SMcli Invokes the command line interface
storageArray Host name or IP address of the storage array
parameters CLI parameters that define the environment and purpose for the
command
script-commands One or more script commands or the name of a script file
containing script commands

16 About the Command Line Interface
CLI Commands
This section lists the CLI commands you can use to perform the following
functions:
• Identify storage arrays.
• 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. 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 ]
[-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]
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

About the Command Line Interface 17
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 -?

18 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 only).
• 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 email 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 email address for an alert destination,
the
email-address is the email address to which to send
the alert message.

About the Command Line Interface 19
-c Use to indicate that you are entering one or more script
commands to run on the specified storage array. Terminate
each command by using a semicolon (;).
You cannot place more than one -c parameter on the same
command line. You can include more than one script
command after the -c parameter.
-d Use to display the contents of the script configuration file.
-e Use to disable syntax checking when executing the current
CLI command.
-F (uppercase) Use to specify the email address from which all alerts will
be sent.
-f (lowercase) Use to specify a file name containing script commands
intended to run on the specified storage array.
This parameter is similar to the -c parameter in that both
are intended for running script commands. The -c
parameter allows you to execute individual script
commands. The -f parameter allows you to execute script
commands contained in a file.
NOTE: By default, any errors encountered when running the
script commands in a file are ignored, and the file continues
to run. To override this behavior, use the set session
errorAction=stop command in the script file.
Table 1-2. Command Line Parameters (continued)
Parameter Definition

20 About the Command Line Interface
-g Use to specify an ASCII file that contains email sender
contact information to include in all email alert
notifications. The CLI assumes the ASCII file is text only,
without delimiters or any expected format. A typical file
contains the following information:
•Name
• Title
• Company
• Phone
•Pager
NOTE: You can use any file name that your operating system
supports. You must not use userdata.txt. Some operating
systems reserve userdata.txt for system information.
-h Use with the -a and -x parameters to specify the host name
that is running the SNMP agent to which the storage array
is connected.
-I Use to specify the type of information to be included in
the email alert notifications. The following are valid
information arguments:
• eventOnly — Only event information is included in the
email.
•
profile — Event and array profile information is included
in the email.
•
supportBundle — Event and support bundle
information is included in the email.
NOTE: You can enter only one information argument each
time you execute the command. If you want all of the
information, you must run the command three times.
-i Use with the -d parameter to display the IP address of the
known storage arrays.
-m Use to specify the host name or IP address of the email
server from which to send email alert notifications.
Table 1-2. Command Line Parameters (continued)
Parameter Definition