Dell PowerVault Modular Disk Storage Arrays CLI Guide
Dell PowerVault Modular Disk Storage Arrays CLI Guide
w w w. d e l l . c o m | s u p p o r t . d e l l . c o m
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 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, Internet Explorer, and Windows are either registered trademarks or trademarks of 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.
September 2008
Contents
Formatting Considerations . . . . . . . . . . . . . . . 24
Exit Status . . . . . . . . . . . . . . . . . . . . . . . . 25
Usage Examples . . . . . . . . . . . . . . . . . . . . . 27
Usage Guidelines . . . . . . . . . . . . . . . . . . . . 40
Contents 3
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
4 Contents
Changing Snapshot Virtual Disk Settings . . . . . . . 73
Contents 5
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
6 Contents
7 Script Commands . . . . . . . . . . . . . . . . . 105
Command Formatting Rules . . . . . . . . . . . . . . . 106
Contents 7
Create iSCSI Initiator . . . . . . . . . . . . . . . . 125
Create RAID Virtual Disk (Automatic Physical
Disk Select) . . . . . . . . . . . . . . . . . . . . . 126
Create RAID Virtual Disk (Free Capacity
Base Select) . . . . . . . . . . . . . . . . . . . . 128
Create RAID Virtual Disk (Manual Physical
Disk Select) . . . . . . . . . . . . . . . . . . . . . 130
Create Snapshot Virtual Disk . . . . . . . . . . . . 133
Create Virtual Disk Copy . . . . . . . . . . . . . . 137
Delete Disk Group . . . . . . . . . . . . . . . . . 139
Delete Host . . . . . . . . . . . . . . . . . . . . . 140
Delete Host Group . . . . . . . . . . . . . . . . . 140
Delete Host Port . . . . . . . . . . . . . . . . . . 141
Delete iSCSI Initiator . . . . . . . . . . . . . . . . 141
Delete Virtual Disk . . . . . . . . . . . . . . . . . 142
Diagnose RAID Controller Module . . . . . . . . . 143
Disable Storage Array Feature . . . . . . . . . . . 146
Download Enclosure Management Module
Firmware . . . . . . . . . . . . . . . . . . . . . . 146
Download Physical Disk Firmware . . . . . . . . . 147
Download Storage Array Firmware/NVSRAM . . . 148
Download Storage Array NVSRAM . . . . . . . . 149
Download Storage Array Physical Disk
Firmware . . . . . . . . . . . . . . . . . . . . . . 150
Enable RAID Controller Module . . . . . . . . . . 151
Enable Storage Array Feature Key . . . . . . . . . 151
Recopy Virtual Disk Copy . . . . . . . . . . . . . . 152
Recover RAID Virtual Disk . . . . . . . . . . . . . 153
Additional Information . . . . . . . . . . . . . . . 155
Re-create Snapshot . . . . . . . . . . . . . . . . 156
Remove Virtual Disk Copy . . . . . . . . . . . . . 158
Remove Virtual Disk LUN Mapping . . . . . . . . . 159
Repair Virtual Disk Consistency . . . . . . . . . . 160
Reset RAID Controller Module . . . . . . . . . . . 160
8 Contents
Reset Storage Array Battery Install Date . . . . . 161
Reset Storage Array iSCSI Baseline . . . . . . . . 162
Reset Storage Array SAS PHY Baseline . . . . . . 162
Reset Storage Array Virtual Disk Distribution . . . 162
Revive Disk Group . . . . . . . . . . . . . . . . . 163
Revive Physical Disk . . . . . . . . . . . . . . . . 163
Save Enclosure Log Data . . . . . . . . . . . . . 164
Save Physical Disk Channel Fault Isolation
Diagnostic Status . . . . . . . . . . . . . . . . . 164
Syntax . . . . . . . . . . . . . . . . . . . . . . . 164
Save Physical Disk Log . . . . . . . . . . . . . . . 165
Save RAID Controller Module NVSRAM . . . . . . 165
Save Storage Array Configuration . . . . . . . . . 166
Save Storage Array Events . . . . . . . . . . . . 167
Save Storage Array iSCSI Statistics . . . . . . . . 168
Save Storage Array Performance Statistics . . . . 169
Save Storage Array SAS PHY Counts . . . . . . . 169
Save Storage Array State Capture . . . . . . . . . 170
Save Storage Array Support Data . . . . . . . . . 170
Set Controller . . . . . . . . . . . . . . . . . . . . 170
Additional Information . . . . . . . . . . . . . . . 172
Set Disk Group . . . . . . . . . . . . . . . . . . . 173
Set Enclosure Attribute . . . . . . . . . . . . . . 174
Set Enclosure Identification . . . . . . . . . . . . 175
Set Foreign Physical Disk to Native . . . . . . . . 176
Set Host . . . . . . . . . . . . . . . . . . . . . . 176
Set Host Group . . . . . . . . . . . . . . . . . . . 178
Set Host Port . . . . . . . . . . . . . . . . . . . . 179
Set iSCSI Initiator . . . . . . . . . . . . . . . . . 179
Set iSCSI Target Properties . . . . . . . . . . . . 180
Set Physical Disk Channel Status . . . . . . . . . 182
Set Physical Disk Hot Spare . . . . . . . . . . . . 182
Set Physical Disk State . . . . . . . . . . . . . . . 183
Contents 9
Set RAID Controller Module . . . . . . . . . . . . 183
Syntax . . . . . . . . . . . . . . . . . . . . . . . 183
Syntax Element Statement Data . . . . . . . . . . 185
Additional Information . . . . . . . . . . . . . . . 187
Set Session . . . . . . . . . . . . . . . . . . . . . 188
Set Snapshot Virtual Disk . . . . . . . . . . . . . 189
Set Storage Array . . . . . . . . . . . . . . . . . 191
Set Storage Array Enclosure Positions . . . . . . 192
Set Storage Array ICMP Response . . . . . . . . 193
Set Storage Array iSNS Server IPv4 Address . . . 194
Set Storage Array iSNS Server IPv6 Address . . . 195
Set Storage Array iSNS Server Listening Port . . . 195
Set Storage Array iSNS Server Refresh . . . . . . 196
Set Storage Array Learn Cycle . . . . . . . . . . . 197
Set Storage Array Time . . . . . . . . . . . . . . . 197
Set Unnamed Discovery Session . . . . . . . . . 198
Set Virtual Disk . . . . . . . . . . . . . . . . . . . 198
Set Virtual Disk Copy . . . . . . . . . . . . . . . . 203
Show Current iSCSI Sessions . . . . . . . . . . . 203
Show Disk Group . . . . . . . . . . . . . . . . . . 204
Show Host Ports . . . . . . . . . . . . . . . . . . 205
Show Physical Disk . . . . . . . . . . . . . . . . . 205
Show Physical Disk Channel Statistics . . . . . . 207
Show Physical Disk Download Progress . . . . . . 208
Show RAID Controller Module . . . . . . . . . . . 208
Show RAID Controller Module NVSRAM . . . . . 209
Show Storage Array . . . . . . . . . . . . . . . . 210
Show Storage Array Autoconfigure . . . . . . . . 212
Show Storage Array Host Topology . . . . . . . . 214
Show Storage Array LUN Mappings . . . . . . . . 214
Show Storage Array Negotiation Defaults . . . . . 214
Show Storage Array Pending Topology . . . . . . 215
Show Storage Array Unreadable Sectors . . . . . 215
10 Contents
Show String . . . . . . . . . . . . . . . . . . . . 216
Show Unconfigured iSCSI Initiators . . . . . . . . 216
Show Virtual Disk . . . . . . . . . . . . . . . . . 217
Show Virtual Disk Action Progress . . . . . . . . 218
Show Virtual Disk Copy . . . . . . . . . . . . . . 219
Show Virtual Disk Copy Source Candidates . . . . 220
Show Virtual Disk Copy Target Candidates . . . . 220
Show Disk Group Import Dependencies . . . . . . 220
Show Virtual Disk Performance Statistics . . . . . 221
Show Virtual Disk Reservations . . . . . . . . . . 222
Start Disk Group Blink . . . . . . . . . . . . . . . 223
Start Disk Group Defragment . . . . . . . . . . . 223
Start Enclosure Blink . . . . . . . . . . . . . . . . 223
Start iSCSI DHCP Refresh . . . . . . . . . . . . . 224
Start Physical Disk Channel Fault Isolation
Diagnostics . . . . . . . . . . . . . . . . . . . . . 224
Syntax . . . . . . . . . . . . . . . . . . . . . . . 224
Start Physical Disk Blink . . . . . . . . . . . . . . 226
Start Physical Disk Initialize . . . . . . . . . . . . 226
Start Physical Disk Reconstruction . . . . . . . . 227
Start Storage Array Blink . . . . . . . . . . . . . 227
Start Disk Group Import/Export . . . . . . . . . . 227
Start Virtual Disk Initialization . . . . . . . . . . . 228
Stop Disk Group Blink . . . . . . . . . . . . . . . 229
Stop Enclosure Blink . . . . . . . . . . . . . . . . 229
Stop iSCSI Session . . . . . . . . . . . . . . . . . 229
Syntax . . . . . . . . . . . . . . . . . . . . . . . 229
Stop Physical Disk Blink . . . . . . . . . . . . . . 229
Stop Physical Disk Channel Fault Isolation
Diagnostics . . . . . . . . . . . . . . . . . . . . . 230
Stop Snapshot . . . . . . . . . . . . . . . . . . . 230
Stop Storage Array Blink . . . . . . . . . . . . . . 231
Contents 11
Stop Storage Array Physical Disk Firmware
Download . . . . . . . . . . . . . . . . . . . . . . 231
Stop Virtual Disk Copy . . . . . . . . . . . . . . . 231
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
12 Contents
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.
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.
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
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.
Parameter Definition
-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 (;).
Parameter Definition
-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.
Parameter Definition
-n Use to specify the name of the storage array on which to
run the script commands. This name is optional when you
use host-name-or-IP-address; however, if you are using the
in-band method for managing the storage array, you must
use the -n parameter if more than one storage array is
connected to the host at the specified address.
Parameter Definition
-q Use to specify how frequently to include additional profile
or support bundle information in the email alert
notifications. An email alert notification that contains at
least the basic event information is always generated for
every critical event. If you set the -I parameter to
eventOnly, the only valid argument for -q is everyEvent. If
you set the -I parameter to either profile or
supportBundle, this information is included with the
emails with the frequency specified by the -q parameter.
Valid frequency arguments are:
• everyEvent — Information is returned with every email
alert notification.
• 2 — Information is returned no more than once every
two hours.
• 4 — Information is returned no more than once every
four hours.
• 8 — Information is returned no more than once every
eight hours.
• 12 — Information is returned no more than once every
12 hours.
• 24 — Information is returned no more than once every
24 hours.
-r Use with the -a or -x parameter to specify the name of a
management station. The name of a management station
can be either direct_sa (out-of-band storage array) or
host_sa (in-band storage arrays [host-agent]). The -r
parameter enables you to set or change the alert
notifications for all storage arrays under each management
station.
Parameter Definition
-S (uppercase) Use to suppress the informational messages describing
command progress that appear when running script
commands. (Suppressing informational messages is also
called silent mode.) This parameter suppresses the
following messages:
• Performance syntax check
• Syntax check complete
• Executing script
• Script execution complete
• SMcli completed successfully
-s (lowercase) Use with the -d parameter to display the alert settings in
the configuration file.
-v Use with the -d parameter to display the current global
status of the known devices in the storage array
configuration file. (The configuration file lists all of the
devices in a storage array configuration and the
relationship between the devices. Use the configuration
file to reconstruct a storage array.)
-X (uppercase) Use to delete a storage array from the configuration file.
(The configuration file lists all of the devices in a storage
array configuration and the relationship between the
devices. Use the configuration file to reconstruct a storage
array.)
-x (lowercase) Use to remove an SNMP trap destination or an email
address alert destination. The community is the SNMP
community name for the trap, and the host is the IP
address or DNS host name of the system to which you
want the trap sent.
-? Use this parameter to display usage information about the
CLI commands.
Exit Status
After you run a CLI command or a CLI and script command, status is
displayed that indicates the success of the operation defined by the
command. The status values are shown in Table 1-3.
Operation Activities
Virtual disk, disk group Creating, deleting, and setting priority; labeling;
configuration setting physical disk composition when creating
virtual disks; setting segment size; and setting media
scan control
Physical disk configuration Configuring the hot spare
RAID controller module Defining virtual disk ownership, changing mode
configuration settings, defining network settings, and setting host
port IDs
Operation Activities
General storage array Resetting a configuration to defaults, labeling,
configuration checking the health status, setting the time of day,
clearing the Major Event Log, and setting the media
scan rate
NVSRAM configuration Downloading and modifying the user configuration
region at the bit and byte level, displaying nonvolatile
static random access memory (NVSRAM) values
Product identification Retrieving the enclosure profile display data
Battery management Setting the battery installation date
Firmware management Downloading RAID controller module, enclosure
management module (EMM), and physical disk
firmware
Usage Guidelines
The following list provides guidelines for writing script commands on the
command line:
• You must end all commands with a semicolon (;).
• You can enter more than one command on a line, but you must separate
each command with a semicolon (;).
• You must separate each base command and its associated primary and
secondary parameters with a space.
• The script engine is case sensitive.
• You can add comments to your scripts to make it easier for you and future
users to understand the purpose of the script commands. (For information
on how to add comments, see "Adding Comments to a Script File" on
page 41.)
NOTE: While the CLI and script commands are not case sensitive, user labels
(such as for virtual disk, hosts, or host ports) are case sensitive. If you try to map to
an object identified by a user label, you must enter the user label exactly as it is
defined, or the CLI and script commands will fail.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Component Description
Source virtual disk Standard virtual disk from which the snapshot is
created
Snapshot virtual disk Point-in-time image of a standard virtual disk
Snapshot repository virtual disk Virtual disk that contains snapshot metadata and
copy-on-write data for a particular snapshot
virtual disk
Table 4-1 lists the snapshot virtual disk commands and brief descriptions of
what the commands do.
Command Description
create snapshotVirtualDisk Creates a snapshot virtual disk.
re-create snapshot Starts a fresh copy-on-write operation by using an
existing snapshot virtual disk.
set (snapshotVirtualDisk) Defines the properties for a snapshot virtual disk and
enables you to rename a snapshot virtual disk.
stop snapshot Stops a copy-on-write operation.
If you map the snapshot virtual disk to the node that does not own the source virtual
disk before the snapshot enabling process is completed, the operating system may
fail to correctly identify the snapshot virtual disk. This can result in data loss on the
source virtual disk or an inaccessible snapshot.
For details on mapping the snapshot virtual disk to the secondary node, refer to the
Dell PowerEdge™ Cluster SE600W Systems Installation and Troubleshooting Guide
on support.dell.com
NOTE: You can create concurrent snapshots of a source virtual disk on both the
source disk group and on another disk group.
Before creating a Snapshot Virtual Disk, note the following:
• The following types of virtual disks are not valid source virtual disks:
snapshot repository virtual disks, snapshot virtual disks, target virtual disks
that are participating in a virtual disk copy.
• You cannot create a snapshot of a virtual disk that contains unreadable
sectors.
• You must satisfy the requirements of your host operating system for
creating snapshot virtual disks. Failure to meet the requirements of your
host operating system results in an inaccurate point-in-time image of the
source virtual disk or the target virtual disk in a virtual disk copy.
Parameter Description
physicalDiskType Specifies the type of physical disk to use for the
snapshot repository virtual disk. The choice is either
Serial Attached SCSI (SAS) or Serial Advanced
Technology Attachment (SATA). This parameter works
only with the count-based repository method of
defining a snapshot virtual disk.
repositoryDiskGroup Specifies the disk group in which to build the snapshot
virtual disk. Default builds the snapshot repository
virtual disk in the same disk group as the source
virtual disk.
freeCapacityArea Specifies the amount of storage space to use for the
snapshot repository virtual disk. Free storage space is
defined in units of bytes, kilobytes, megabytes, or
gigabytes.
userLabel Specifies the name to give to the snapshot virtual disk.
If you do not choose a name for the snapshot virtual
disk, the RAID controller modules create a default
name using the source virtual disk name. For example,
if the source virtual disk name is Mars_Spirit_4 and it
does not have a snapshot virtual disk, the default
snapshot virtual disk name is Mars_Spirit_4-1. If the
source virtual disk already has n – 1 number of snapshot
virtual disks, the default name is Mars_Spirit_4-n.
Parameter Description
repositoryUserLabel Specifies the name to give to the snapshot repository
virtual disk. If you do not choose a name for the
snapshot repository virtual disk, the RAID controller
modules create a default name using the source virtual
disk name. For example, if the source virtual disk name
is Mars_Spirit_4 and it does not have an associated
snapshot repository virtual disk, the default snapshot
repository virtual disk name is Mars_Spirit_4-R1. If the
source virtual disk already has n – 1 number of snapshot
repository virtual disks, the default name is
Mars_Spirit_4-Rn.
warningThresholdPercent Specifies how full to allow the snapshot repository
virtual disk to get before sending a warning that the
snapshot repository virtual disk is close to capacity. The
warning value is a percentage of the total capacity of the
snapshot repository virtual disk. The default value is 50,
which represents 50 percent of total capacity. (Change
this value using the set snapshotVirtualDisk
command.)
repositoryPercentOfSource Specifies the size of the snapshot repository virtual disk
as a percentage of the source virtual disk size. The
default value is 20, which represents 20 percent of the
source virtual disk size.
repositoryFullPolicy Specifies how snapshot processing continues if the
snapshot repository virtual disk is full. You can choose to
fail writes to the source virtual disk (failSourceWrites)
or fail writes to the snapshot virtual disk
(failSnapShot). The default value is failSnapShot.
Command Description
create virtualDiskCopy Creates a virtual disk copy and starts the virtual disk
copy operation.
disable storageArray Turns off the current virtual disk copy operation.
feature=virtualDiskCopy
enable storageArray feature Activates the Virtual Disk Copy feature.
recopy virtualDiskCopy Re-initiates a virtual disk copy operation by using an
existing virtual disk copy pair.
remove virtualDiskCopy Removes a virtual disk copy pair.
set virtualDiskCopy Defines the properties for a virtual disk copy pair.
show virtualDiskCopy Returns information about virtual disk copy operations.
You can retrieve information about a specific virtual disk
copy pair, or all virtual disk copy pairs in the storage array.
show virtualDiskCopy Returns information about the candidate virtual disks
sourceCandidates that you can use as the source for a virtual disk copy
operation.
show virtualDiskCopy Returns information about the candidate virtual disks
targetCandidates that you can use as the target for a virtual disk copy
operation.
stop virtualDiskCopy Stops a virtual disk copy operation.
Storage Partitioning
Storage partitioning enables hosts to share access to virtual disks in a storage
array. You create a storage partition when you define the following storage
array assignments:
• A host
• A host group
• Virtual disk-to-logical unit number (LUN) mapping
The virtual disk-to-LUN mapping enables you to define which host group or
host has access to a particular virtual disk in the storage array.
Routine Maintenance
Routine maintenance involves those tasks you might perform periodically to
ensure that the storage array is running as well as possible or to detect
conditions before they become problems.
Performance Tuning
Over time, as a storage array exchanges data between the hosts and physical
disks, its performance can degrade. Monitor the performance of a storage
array and make adjustments to the storage array operational settings to
improve performance.
Recovery Operations
Recovery operations involve replacing failed RAID controller modules and
physical disks, restoring data, and restoring the storage array to operation.
iSCSI Commands
"iSCSI Commands" on page 109
"Delete iSCSI Initiator" on page 141
"Reset Storage Array iSCSI Baseline" on page 162
"Save Storage Array iSCSI Statistics" on page 168
"Set Controller" on page 170
"Set Host" on page 176
"Set Host Port" on page 179
Session Command
"Set Session" on page 188
Snapshot Commands
"Create Snapshot Virtual Disk" on page 133
"Set Snapshot Virtual Disk" on page 189
"Stop Snapshot" on page 230
Syntax
accept storageArray pendingTopology (allHosts |
host "hostName" | hosts ("hostName1" ...
"hostNamen")
Parameters
Parameter Description
allHosts Selects all hosts identified by show storageArray pendingTopology.
host or hosts Name of the host to include in the storage array topology. You can
enter more than one host name. You must put quotation marks (" ")
around the host name.
Syntax
activate storageArray firmware
Parameters
None
Syntax
autoConfigure storageArray [physicalDiskType=
(SAS | SATA) raidLevel=(0 | 1 | 5 | 6)
diskGroupWidth=numberOfPhysicalDisks
diskGroupCount=numberOfDiskGroups
virtualDisksPerGroupCount=
numberOfVirtualDisksPerGroup hotSpareCount=
numberOfHotspares segmentSize=segmentSizeValue]
Parameters
Parameter Description
physicalDiskType Type of physical disks to use for the
storage array. Valid physical disk types are
Serial Attached SCSI (SAS) or Serial
Advanced Technology Attachment
(SATA). This parameter is not required if
only one type of physical disk is in the
storage array.
Syntax
autoConfigure storageArray hotSpares
Parameters
None.
Syntax
check virtualDisk [virtualDiskName] consistency
[consistencyErrorFile=filename] [mediaErrorFile=
filename] [priority=(highest | high | medium | low
| lowest)] [verbose=(TRUE|FALSE)]
Parameters
Parameter Description
virtualDisk Name of the specific virtual disk to check
consistency. You must put brackets ([ ])
around the virtual disk name. If the
virtual disk name has special characters,
you must also put quotation marks (" ")
around the virtual disk name.
consistencyErrorFile Name of the file in which to save the
consistency error information. You must
put quotation marks (" ") around the file
name.
mediaErrorFile Name of the file in which to save the
media error information. You must put
quotation marks (" ") around the file
name.
Syntax
clear allPhysicalDiskChannels stats
Parameters
None.
Parameters
If you do not enter a parameter, this command removes all configuration
information for the storage array, except for the information related to
security and identification.
Parameter Description
all The setting to remove the entire configuration of the storage
array, including security and identity information. Removing all
configuration information returns the storage array to its initial
state.
volumeGroups The setting to remove the virtual disk configuration and the disk
group configuration. The rest of the configuration stays intact.
Syntax
clear storageArray eventLog
Parameters
None.
Parameters
None.
Syntax
clear (allVirtualDisks | virtualDisk
[virtualDiskName] | virtualDisks [virtualDiskName1
... virtualDiskNamen]) reservations
Parameters
Parameter Description
allVirtualDisks Clears reservations on all virtual disks in
the storage array.
virtualDisk or virtualDisks Name of the specific virtual disk for which
to clear reservations. You can enter more
than one virtual disk name. You must put
brackets ([ ]) around the virtual disk
name. If the virtual disk name has special
characters, you must also put quotation
marks (" ") around the virtual disk name.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Parameters
Parameter Description
userLabel The name that you want to use for the new disk group.
Enclose the name in double quotation marks (" ").
physicalDisks The physical disks that you want to assign to the virtual
disk that you want to create. Specify the tray ID and slot
ID for each physical disk that you assign to the virtual disk.
Tray ID values are 0 to 99.
Slot ID values are 0 to 31.
Enclose the tray ID values and the slot ID values in
parentheses.
raidLevel The RAID level of the disk group that contains the virtual
disk.
Valid values are 0, 1, 5, or 6.
enclosureLossProtect The setting to enforce enclosure loss protection when you
create the disk group. To enforce enclosure loss protection,
set this parameter to true. The default value is false.
Additional Information
physicalDisks
The physicalDisks parameter lets you choose the number of physical disks
that you want to use in the disk group. If you choose this option, you do not
need to specify the physical disks by tray ID and slot ID. The RAID controller
modules choose the specific physical disks to use for the disk group. If you do
not specify a capacity by using the capacity parameter, all of the physical disk
capacity that is available in the disk group is used. If you do not specify
capacity units, bytes is used as the default value.
Create Host
This command creates a new host.
NOTE: A host is a system that is attached to the storage array and accesses the
virtual disks on the storage array through its HBA host ports. You can define
specific virtual disk-to-logical unit number (LUN) mappings to an individual host or
assign the host to a host group that shares access to one or more virtual disks.
Syntax
create host userLabel="hostName" [hostGroup=
"hostGroupName"]
Parameters
Parameter Description
userLabel Name to give the host that you are
creating. You must put quotation marks
(" ") around the host name.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Example
-c create host userLabel= \"job2900\";"
Syntax
create hostGroup userLabel="hostGroupName"
Parameter Description
userLabel Name to give the host group that you are
creating. You must put quotation marks
(" ") around the host group name.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Syntax
create hostPort identifier="wwid" userLabel=
"portLabel" host="hostName"
Parameters
Parameter Description
identifier WWID of the HBA host port. You must
put quotation marks (" ") around the
WWID.
userLabel Name to give the new HBA host port. You
must put quotation marks (" ") around
the port label.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Syntax
create iscsiInitiator iscsiName = iSCSI-ID
userLabel = name host = host-name [chapSecret =
password]
Parameters
Parameter Description
iscsiName The default identifier of the iSCSI initiator.
userLabel The name that you want to use for the iSCSI initiator. Enclose
the name in double quotation marks (" ")
host The name of the host in which the iSCSI initiator is installed.
chapSecret The password that you want to use to authenticate a peer
connection.
Syntax
create virtualDisk physicalDiskCount=
numberOfPhysicalDisks
raidLevel=0 | 1 | 5 | 6 userLabel=
"virtualDiskName" [physicalDiskType=(SAS | SATA)
capacity=virtualdiskCapacity owner=(0 | 1)
segmentSize=segmentSizeValue
enclosureLossProtect=(TRUE | FALSE)]
Parameters
Parameter Description
physicalDiskCount Number of unassigned physical disks to
use in the disk group.
NOTE: The physicalDiskCount parameter
enables you to choose the number of
physical disks to use in the disk group. You
do not need to specify the physical disks by
enclosure ID and slot ID. The RAID
controller modules choose the specific
physical disks to use for the disk group.
raidLevel RAID level of the disk group that contains
the virtual disk. Valid values are 0, 1, 5
or 6.
userLabel Name to give to the new virtual disk. You
must put quotation marks (" ") around
the new virtual disk name.
Syntax
create virtualDisk diskGroup=diskGroupNumber
userLabel="virtualDiskName" [freeCapacityArea=
freeCapacityIndexNumber capacity=
virtualDiskCapacity owner=(0 | 1) segmentSize=
segmentSizeValue]
Parameters
Parameter Description
diskGroup Sequence number of the disk group in
which to create the new virtual disk.
(To determine the sequence numbers of
the disk groups in your storage array, enter
the show storageArray Profile command.)
Syntax
create virtualDisk physicalDisks=
(enclosureID0,slotID0...enclosureIDn,slotIDn)
raidLevel=0 | 1 | 5 | 6 userLabel="virtualDiskName"
Parameters
Parameter Description
physicalDisks Specifies the physical disks to assign to the created
virtual disk. Specify the enclosure ID and slot ID for
each unassigned physical disk to assign to the virtual
disk. Enclosure ID values are 0 to 99. Slot ID values are
0 to 31. You must put parentheses around the enclosure
ID values and the slot ID values.
raidLevel RAID level of the disk group that contains the virtual
disk. Valid values are 0, 1, 5, or 6.
NOTE: If you set the raidLevel parameter to RAID 1, the
RAID controller module firmware takes the list of physical
disks and pairs them using the following algorithm:
Data physical disk = X
Consistency physical disk = N ⁄ 2 + X
where X goes from 1 to N ⁄ 2 and N is the number of
physical disks in the list. The following data show an
example of six physical disks and their mirror pairs.
Data Consistency
1 N ⁄ 2 + 1= 4
2 N ⁄ 2 + 1= 5
3 N ⁄ 2 + 1= 6
userLabel Name that you want to give the new virtual disk. You
must put quotation marks (" ") around the new virtual
disk name.
NOTE: You can use any combination of alphanumeric
characters, hyphens, and underscores for the names.
Spaces are not allowed. Command names can have a
maximum of 30 characters. If you exceed the maximum
character limit, replace square brackets ([ ]) with angle
brackets (< >) to overcome this limitation.
Parameters
Parameter Description
sourceVirtualDisk Name of the source virtual disk from
which to take a snapshot. You must put
quotation marks (" ") around the source
virtual disk name.
repositoryRAIDLevel RAID level for the repository virtual disk.
Valid values are 0, 1, 5, or 6.
repositoryPhysicalDisks Specifies the physical disks to assign to
the repository. Specify the enclosure ID
and slot ID for each physical disk assigned
to the virtual disk. Enclosure ID values
are 0 to 99. Slot ID values are 0 to 31. You
must put parentheses around the list of
repository physical disks.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
NOTE: One technique for naming the snapshot virtual disk and the repository
virtual disk is to add a hyphenated suffix to the original name of the source virtual
disk. The suffix distinguishes between the snapshot virtual disk and the repository
virtual disk. For example, if you have a source virtual disk with a name of
Engineering Data, the snapshot virtual disk can have a name of Engineering Data-
S1, and the repository virtual disk can have a name of Engineering Data-R1.
Syntax
create virtualDiskCopy source="sourceName" target=
"targetName" [copyPriority=(highest | high |
medium | low | lowest) targetReadOnlyEnabled=(TRUE
| FALSE)]
Parameter Description
source Name of an existing virtual disk to use as
the source virtual disk. You must put
quotation marks (" ") around the source
virtual disk name.
NOTE: You can use any combination of
alphanumeric characters, hyphens, and
underscores for the names. Command
names can have a maximum of 30
characters. If you exceed the maximum
character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome
this limitation.
target Name of an existing virtual disk to use as
the target virtual disk. You must put
quotation marks (" ") around the target
virtual disk name.
NOTE: You can use any combination of
alphanumeric characters, hyphens, and
underscores for the names. Command
names can have a maximum of 30
characters. If you exceed the maximum
character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome
this limitation.
Syntax
delete diskGroup [diskGroupNumber]
Parameters
Parameter Description
diskGroup Number of the disk group to delete. You
must put brackets ([ ]) around the disk
group number.
Syntax
delete host [hostName]
Parameters
Parameter Description
host Name of the host to delete. You must put brackets ([ ]) around the
host name. If the host name has special characters, you must also put
quotation marks (" ") around the host name.
NOTE: A host is a system that is attached to the storage array and
accesses the virtual disks on the storage array through its HBA
host ports.
Syntax
delete hostGroup [hostGroupName]
Parameters
Parameter Description
hostGroup Name of the host group to delete. You
must put brackets ([ ]) around the host
group name. If the name of the host
group has special characters, you must
also put quotation marks (" ") around the
host group name.
NOTE: A host group is an optional
topological element that is a collection of
hosts that share access to the same virtual
disks. The host group is a logical entity.
Syntax
delete hostPort [hostPortName]
Parameters
Parameter Description
hostPort Name of the HBA host port to delete. You
must put brackets ([ ]) around the name
of the HBA host port.
NOTE: An HBA host port is a physical
connection on a host bus adapter that
resides within a host system. An HBA host
port provides a host access to the virtual
disks in a storage array. If the host bus
adapter has only one physical connection
(one host port), the terms HBA host port
and host bus adapter are synonymous.
Example
-c "delete host [\"job2900\"];"
Syntax
delete iscsiInitiator ([iSCSI-ID | name])
Parameters Description
iSCSI-ID The identifier of the iSCSI initiator that you want to delete. Enclose
the name in double quotation marks (" ").
name The name of the iSCSI initiator that you want to delete. Enclose the
name in double quotation marks (" ").
Example
-c "delete iscsiInitiator [\"job29002\"];"
Syntax
delete (allVirtualDisks | virtualDisk
[virtualDiskName] | virtualDisks
[virtualDiskName1... virtualDiskNameN])
Parameters
Parameter Description
allVirtualDisks Deletes all virtual disks in a storage array.
NOTE: Using the allVirtualDisks parameter
deletes virtual disks until all are removed or
until an error is encountered. If an error is
encountered, this command does not
attempt to delete the remaining virtual
disks.
Syntax
diagnose controller [(0 | 1)]
loopbackPhysicalDiskChannel=(allchannels | (1 | 2
)) testID=(1 | 2 | 3 | discreteLines)
[patternFile="filename"]
Parameter Description
controller RAID controller module on which to run
the diagnostic tests. Valid RAID controller
module identifiers are 0 or 1, where 0 is
the RAID controller module on the left
and 1 is the RAID controller module on
the right when viewed from the rear of the
enclosure. You must put brackets ([ ])
around the RAID controller module
identifier. If you do not specify a RAID
controller module, the storage
management software returns a syntax
error.
loopbackPhysicalDiskChannel Physical disk channel on which to run the
diagnostic tests. You can choose to run
the diagnostics on all channels or select a
specific channel on which to run
diagnostics. Valid physical disk channel
values are 1 or 2.
NOTE: When you run a data loopback test,
you can optionally specify a file that
contains a data pattern. If you do not
specify a file, the firmware provides a
default pattern.
Syntax
disable storageArray feature=(snapshot |
virtualDiskCopy)
Parameters
None.
Syntax
download (allEnclosures | enclosure [enclosureID])
firmware file="filename"
Parameter Description
enclosure Identifies the enclosure to which to load
new firmware. Enclosure ID values are 0
to 99. You must put brackets ([ ]) around
the enclosure ID value.
NOTE: You can use the following
parameters: (1) the allEnclosures
parameter, which downloads new firmware
to all of the EMMs in the storage array, and
(2) the enclosure parameter, which
downloads new firmware to a specific
EMM. If you need to download new
firmware to more than one EMM, but not all
EMMs, you must enter this command for
each enclosure.
file File path and file name of the file that
contains the firmware image. You must
put quotation marks (" ") around the
firmware image file path and file name.
Syntax
download physicalDisk [enclosureID,slotID]
firmware file="filename"
Parameters
Parameter Description
physicalDisk Physical disk to which to download the
firmware image. Specify the enclosure ID
and slot ID for the physical disk.
Enclosure ID values are 0 to 99. Slot ID
values are 0 to 31. You must put brackets
([ ]) around the enclosure ID value and
slot ID value.
filename File path and file name of the file that
contains the firmware image. You must
put quotation marks (" ") around the
firmware image file path and file name.
Syntax
download storageArray firmware [, NVSRAM ] file=
"filename" [, "NVSRAM-filename"] [downgrade=(TRUE
| FALSE)] [activateNow=(TRUE | FALSE)]
Parameter Description
NVSRAM Specifies that you want to download a file
with NVSRAM values when you
download a firmware file. You must not
put brackets around this parameter.
Include a comma after the term firmware.
file File path and name of the file that
contains the firmware. Valid file names
must end with a .dlp extension. You must
put quotation marks (" ") around the file
name.
NVSRAM-filename File path and name of the file that
contains the NVSRAM values. Valid file
names must end with a .dlp extension.
You must put quotation marks (" ")
around the NVSRAM file name. You must
include a comma after the firmware file
name.
downgrade Specifies that you are loading firmware
that is a previous version. The default
value is FALSE. Set downgrade to TRUE
if you want to download an earlier version
of firmware.
activateNow Activates the firmware and NVSRAM
images. The default value is TRUE. If you
set activateNow to FALSE, you must use
the activate storageArray firmware
command to activate the firmware and
NVSRAM values at a later time.
Syntax
download storageArray NVSRAM file="filename"
Parameter Description
file File path and name of the file that
contains the NVSRAM values. Valid file
names must end with a .dlp extension.
You must put quotation marks (" ")
around the file name.
Syntax
download storageArray physicalDiskFirmware file=
"filename" [file="filename2"...file="filenamen"]
Parameters
Parameter Description
file File path and name of the file that
contains the firmware image. You must
put quotation marks (" ") around the
firmware image file path and file name.
NOTE: When you run this command, you can download more than one firmware
image file to the physical disks in a storage array. The number of firmware image
files you can download depends on the storage array. The storage management
software returns an error if you attempt to download more firmware image files
than the storage array can accept.
NOTE: You can schedule downloads for multiple physical disks at the same time,
including multiple physical disks in a redundant disk group. Each firmware image
file contains information about the physical disk types on which the image runs. The
specified firmware images can be downloaded only to a compatible physical disk.
Use the download physicalDisk firmware command to download an image to a
specific physical disk.
Syntax
enable controller [(0 | 1)] dataTransfer
Parameters
Parameter Description
controller RAID controller module that you want to
revive. Valid RAID controller module
identifiers are 0 or 1, where 0 is the RAID
controller module on the left and 1 is the
RAID controller module on the right
when viewed from the rear of the
enclosure. You must put brackets ([ ])
around the RAID controller module
identifier. If you do not specify a RAID
controller module, the storage
management software returns a syntax
error.
Syntax
enable storageArray feature file="filename"
Parameter Description
file File path and file name of a valid feature
key file. Valid file names for feature key
files must end with a .key extension. You
must put quotation marks (" ") around
the file path and file name.
Syntax
recopy virtualDiskCopy target [targetName] [source
[sourceName]] [copyPriority=(highest | high |
medium | low | lowest) targetReadOnlyEnabled=(TRUE
| FALSE)]
Parameter Description
target Name of the target virtual disk for which to reinitiate a
virtual disk copy operation. You must put brackets ([ ])
around the target virtual disk name. If the target virtual disk
name has special characters, you must also put quotation
marks (" ") around the target virtual disk name.
source Name of the source virtual disk for which to reinitiate a
virtual disk copy operation. You must put brackets ([ ])
around the source virtual disk name. If the source virtual
disk name has special characters, you must also put
quotation marks (" ") around the source virtual disk name.
copyPriority Specifies the priority that the virtual disk copy has relative
to host I/O activity. Valid entries are highest, high, medium,
low, or lowest.
NOTE: CopyPriority defines the amount of system resources
used to copy the data between the source and target virtual
disks of a virtual disk copy pair. If you select the highest
priority level, the virtual disk copy uses the most system
resources to perform virtual disk copy, which decreases
performance for host data transfers.
targetReadOnlyEnabled Specifies whether the target virtual disk is write enabled or
read only. To be able to write to the target virtual disk, set
this parameter to FALSE. To prevent writing to the target
virtual disk, set this parameter to TRUE.
Syntax
recover virtualDisk (physicalDisk=(trayID,slotID)
|
physicalDisks=(trayID1,slotID1 ...
trayIDn,slotIDn) |
Parameters
Parameter Description
physicalDisk or physicalDisks Specifies the physical disks to assign to the virtual disk
that you want to create. Specify the tray ID and slot
ID for each physical disk that you assign to the virtual
disk. Tray ID values are 0 to 99. Slot ID values are 0
to 31. You must put brackets ([ ]) around the tray ID
value and the slot ID value.
newVolumeGroup This parameter enables the user to specify a name for
a new volume group that is automatically created by
the RAID controller module.
userLabel Name to give the new virtual disk. Enclose the new
virtual disk name in double quotation marks (" ").
capacity Size of the virtual disk that you are adding to the
storage array. Size is defined in units of bytes.
offset Number of blocks from the beginning of the disk
group to the beginning of the referenced virtual disk
(1 block is equal to 512 bytes).
raidLevel RAID level of the disk group that contains the physical
disks. Valid values are 0, 1, 5, or 6.
segmentSize Amount of data (in kilobytes) that the RAID
controller module writes on a single physical disk in a
virtual disk before writing data on the next physical
disk. Valid values are 8, 16, 32, 64, 128, 256, or 512.
For information about the segmentSize parameter, see
"Using the Auto Configure Command" on page 53.
Additional Information
You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Names can have a maximum of 30 characters. The
owner parameter defines which RAID controller module owns the volume.
The preferred controller ownership of a volume is the RAID controller
module that currently owns the disk group.
Segment Size
The size of a segment determines how many data blocks that the RAID
controller module writes on a single physical disk in a virtual disk before
writing data on the next physical disk. Each data block stores 512 bytes of
data. A data block is the smallest unit of storage. The size of a segment
determines how many data blocks that it contains. For example, an 8-KB
segment holds 16 data blocks. A 64-KB segment holds 128 data blocks.
When you enter a value for the segment size, the value is checked against the
supported values that are provided by the RAID controller module at run
time. If the value that you entered is not valid, the RAID controller module
returns a list of valid values. Using a single physical disk for a single request
leaves other physical disks available to simultaneously service other requests.
If the virtual disk is in an environment where a single user is transferring large
units of data (such as multimedia), performance is maximized when a single
data transfer request is serviced with a single data stripe (a data stripe is the
segment size that is multiplied by the number of physical disks in the volume
CacheReadPrefetch
Cache read prefetch lets the RAID controller module copy additional data
blocks into cache while the RAID controller module reads and copies data
blocks that are requested by the host from disk into cache. This action
increases the chance that a future request for data can be fulfilled from cache.
Cache read prefetch is important for multimedia applications that use
sequential data transfers. The configuration settings for the storage array that
you use determine the number of additional data blocks that the RAID
controller module reads into cache.
Valid values for the cacheReadPrefetch parameter are TRUE or FALSE.
Re-create Snapshot
This command starts a new copy-on-write operation by using an existing
snapshot virtual disk. You can re-create a single snapshot virtual disk or re-
create multiple virtual disks.
NOTE: Refer to "Preparing Host Servers to Re-create a Snapshot Virtual Disk" on
page 75.
NOTICE: Before you create a new point-in-time image of a source virtual disk, stop
any data access (I/O) activity or suspend data transfer to the source virtual disk to
ensure that you capture an accurate point-in-time image of the source virtual disk.
Close all applications, including Windows® Internet Explorer®, to make sure all I/O
activity has stopped.
NOTE: Removing the drive letter of the associated virtual disk in Windows or
unmounting the virtual drive in Linux will help to guarantee a stable copy of the
drive for the Snapshot.
Syntax
recreate snapshot (virtualDisk [virtualDiskName] |
virtualDisks [virtualDiskName1 ...
virtualDiskNamen]) [userLabel=
"snapshotVirtualDiskName"
Parameters
Parameter Description
virtualDisk or virtualDisks Name of the specific virtual disk for which to start a
fresh copy-on-write operation. You can enter more
than one virtual disk name. You must put
brackets ([ ]) around the virtual disk name. If the
virtual disk name has special characters, you
must also put quotation marks (" ") around the
virtual disk name.
userLabel Name of the snapshot virtual disk. You must put
quotation marks (" ") around the snapshot virtual
disk name. If you enter more than one snapshot
virtual disk name, this command fails.
warningThresholdPercent Percentage of repository capacity at which you
receive a warning that the repository is nearing
full. Use integer values. For example, a value of
70 means 70 percent. The default value is
50 percent.
NOTE: If warningThresholdPercent is not
specified, the previously set value is used.
repositoryFullPolicy Specifies how snapshot processing continues if
the repository is full. You can choose to fail writes
to the source virtual disk (failSourceWrites) or
fail writes to the snapshot virtual disk
(failSnapShot). The default value is
failSnapShot.
NOTE: If repositoryFullPolicy is not specified, the
previously set value is used.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Syntax
remove virtualDiskCopy target [targetName] [source
[sourceName]]
Parameters
Parameter Description
target Name of the target virtual disk to remove. You must put
brackets ([ ]) around the target virtual disk name. If the target
virtual disk name has special characters, you must also put
quotation marks (" ") around the target virtual disk name.
source Name of the source virtual disk to remove. You must put
brackets ([ ]) around the source virtual disk name. If the
source virtual disk name has special characters, you must also
put quotation marks (" ") around the source virtual disk name.
Syntax
remove (allVirtualDisks | virtualDisk
["virtualDiskName"] |
virtualDisks ["virtualDiskName1" ...
"virtualDiskNamen"] | accessVirtualDisk)
lunMapping (host="hostName" | hostGroup=
"hostGroupName")
Parameters
Parameter Description
allVirtualDisks Removes the LUN mapping from all virtual disks.
virtualDisk or Name of the specific virtual disk to remove from the LUN
virtualDisks mapping. You can enter more than one virtual disk name. You
must put quotation marks (" ") and brackets ([ ]) around the
virtual disk name. The virtual disk name and quotation marks
must be inside the brackets.
accessVirtualDisk Removes the access virtual disk.
NOTICE: The host agent uses the access virtual disks to
communicate in-band with a storage array. If you remove
an access virtual disk mapping for a storage array from a
host that has an agent running on it, the storage
management software is no longer able to manage the
storage array through the in-band agent.
host Name of the host to which the virtual disk is mapped. You
must put quotation marks (" ") around the host name.
hostGroup Name of the host group that contains the host to which the
virtual disk is mapped. You must put quotation marks (" ")
around the host group name.
NOTE: You must use the host and hostGroup parameters when specifying a
nonaccess virtual disk or an access virtual disk. The script engine ignores the host
or hostGroup parameters when you use the allVirtualDisks or virtualDisks
parameters.
Syntax
repair virtualDisk [virtualDiskName] consistency
consistencyErrorFile=filename [verbose=(TRUE |
FALSE)]
Parameters
Parameter Description
virtualDisk Name of the specific virtual disk for which to repair
consistency. You must put brackets ([ ]) around the virtual
disk name. If the virtual disk name has special characters, you
must also put quotation marks (" ") around the virtual disk
name.
consistencyErrorFile Name of the file that contains the consistency error
information you use to repair the errors. You must put
quotation marks (" ") around the file name.
verbose Captures progress details, such as percent complete, and
shows the progress detail information as virtual disk
consistency is being repaired. To capture progress details, set
this parameter to TRUE. To prevent capturing progress
details, set this parameter to FALSE.
Syntax
reset controller [(0 | 1)]
Parameter Description
controller RAID controller module to reset. Valid RAID controller
module identifiers are 0 or 1, where 0 is the RAID controller
module on the left and 1 is the RAID controller module on
the right when viewed from the rear of the enclosure. You
must put brackets ([ ]) around the RAID controller module
identifier. If you do not specify an owner, the RAID controller
module firmware returns a syntax error.
Syntax
reset storageArray batteryInstallDate controller=
(0 | 1)
Parameters
Parameter Description
controller Specifies the RAID controller module that contains the
battery for which to reset the age. Valid RAID controller
module identifiers are 0 or 1, where 0 is the RAID controller
module on the left, and 1 is the RAID controller module on
the right when viewed from the rear of the enclosure. Use the
controller parameter only for RAID controller modules with
batteries.
NOTE: If you do not specify a RAID controller module, the age is reset for the
storage array battery or both RAID controller module batteries. If you specify a
RAID controller module, then the age for only that RAID controller module battery is
reset.
Syntax
reset storageArray iscsiStatsBaseline
Parameters
None.
NOTE: This command resets the baseline to 0 for both RAID controller modules in
the storage array. The purpose of resetting both of the RAID controller module
baselines is to help ensure that the counts are synchronized between the RAID
controller modules. If one RAID controller module resets but the second RAID
controller module does not reset, the host is informed that the RAID controller
modules are out of synchronization. The host is informed by the time stamps that
are reported with the statistics.
Example
-c "reset storageArray iscsiStatsBaseline;"
Syntax
reset storageArray SASPHYBaseline
Parameters
None.
Example
-c "delete host [\"job2900\"];"
Parameters
None.
NOTICE: Ensure that the multipath driver is running before you use this command,
or the virtual disk will not be accessible.
NOTE: Under certain host operating system environments, you might be required to
reconfigure the multipath host physical disk. You might also need to make operating
system modifications to recognize the new I/O path to the virtual disks.
Syntax
revive diskGroup [diskGroupNumber]
Parameters
Parameter Description
diskGroup Number of the disk group to be set to the Optimal state. You
must put brackets ([ ]) around the disk group number.
Parameters
Parameter Description
physicalDisk Identifies the enclosure and slot where the physical disk
resides. Enclosure ID values are 0 to 99. Slot ID values are 0
to 31. You must put brackets ([ ]) around the enclosure ID
value and the slot ID value.
Syntax
save allEnclosures logFile="filename"
Parameters
Parameter Description
logFile Name of the file to which to save the EMM log data. You
must put quotation marks (" ") around the file name.
Syntax
save physicalDiskChannel[(0 | 1)] faultDiagnostics
file=”filename”
Parameter Description
file The name of the file in which you are storing the results of
the fault isolation diagnostics test on the drive channel.
Enclose the name in double quotation marks (" ").
NOTE: A file extension is not automatically appended to the saved file. You must
specify the applicable format suffix for the file. If you specify a file extension of .txt,
then the output will be in a text file format. If you specify a file extension of .xml,
then the output will be in an XML file format.
Syntax
save allPhysicalDisks logFile="filename"
Parameters
Parameter Description
logFile Name of the file to which to write the log sense data. You
must put quotation marks (" ") around the file name.
Syntax
save controller [(0 | 1)] NVSRAM file="filename"
Parameter Description
controller RAID controller module with the NVSRAM values to save.
Valid RAID controller module identifiers are 0 or 1, where 0
is the RAID controller module on the left and 1 is the RAID
controller module on the right when viewed from the rear of
the enclosure. You must put brackets ([ ]) around the RAID
controller module identifier.
file Name of the file in which to save the values. You must put
quotation marks (" ") around the file name.
Syntax
save storageArray configuration file="filename"
[(allConfig | globalSettings=(TRUE | FALSE)
virtualDiskConfigAndSettings=(TRUE | FALSE)
hostTopology=(TRUE | FALSE)
lunMappings=(TRUE | FALSE))]
Parameters
Parameter Description
file Name of the file that contains the configuration values.
You must put quotation marks (" ") around the file
name.
allConfig Saves all of the configuration values to the file. (If you
choose this parameter, all of the configuration
parameters are set to TRUE.)
globalSettings Saves the global settings to the file. To save the global
settings, set this parameter to TRUE. To prevent saving
the global settings, set this parameter to FALSE. The
default value is TRUE.
NOTE: When you use this command, you can specify any combination of the
parameters for global setting, virtual disk configuration setting, host topology, or
LUN mapping. To enter all settings, use the allConfig parameter. The parameters are
optional; you do not have to enter any parameters.
Syntax
save storageArray (allEvents | criticalEvents)
file="filename" [count=numberOfEvents]
Parameters
Parameter Description
allEvents | criticalEvents Specifies whether to save all events (allEvents) or only
the critical events (criticalEvents).
file Name of the file to which to save the events. You must
put quotation marks (" ") around the file name.
Syntax
save storageArray iscsiStatistics [raw | baseline]
file="filename"
Parameters
Parameter Description
raw This parameter defines that the statistics collected are all statistics from
the RAID controller module start-of-day. Enclose the parameter in square
brackets ([ ]).
baseline This parameter defines that the statistics collected are all statistics from
the time the RAID controller modules were reset to zero using the reset
storageArray iscsiStatsBaseline command. Enclose the parameter in
square brackets ([ ]).
file The name of the file to which you want to save the performance statistics.
Enclose the file name in double quotation marks (" ").
NOTE: If you have not reset the iSCSI baseline statistics since the RAID controller
module start-of-day, the time at the start-of-day is the default baseline time.
NOTE: This command does not automatically append a file extension to the new
file. You must specify the file extension when you enter the file name.
Syntax
save storageArray performanceStats file="filename"
Parameters
Parameter Description
file Name of the file to which to save the performance
statistics. You must put quotation marks (" ") around
the file name.
Syntax
save storageArray SASPHYCounts file="filename"
Parameters
Parameter Description
file Name of the file to which to save the storage array SAS
PHY counters. You must put quotation marks (" ")
around the file name.
Syntax
save storageArray stateCapture file="filename"
Parameters
Parameter Description
file Name of the file to which to save the state capture. You
must put quotation marks (" ") around the file name.
Syntax
save storageArray supportData file="filename"
Parameters
Parameter Description
file Name of the file to which to save the storage array
support-related data. You must put quotation marks
(" ") around the file name.
Set Controller
This command defines the attributes for the RAID controller modules.
Syntax
set controller [(0 | 1)]
availability=(online | offline | serviceMode)
ethernetPort [1] = ethernet-port-options
globalNVSRAMByte [nvsramOffset]=
(nvsramByteSetting | nvsramBitSetting) |
hostNVSRAMByte [hostType, nvsramOffset]=
Parameters
Parameter Description
controller This parameter is the RAID controller module for which
you want to define properties. Valid identifiers for the
RAID controller module are 0 or 1, where 0 is the RAID
controller module on the left and 1 is the RAID controller
module on the right when viewed from the rear of the
RAID enclosure. You must put square brackets ([ ]) around
the identifier for the RAID controller module. If you do
not specify a RAID controller module, the firmware for the
RAID controller module returns a syntax error.
availability This parameter sets the mode for the RAID controller
module to online, offline, or serviceMode.
ethernetPort This parameter defines the attributes (options) for the
management Ethernet ports. Refer to Table 2-4 for a list of
the attributes that you can set.
NOTE: When you use this command, you can specify one or more of the
parameters. You do not, however, need to use all of the parameters.
NOTE: Setting availability to serviceMode causes the alternate RAID controller
module to take ownership of all virtual disks. The specified RAID controller module
no longer has any virtual disks and refuses to take ownership of any more virtual
disks. Service mode is persistent across reset and power cycles until the
availability parameter is set to online.
NOTE: Use the show controller NVSRAM command to display parts or all of the
NVSRAM.
Additional Information
The maxFramePayload option is shared between IPv4 and IPv6. The payload
portion of a standard Ethernet frame is set at 1500, and a jumbo Ethernet
frame is set at 9000. When using jumbo frames, all of the devices that are in
the network path should be capable of handling the larger frame size.
You must set the enableIPv4 parameter or the enableIPv6 parameter to
TRUE to make sure that the specific IPv4 setting or the specific IPv6 setting
is applied.
When the duplexMode parameter is set to TRUE, the selected Ethernet port
is set to full duplex. The default value is half duplex (the duplexMode
parameter is set to FALSE).
The portSpeed parameter is expressed as megabits per second (Mb/s).
The IPv6 address space is 128 bits. It is represented by eight 16-bit
hexadecimal blocks separated by colons. You may drop leading zeros, and you
may use a double colon to represent consecutive blocks of zeroes.
The default value for the IPv6HopLimit parameter is 64.
The default value for the IPv6NdReachableTime parameter is
30000 milliseconds.
Examples
-c "set controller [0] iscsiHostPort[0]
IPV6LocalAddress=
FE80:0000:0000:0000:0214:22FF:FEFF:EFA9 enableIPV6=
TRUE;"
-c "set controller [0] iscsiHostPort[0]
IPV6ConfigurationMethod=auto enableIPV6=TRUE;"
-c "set controller [0] availability=online;"
-c "set controller [0] ethernetPort[1] IPV4Address=
192.168.0.101;"
-c "set controller [0] iscsiHostPort[1]
IPV4SubnetMask=255.255.255.0 enableIPV4;"
-c "set controller [0] iscsiHostPort[1]
IPV4GatewayIP=192.168.0.1 enableIPV4;"
Syntax
set diskGroup [diskGroupNumber] addPhysicalDisks=
(trayID1,slotID1
... trayIDn,slotIDn) raidLevel=(0 | 1 | 5 | 6)
owner=(0 | 1)
availability=(online | offline)
Parameter Description
diskGroup Sequence number of the disk group for which to set properties.
You must put brackets ([ ]) around the disk group number.
addPhysicalDisks Identifies the physical disk by tray and slot location to include in
the disk group. Tray ID values are 0 to 99. Slot ID values are 0
to 31. You must put parentheses around the tray ID values and the
slot ID values.
raidLevel RAID level for the disk group. Valid values are 0, 1, 5, or 6.
owner RAID controller module that owns the disk group. Valid RAID
controller module identifiers are 0 or 1, where 0 is the RAID
controller module on the left and 1 is the RAID controller module
on the right when viewed from the rear of the enclosure. Use this
parameter only if you want to change the disk group owner.
availability Setting for the disk group, which is either online or offline.
NOTE: When using this command, you can specify one or more of the parameters.
You do not, however, need to use all of the parameters. Using two many parameters
can cause host I/O errors or result in internal controller reboots because the time
period ends before the disk group definition is set.
NOTE: The addPhysicalDisks or raidLevel operations cannot be stopped once they
have been initiated.
NOTE: The time required to complete the addPhysicalDisks or raidLevel operations
is dependent on the number and size of the disks used.
Syntax
set enclosure [enclosureID] (chassisName |
assetTag)= "userID"
Parameter Description
enclosure Identifies a specific enclosure for which to set the attribute.
Enclosure ID values are 0 to 99. You must put brackets ([ ])
around the enclosure ID value.
chassisName Chassis name or number to give the new enclosure. Chassis names
can be any combination of alphanumeric characters with a
maximum length of 32 characters. Alphabetical characters can be
uppercase or lowercase. You can also use the underscore character
(_) and the hyphen (-) character. You cannot use spaces in a chassis
name. You must put quotation marks (" ") around the chassis
name.
assetTag Asset tag name or number to give the new enclosure. Asset tags
can be any combination of alphanumeric characters with a
maximum length of ten characters. Alphabetical characters can be
uppercase or lowercase. You can also use the underscore character
(_) and the hyphen (-) character. You cannot use spaces in an asset
tag name. You must put quotation marks (" ") around the asset tag
name.
Syntax
set enclosure ["Service Tag"] id=enclosureID
Parameters
Parameter Description
enclosure Service tag of the RAID enclosure or the
expansion enclosure for which you are setting the
enclosure ID. You must put quotation marks (" ")
around the Service Tag.
id Specifies the value for the RAID enclosure or
expansion enclosure ID. Valid values are 00
through 99. You do not need to put parentheses
around the enclosure ID value.
Syntax
set (physicalDisk [trayID,slotID] |
allPhysicalDisks) nativeState
Parameters
Parameter Description
physicalDisk The tray and the slot where the physical disk
resides. Tray ID values are 0 to 99. Slot ID values
are 0 to 31. Enclose the tray ID values and the
slot ID values in square brackets ([ ]).
allPhysicalDisks Selects all the physical disks.
Set Host
This command assigns a host to a host group or moves a host to a different
host group. You can also create a new host group and assign the host to the
new host group with this command. The actions performed by this command
depend on whether the host has individual virtual disk-to-LUN mappings or
does not have individual virtual disk-to-LUN mappings.
Syntax
set host [hostName]
hostGroup=("hostGroupName" | none | defaultGroup)
userLabel="newHostName"
hostType=(hostTypeIndexLabel |
hostTypeIndexNumber)
Parameter Description
host The name of the host that you want to assign to a host group.
Enclose the host name in square brackets ([ ]). If the host name has
special characters, you must also enclose the host name in double
quotation marks (" ").
hostGroup The host group to which you want to assign the host. (The following
table defines how the command runs if the host does or does not
have individual virtual disk-to-LUN mappings.) Enclose the host
group name in double quotation marks (" "). The defaultGroup is
the host group that contains the host to which the virtual disk is
mapped.
userLabel The new host name. Enclose the host name in double quotation
marks (" ").
hostType The index label or number of the host type for the HBA host port.
Use the show storageArray hostTypeTable command to
generate a list of available host type identifiers. If the host type has
special characters, enclose it in double quotation marks (" ").
Host Group Parameter Host Has Individual Virtual Host Does Not Have Individual
Disk-to-LUN Mappings Virtual Disk-to-LUN Mappings
hostGroupName The host is removed from The host is removed from the
the present host group and is present host group and is
placed under the new host placed under the new host
group defined by group defined by
hostGroupName. hostGroupName.
none The host is removed from The host is removed from the
the host group as an present host group and is
independent partition and is placed under the default
placed under the root node. group.
defaultGroup The command fails. The host is removed from the
present host group and is
placed under the default
group.
Examples
-c "set host [job2900] hostGroup=none userLabel=
\"job2900\" hostType=0;"
-c "set host [\"pe2900\"] userLabel=\"pe2901\";"
Syntax
set hostGroup [hostGroupName] userLabel=
"newHostGroupName"
Parameters
Parameter Description
hostGroup Name of the host group to rename. You must put
brackets ([ ]) around the host group name. If the
host group name has special characters, you must
also put quotation marks (" ") around the host
group name.
userLabel New name for the host group. You must put
quotation marks (" ") around the host group
name.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Syntax
set hostPort [portLabel] host=“hostName”
userLabel=“newPortLabel”
Parameters
Parameter Description
hostPort The name of the HBA host port for which you want to change the
host type, or for which you want to create a new name. Enclose the
HBA host port name in square brackets ([ ]). If the HBA host port
label has special characters, enclose the HBA host port label in
double quotation marks (" ").
host The name of the host to which the HBA host port is connected.
Enclose the host name in double quotation marks (" ").
userLabel The new name that you want to give to the HBA host port. Enclose
the new name of the HBA host port in double quotation marks (" ").
NOTE: When you use this command, you can specify one or more of the optional
parameters. You do not, however, need to use all of the parameters.
NOTE: You can use any combination of alphanumeric characters, hyphens, and
underscores for the names. Command names can have a maximum of 30
characters. If you exceed the maximum character limit, replace square brackets
([ ]) with angle brackets (< >) to overcome this limitation.
Syntax
set iscsiInitiator iscsiName = new-iSCSI-ID |
userLabel = new-name | host = new-host-name |
chapSecret = new-password
Parameter Description
iscsiName The name of the iSCSI initiator for which you want to set
attributes.
userLabel The new name that you want to use for the iSCSI initiator.
host The name of the new host to which the HBA host port is connected.
Enclose the host name in double quotation marks (" ").
chapSecret The password that you want to use to authenticate a peer
connection.
Examples
-c "set iscsiInitiator [\"pe29000\"] userLabel=
\"pe29001\";"
-c "set iscsiInitiator <\"iqn.1991-
05.com.microsoft:svctag-70wnh91\"> userLabel=
\"29000\";"
-c "show iscsiInitiator[\"pe29000\"]
iscsiSessions;"
-c "show iscsiInitiator <\"iqn.1991-
05.com.microsoft:svctag-70wnh91\">
iscsiSessions;"
Parameters
Parameter Description
authenticationMethod The means of authenticating your iSCSI
session.
chapSecret The password that you want to use to
authenticate a peer connection.
isnsRegistration The means of listing the iSCSI target on
the iSNS server. Set the parameter to
TRUE to list it.
targetAlias The name that you want to use for the
target.
Examples
-c "set iscsiTarget <\"iqn.1984-
05.com.dell:powervault.
6001372000f5f0e600000000463b9292\">
authenticationMethod = none;"
-c "set iscsiTarget [\"iscsi2900\"] targetAlias =
\"iscsi2902\";"
Syntax
set physicalDiskChannel [( 1 | 2 )] status=
(optimal | degraded)
Parameters
Parameter Description
physicalDiskChannel Identifier number of the physical disk channel for which to
set the status. Valid physical disk channel values are 1 or 2.
You must put brackets ([ ]) around the physical disk channel
number.
status Condition of the channel. You can set the channel status to
optimal or degraded.
NOTE: Use the optimal parameter to move a degraded
channel back to the Optimal state. Use the degraded
parameter if the channel is experiencing problems, and the
storage array requires additional time for data transfers.
Syntax
set (physicalDisk [enclosureID,slotID] |
physicalDisks [enclosureID0,slotID0 ...
enclosureIDn,slotIDn]) hotSpare=(TRUE | FALSE)
Parameter Description
physicalDisk or Identifies the enclosure and slot where the physical disk
physicalDisks resides. Enclosure ID values are 0 to 99. Slot ID values
are 0 to 31. You must put brackets ([ ]) around the
enclosure ID values and the slot ID values.
hotSpare Assigns the physical disk as the hot spare. To assign the
physical disk as the hot spare, set this parameter to
TRUE. To remove a hot spare assignment from a
physical disk, set this parameter to FALSE.
Syntax
set physicalDisk [enclosureID,slotID]
operationalState=failed
Parameters
Parameter Description
physicalDisk Identifies the enclosure and slot where the physical disk
resides. Enclosure ID values are 0 to 99. Slot ID values
are 0 to 31. You must put brackets ([ ]) around the
enclosure ID value and the slot ID value.
Syntax
set controller [(0 | 1)] availability=(online |
offline |
serviceMode) | ethernetPort [(1 | 2)]=
ethernetPortOptions |
Parameters
Parameter Description
controller The RAID controller module for which you want to
define properties. Valid identifiers for the RAID
controller module are 0 or 1, where 0 is the RAID
controller module on the left, and 1 is the RAID
controller module on the right when viewed from the
rear of the enclosure. Enclose the identifier for the RAID
controller module in square brackets ([ ]). If you do not
specify a RAID controller module, the firmware for the
RAID controller module returns a syntax error.
availability The mode for the RAID controller module, which you
can set to online, offline, or serviceMode (service).
ethernetPort The attributes (options) for the management Ethernet
ports. The entries to support this parameter are listed in
"Syntax Element Statement Data" on page 185”. Many
settings are possible, including setting the IP address,
the gateway address, and the subnet mask address.
globalNVSRAMByte A portion of the RAID controller module NVSRAM.
Specify the region to be modified using the starting byte
offset within the region, and the size and value of the
new data to be stored into NVSRAM.
hostNVSRAMByte The NVSRAM for the host-specific region. The setting
specifies the host index for the specific host, the starting
offset within the region, the number of bytes, and the
values to be written.
ethernetPort Options
IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-
FFFF):(0-
FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
IPv6RoutableAddress=(0-FFFF):(0-FFFF):(0-
FFFF):(0-FFFF):(0-
FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
IPv6RouterAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-
FFFF):(0-
FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
IPv4Address=(0-255).(0-255).(0-255).(0-255) |
IPv4ConfigurationMethod=[(static | dhcp)] |
iscsiHostPort Options
The following options are available for the iscsiHostPort parameter.
IPv4Address=(0-255).(0-255).(0-255).(0-255) |
IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-
FFFF):(0-
FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
IPv6RoutableAddress=(0-FFFF):(0-FFFF):(0-
FFFF):(0-FFFF):(0-
FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
IPv6RouterAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0-
FFFF):(0-
FFFF):(0-FFFF):(0-FFFF):(0-FFFF) |
enableIPv4=(TRUE | FALSE) |
enableIPv6=(TRUE | FALSE) |
iscsiHostPort Options
enableIPv4Vlan=(TRUE | FALSE) |
enableIPv6Vlan=(TRUE | FALSE) |
enableIPv4Priority=(TRUE | FALSE) |
enableIPv6Priority=(TRUE | FALSE) |
IPv4ConfigurationMethod=(static | dhcp) |
IPv6ConfigurationMethod=(static | auto) |
IPv4GatewayIP=(TRUE | FALSE) |
IPv6HopLimit=[0-255] |
Additional Information
When you use this command, you can specify one or more of the parameters.
You do not need to use all of the parameters. Setting the availability
parameter to serviceMode causes the alternate RAID controller module to
take ownership of all of the virtual disks. The specified RAID controller
module no longer has any virtual disks and refuses to take ownership of any
more virtual disks. Service mode is persistent across reset cycles and power
cycles until the availability parameter is set to online.
Use the show controller NVSRAM command to show the NVSRAM
information. The maxFramePayload option is shared between IPv4 and IPv6.
The payload portion of a standard Ethernet frame is set at 1500, and a jumbo
Ethernet frame is set at 9000. When using jumbo frames, all of the devices
that are in the network path should be capable of handling the larger frame
size.
You must set the enableIPv4 parameter or the enableIPv6 parameter to TRUE
to make sure that the specific IPv4 setting or the specific IPv6 setting is
applied.
When the duplexMode parameter is set to TRUE, the selected Ethernet port
is set to full duplex. The default value is half duplex (the duplexMode
parameter is set to FALSE).
Set Session
This command defines how you want the current script engine session to run.
Syntax
set session errorAction=(stop | continue)
password="storageArrayPassword"
performanceMonitorInterval=intervalValue
performanceMonitorIterations=iterationValue
Parameters
Parameter Description
errorAction Specifies how the session responds if an error is
encountered during processing. You can choose to
stop the session if an error is encountered, or you can
continue after encountering an error. The default
error action is to stop. (This parameter defines the
action for execution errors, not syntax errors. Some
error conditions might override the continue value.)
NOTE: When using this command, you can specify one or more of the parameters.
You do not, however, need to use all of the parameters.
Syntax
set (virtualDisk [virtualDiskName] |
virtualDisks [virtualDiskName1 ...
virtualDiskNamen]) userLabel=
Parameters
Parameter Description
virtualDisk or virtualDisks Name of the specific snapshot virtual disk for
which to define properties. (You can enter more
than one snapshot virtual disk name by using the
virtualDisks parameter). You must put quotation
marks (" ") and brackets ([ ]) around the
snapshot virtual disk name. The snapshot virtual
disk name and quotation marks must be inside
the brackets.
userLabel New name to give to a snapshot virtual disk. You
must put quotation marks (" ") around the new
snapshot virtual disk name.
warningThresholdPercent Percentage of repository capacity at which a
warning is given that the repository is nearing
full. Use integer values. For example, a value of
70 means 70 percent. The default value is 50.
NOTE: You can set this parameter for both the
repository virtual disk and snapshot virtual disk.
repositoryFullPolicy Specifies the desired method of snapshot
processing if the repository is full. You can choose
to fail writes to the source virtual disk
(failSourceWrites) or fail writes to the snapshot
virtual disk (failSnapShot). The default value is
failSnapShot.
NOTE: You can set this parameter for both the
repository virtual disk and snapshot virtual disk.
NOTE: When using this command, you can specify one or more of the optional
parameters. You do not, however, need to use all of the parameters.
Syntax
set storageArray cacheBlockSize=
cacheBlockSizeValue failoverAlertDelay=delayValue
mediaScanRate=(disabled | 1-30) |
password="password" |
userLabel="storageArrayName"
Parameters
Parameter Description
cacheBlockSize Specifies the cache block size used by the RAID
controller module for managing the cache. Valid
values are 4 (4 KB) or 16 (16 KB), the default
value is 4.
NOTE: Typically, this parameter should not be
changed from the default. The default setting has
been set based on best performance for all
environments.
NOTE: When defining cache block sizes, the 4-KB
cache block size is best suited for systems that
require I/O streams that are typically small and
random. The 16-KB cache block size is more useful
for systems that require large data transfer,
sequential, high bandwidth applications. This
parameter defines the cache block size for all
virtual disks in the storage array. For redundant
configurations, this parameter includes all virtual
disks owned by both controllers within the storage
array.
NOTE: When using this command, you can specify one or more of the optional
parameters. You do not, however, need to use all of the parameters.
Syntax
set storageArray enclosurePositions=(enclosure-id-
list)
Parameter Description
enclosurePositions List of enclosure IDs. The sequence of the
module IDs in the list define the positions for
the RAID enclosure and expansion enclosures in
a storage array. Valid values are 0 to 99. Separate
the enclosure ID values with a space, and put
parentheses around the list of enclosure IDs.
NOTE: This command defines the position of an enclosure in a storage array by the
position of the enclosure ID in the enclosurePositions list. For example, if you have
a RAID enclosure with an ID set to 84 and expansion enclosures with IDs set to 1
and 12, the enclosurePositions sequence (84 1 12) places the RAID enclosure in the
first position, expansion enclosure 1 in the second position, and expansion
enclosure 12 in the third position. The enclosurePositions sequence (1 84 12) places
the RAID enclosure in the second position, expansion enclosure 1 in the first
position, and expansion enclosure 12 in the third position.
Syntax
set storageArray icmpPingResponse = (TRUE | FALSE)
Parameter
Parameter Description
icmpPingResponse This parameter turns on or turns off Echo Request messages.
Set the parameter to TRUE to turn on Echo Request
messages. Set the parameter to FALSE to turn off Echo
Request messages.
NOTE: The Internet Control Message Protocol (ICMP) is used by operating systems
in a network to send error messages, such as a requested service is not available
or that a host or router could not be reached. The ICMP response command sends
Example
-c "set storageArray icmpPingResponse = TRUE;"
Syntax
set storageArray isnsIPV4ConfigurationMethod =
[static | dhcp] isnsIPV4Address = ipv4-address
Parameters
Parameter Description
isnsIPV4Configuration Method The method that you want to use to
define the iSNS server configuration. You
can enter the IP address for the IPv4 iSNS
servers by selecting static. For IPv4,
you can choose to have a Dynamic Host
Configuration Protocol (DHCP) server
select the iSNS server IP address by
entering dhcp. To enable DCHP, you
must set the isnsIPV4Address IP address
to 0.0.0.0.
isnsIPV4Address The IP address that you want to use for
the iSNS server. Use this parameter with
the static argument for IPv4
configurations. If you choose to have a
DHCP server set the IP address for an
IPv4 IP iSNS server, you must set the
isnsIPV4Address IP address to 0.0.0.0.
Example
-c "set storageArray isnsIPV4ConfigurationMethod =
static isnsIPV4Address = 192.168.0.1;"
Syntax
set storageArray isnsIPV6Address=ipv6-address
Parameter
Parameter Description
isnsIPV6Address IPv6address you want to use for the iSNS
server
NOTE: The iSNS protocol facilitates the automated discovery, management, and
configuration of iSCSI and Fibre Channel devices on a TCP/IP network. The iSNS
protocol provides intelligent storage discovery and management services
comparable to those found in Fibre Channel networks, allowing a commodity IP
network to function in a similar capacity as a storage area network. The iSNS
protocol also facilitates a seamless integration of IP and Fibre Channel networks,
due to its ability to emulate Fibre Channel fabric services, and manage both iSCSI
and Fibre Channel devices.
Syntax
set storageArray isnsListeningPort = integer
Parameter Description
isnsListeningPort The IP address that you want to use for
the iSNS server listening port. The range
of values for the listening port is 49152 to
65535. The default value is 3205.
NOTE: A listening port resides on the database server and is responsible for
listening (monitoring) for incoming client connection requests and managing the
traffic to the server
NOTE: When a client requests a network session with a server, a listener receives
the actual request. If the client information matches the listener information, then
the listener grants a connection to the database server.
Example
-c "set storageArray isnsListeningPort = 3205;"
Syntax
set storageArray isnsServerRefresh
Parameters
None.
NOTE: If the DHCP server is not operating at full capability, or if the DHCP server is
unresponsive, the refresh operation can take between two and three minutes to
complete.
NOTE: The set storageArray isnsServerRefresh command returns an error if you
did not set the configuration method to DHCP. To set the configuration method to
DHCP, use the set storageArray isnsIPV4ConfigurationMethod command.
Example
-c "start storageArray isnsServerRefresh ;"
Syntax
set storageArray learnCycleDate
(daysToNextLearnCycle=integer-literal | day=
string-literal) time=HH:MM
Parameters
Parameter Description
daysToNextLearnCycle Valid values are 0 through 7, where 0 is immediately and 7
is in seven days. The daysToNextLearnCycle parameter
takes place up to seven days after the next scheduled learn
cycle
day Valid values include the days of the week (Sunday, Monday,
Tuesday, Wednesday, Thursday, Friday, and Saturday).
Setting the day causes the next learn cycle to be scheduled
on the specified day, after the currently scheduled learn
cycle.
time The time in 24-hour format; for example 8:00 a.m. is
entered as 08:00. Nine o’clock p.m. is entered as 21:00, and
9:30 p.m. is entered as 21:30.
NOTE: You can set the learn cycle to occur only once during a seven-day period.
The time parameter selects a specific time that you want to run the learn cycle. If a
value is not entered, the command uses a default value of 00:00 (midnight). If the
day and time specified are in the past, the next learn cycle takes place on the next
possible day specified.
Parameters
None.
Syntax
set iscsiTarget unnamedDiscoverySession = (TRUE |
FALSE)
Parameter
Parameter Description
unnamedDiscoverySession This parameter turns on or turns off
unnamed discovery sessions. Set the
parameter to TRUE to turn on an
unnamed discovery sessions. Set the
parameter to FALSE to turn off an
unnamed discovery sessions.
NOTE: Discovery is the process where initiators determine the targets that are
available. Discovery occurs at power-on/initialization and also if the bus topology
changes, for example, if an extra device is added.
NOTE: An unnamed discovery session is a discovery session that is established
without specifying a target ID in the login request. For unnamed discovery sessions,
neither the target ID or the target portal group ID are available to the targets.
Parameter Description
allVirtualDisks Specifies the properties for all virtual disks in the
storage array.
virtualDisk or virtualDisks Specifies the name of the virtual disk for which to
(name) define properties. You can enter more than one virtual
disk name if you use the virtualDisks parameter. You
must put quotation marks (" ") and brackets ([ ])
around the virtual disk name. The virtual disk name
and quotation marks must be inside the brackets.
virtualDisk Specifies the WWID of the virtual disk for which you
(wwid) are setting properties. You can use the WWID instead
of the virtual disk name to identify the virtual disk. You
must put angle brackets (< >) around the WWID.
mediaScanEnabled Turns media scan for the virtual disk on or off. To turn
media scan on, set to TRUE. To turn media scan off,
set to FALSE. If media scan is disabled at the storage
array level, this parameter has no effect.
mirrorCacheEnabled Turns the mirror cache on or off. The default setting is
TRUE. To turn the mirror cache off, set this parameter
to FALSE.
NOTE: Data loss can occur if a RAID controller module
fails when cache mirroring is set to FALSE on the virtual
disks owned by the failed controller.
modificationPriority Specifies the priority for virtual disk modifications
while the storage array is operational. Valid entries are
highest, high, medium, low, or lowest.
NOTE: The ModificationPriority parameter defines the
amount of system resources used when modifying virtual
disk properties. If you select the highest priority level, the
virtual disk modification uses the most system resources,
which decreases performance for host data transfers.
NOTE: When using this command, you can specify one or more of the parameters.
You do not, however, need to use all of the parameters.
NOTE: You can apply the addCapacity, segmentSize, userLabel, and
logicalUnitNumber parameters to only one virtual disk at a time.
NOTE: Setting the addCapacity, addPhysicalDisks, or segmentSize parameter
starts a long-running operation that you cannot stop. These long-running
operations are performed in the background and do not prevent you from running
other commands. To display the progress of long-running operations, use the show
virtualDisk actionProgress command.
Syntax
set virtualDiskCopy target [targetName] [source
[sourceName]] copyPriority=(highest | high |
medium | low | lowest) targetReadOnlyEnabled=(TRUE
| FALSE)
Parameters
Parameter Description
target Specifies the name of the target virtual disk for which
to define properties. You must put brackets ([ ])
around the target virtual disk name. If the target virtual
disk name has special characters, you must also put
quotation marks (" ") around the target virtual disk
name.
source Specifies the name of the source virtual disk for which
to define properties. You must put brackets ([ ])
around the source virtual disk name. If the source
virtual disk name has special characters, you must also
put quotation marks (" ") around the source virtual disk
name.
copyPriority Specifies the priority that the virtual disk copy has
relative to host I/O activity. Valid entries are highest,
high, medium, low, or lowest.
targetReadOnlyEnabled Specifies whether the target virtual disk is write
enabled or read only. To be able to write to the target
virtual disk, set to FALSE. To prevent writing to the
target virtual disk, set to TRUE.
NOTE: When using this command, you can specify one or more of the parameters.
You do not, however, need to use all of the parameters.
Parameters
Parameter Description
iscsiInitiatorName The name of the iSCSI initiator for which you want to
obtain session information. Enclose the iSCSI initiator
name in square brackets ([ ]).
iscsiTargetName The name of the iSCSI target for which you want to obtain
session information. Enclose the iSCSI target name in
square brackets ([ ]).
NOTE: If you enter this command without defining any arguments, this command
returns information about all iSCSI sessions that are currently running. To limit the
information returned, enter a specific iSCSI initiator or a specific iSCSI target. This
command then returns information about the session for only the iSCSI initiator or
the iSCSI target that you named.
Syntax
show diskGroup [diskGroupNumber]
Parameter Description
diskGroup Number of the disk group for which to display
information. You must put brackets ([ ]) around
the disk group number.
Syntax
show allHostPorts
Parameters
None.
Example
-c "show allHostPorts;"
Syntax
show (allPhysicalDisks [physicalDiskType=
(SAS | SATA)] |
physicalDisk [enclosureID,slotID] |
physicalDisks [enclosureID0,slotID0 ...
enclosureIDn,slotIDn])
[summary]
Parameters
Parameter Description
allPhysicalDisks Returns information about all physical disks in
the storage array.
NOTE: To determine information about the type
and location of all physical disks in the storage
array, use the allPhysicalDisks parameter.
physicalDiskType Specifies the type of physical disk for which to
retrieve information. Valid physical disk types are
SAS or SATA.
NOTE: To determine the information about the SAS
or SATA physical disks in the storage array, use the
physicalDiskType parameter.
Syntax
show (physicalDiskChannel [(1 | 2 )] |
physicalDiskChannels [(1 | 2 ) ... (1n | 2n )] |
allPhysicalDiskChannels) stats
Parameters
Parameter Description
physicalDiskChannel Identifier number of the physical disk channel
for which to display information. Valid physical
disk channel values are 1 or 2. You must put
brackets ([ ]) around the physical disk channel
values.
Syntax
show allPhysicalDisks downloadProgress
Parameters
None.
NOTE: When all firmware downloads have successfully completed, this command
returns a Successful status. If any firmware downloads fail, this command shows
the firmware download status of each targeted physical disk. This command returns
the status values shown in the following table.
Status Definition
Successful Downloads completed without errors.
Not Attempted Downloads did not start.
Partial Download Downloads are in progress.
Failed Downloads completed with errors.
Syntax
show (allControllers | controller [(0 | 1)])
[summary]
Parameters
Parameter Description
allControllers Returns information about both RAID controller modules in the
storage array.
controller Returns information about a specific RAID controller module in
the storage array. Valid RAID controller module identifiers are 0
or 1, where 0 is the RAID controller module on the left and 1 is
the RAID controller module on the right when viewed from the
rear of the enclosure. You must put brackets ([ ]) around the
RAID controller module identifier.
NOTE: The detailed RAID controller module information is also
returned for the show storageArray command.
summary Returns a concise list of information about both RAID
controller modules in the storage array.
NOTE: When you use the summary parameter, the command
returns the list of information without the physical disk channel and
host channel information.
Parameters
Parameter Description
allControllers Returns information about both RAID controller modules in the
storage array.
controller Returns information about a specific RAID controller module in
the storage array. Valid RAID controller module identifiers are 0
or 1, where 0 is the RAID controller module on the left and 1 is
the RAID controller module on the right when viewed from the
rear of the enclosure. You must put brackets ([ ]) around the
RAID controller module identifier.
hostType Specifies the index label or number of the host type. Use the
show storageArray hostTypeTable command to generate a list of
available host type identifiers.
host Specifies the name of the host connected to the RAID controller
modules. You must put quotation marks (" ") around the host
name.
NOTE: Use the show controller NVSRAM command to display parts or all of the
NVSRAM before using the set controller command to change NVSRAM values.
Parameters
Parameter Description
profile Displays all properties of the logical and physical components
that comprise the storage array. The information returned takes
several screens to display.
NOTE: The profile parameter returns detailed information about the
storage array. The information covers several screens on a display.
You might need to increase the size of your display buffer to see all
the information. Because this information is so detailed, you might
want to save the output of this parameter to a file. To save the
output to a file, enter the show storageArray command similar to
the following:
smcli 123.45.67.89 -c "show storagearray
profile;" -o "c:\\folder\\storagearray
profile.txt"
NOTE: The previous command syntax is for a host running
Windows. The actual syntax varies depending on your operating
system.
batteryAge Displays the status, the age of the battery in days, and the
number of days until the battery needs to be replaced.
connections Displays a list of the drive channel port locations and the drive
channel connections.
defaultHostType Displays the default host type and host type index.
healthStatus Displays the health, logical properties, and physical component
properties of the storage array.
hostTypeTable Displays a table of all host types known to the RAID controller
module. Each row in the table displays a host type index and the
platform the index represents.
hotSpareCoverage Displays information about which virtual disks of the storage
array have hot spare coverage and which virtual disks do not.
NOTE: When you save the information to a file, you can use the information as a
record of your configuration and as an aid during recovery.
Syntax
show storageArray autoConfiguration
[physicalDiskType=(SAS | SATA)
raidLevel=(0 | 1 | 5 | 6)
diskGroupWidth=numberOfPhysicalDisks
diskGroupCount=numberOfDiskGroups
virtualDisksPerGroupCount=
numberOfVirtualDisksPerGroup hotSpareCount=
numberOfHotspares
segmentSize=segmentSizeValue]
Parameter Description
physicalDiskType Type of physical disk to use for the storage array. Valid
physical disk types are SAS or SATA. The
physicalDiskType parameter is not required if only one
type of physical disk is in the storage array. This
parameter is not required if only one type of physical
disk is in the storage array.
raidLevel RAID level of the disk group that contains the physical
disks in the storage array. Valid RAID levels are 0, 1, 5
or 6.
diskGroupWidth Number of physical disks in a disk group in the storage
array. This number depends on the capacity of the
physical disks. Integer values are required. For
information about the number of physical disks that
you can use in a disk group, see "Enclosure Loss
Protection" on page 52.
diskGroupCount Number of disk groups in the storage array. Use integer
values.
virtualDisksPerGroupCount Number of equal-capacity virtual disks per disk group.
Use integer values.
hotSpareCount Number of hot spares desired in the storage array. Use
integer values. For information about hot spares, see
"Assigning Global Hot Spares" on page 59.
segmentSize Amount of data (in kilobytes) that the RAID controller
module writes on a single physical disk in a virtual disk
before writing data on the next physical disk. Valid
values are 8, 16, 32, 64, 128, 256, or 512. For
information about the segmentSize parameter, see
"Using the Auto Configure Command" on page 53.
Syntax
show storageArray hostTopology
Parameters
None.
Syntax
show storageArray lunMappings [host ["hostName"] |
hostgroup ["hostGroupName"]]
Parameters
Parameter Description
host Name of a specific host for which to see the LUN mappings.
You must put quotation marks (" ") and brackets ([ ]) around
the host name. The host name and quotation marks must be
inside the brackets.
hostGroup Name of a specific host group for which to see the LUN
mappings. You must put quotation marks (" ") and brackets
([ ]) around the host group name.The host group name and
quotation marks must be inside the brackets.
Parameters
None.
NOTE: Information returned includes RAID controller module default settings
(settings that are the starting point for negotiation), and the current active settings.
Example
-c "show storageArray iscsiNegotiationDefaults;"
Syntax
show storageArray pendingTopology
Parameters
None.
Syntax
show storageArray unreadableSectors
Parameters
None.
Show String
This command shows a string of text from a script file. This command is
similar to the echo command in the MS DOS and Linux operating systems.
Syntax
show "string"
Parameters
None.
NOTE: You must put quotation marks (" ") around the string.
Syntax
show storageArray
unconfiguredIscsiInitiators
Example
-c "show storageArray
unconfiguredIscsiInitiators;"
Syntax
show (allVirtualDisks | virtualDisk
[virtualDiskName] |
virtualDisks [virtualDiskName1 ...
virtualDiskNamen]) [summary]
Parameters
Parameter Description
allVirtualDisks Returns information about all virtual disks in the storage
array.
virtualDisk or Specifies the name of the specific virtual disk from which
virtualDisks to retrieve information. You can enter more than one
virtual disk name. You must put brackets ([ ]) around the
virtual disk name. If the virtual disk name has special
characters, you must also put quotation marks (" ") around
the virtual disk name.
summary Returns a concise list of information about the virtual
disks.
Syntax
show virtualDisk ["virtualDiskName"]
actionProgress
Parameter Description
virtualDisk Name of the virtual disk running the long-running
operation. You must put quotation marks (" ") and
brackets ([ ]) around the virtual disk name. The virtual
disk name and quotation marks must be inside the
brackets.
Syntax
show virtualDiskCopy (allVirtualDisks |
source ["sourceName"] |
target ["targetName"])
Parameters
Parameter Description
allVirtualDisks Returns information about virtual disk copy operations for all
virtual disk copy pairs.
source Name of the source virtual disk about which to retrieve
information. You must put quotation marks (" ") and brackets ([ ])
around the source virtual disk name. The source virtual disk name
and quotation marks must be inside the brackets.
Syntax
show virtualDiskCopy sourceCandidates
Parameters
None.
Syntax
show virtualDiskCopy source ["sourceName"]
targetCandidates
Parameters
Parameter Description
source Name of the source virtual disk for which you are trying to find a
candidate target virtual disk. You must put quotation marks (" ")
and brackets ([ ]) around the source virtual disk name. The source
virtual disk name and quotation marks must be inside the brackets.
Parameters
Parameter Description
diskGroup The number of the disk group for which you want to show
information. Enclose the disk group number in square brackets ([ ])
cancelImport The setting to spin the physical disks back down after the disk
group dependencies have been read. To spin down the physical
disks, set this parameter to TRUE. To let the physical disks stay
spinning, set this parameter to FALSE.
NOTE: This command returns the dependencies of a specific disk group, which
must be in an Exported state or a Forced state. If a decision is made to retain the
listed dependencies, then the cancelImport parameter can be enforced to spin the
physical disks back down.
NOTE: The show diskGroup importDependencies command must be run before the
start diskGroup import command.
Syntax
show (allVirtualDisks | virtualDisk
[virtualDiskName] |
virtualDisks [virtualDiskName1 ...
virtualDiskNamen] performanceStats
Parameter Description
allVirtualDisks Returns performance statistics for all of the virtual disks in
the storage array.
virtualDisk or Name of the specific virtual disk for which you are retrieving
virtualDisks performance statistics. You can enter more than one virtual
disk name. You must put brackets ([ ]) around the virtual
disk name. If the virtual disk name has special characters,
you must also put quotation marks (" ") around the virtual
disk name.
NOTE: Before issuing the show virtualDisk performanceStat command, issue the
set session performanceMonitorInterval and set session
performanceMonitorIterations commands to define how often you collect the
statistics.
Syntax
show (allVirtualDisks | virtualDisk
[virtualDiskName] |
virtualDisks [virtualDiskName1 ...
virtualDiskNamen] reservations
Parameters
Parameter Description
allVirtualDisks Returns reservation information about all virtual disks in
the storage array.
virtualDisk or Name of the specific virtual disk for which you are retrieving
virtualDisks reservation information. You can enter more than one
virtual disk name. You must put brackets ([ ]) around the
virtual disk name. If the virtual disk name has special
characters, you must also put quotation marks (" ") around
the virtual disk name.
Syntax
start diskGroup [diskGroupNumber] blink
Parameter
Parameter Description
diskGroup Number of the disk group to identify. You must
put brackets ([ ]) around the disk group number.
Syntax
start diskGroup [diskGroupNumber] defragment
Parameter
Parameter Description
diskGroup Number of the disk group to defragment. You
must put brackets ([ ]) around the disk group
number.
Parameter
Parameter Description
enclosure Identifies the enclosure to blink. Enclosure ID
values are 0 to 99. You must put brackets ([ ])
around the enclosure ID value.
Syntax
start storageArray [iscsi-host-port] dhcpRefresh
Parameter
Parameter Description
iscsi-host-port The identifier of the port on the storage array on which you want to
refresh the DHCP parameters. Enclose the iSCSI host port name in
square brackets ([ ]).
NOTE: This operation ends the iSCSI connections for the portal and brings down
the portal temporarily.
Syntax
start physicalDiskChannel [(1 | 2)] controller [(0
| 1)]
Parameters
Parameter Description
controller The identifier letter of the RAID controller module that
you want to test. Valid RAID controller module identifier
values are 0 or 1, where 0 is the RAID controller module on
the left, and 1 is the RAID controller module on the right
when viewed from the rear of the enclosure.
testDevices The identifiers of the devices (RAID controller modules,
EMMs, or physical disks) that you want to test. You can
specify all or enter the specific identifiers for the devices
that you want to diagnose.
dataPattern The method of repeatability that you want to test.
patternNumber The hexadecimal data pattern you want to use to run the
test.
This number can be any hexadecimal number between
0000 to FFFF.
maxErrorCount The number of errors that you want to accept before
terminating the test.
testIterations The number of times that you want to repeat the test.
timeout The length of time in minutes that you want to run the test.
Syntax
start physicalDisk [enclosureID,slotID] blink
Parameters
Parameter Description
physicalDisk Identifies the enclosure and slot where the physical disk resides.
Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You
must put brackets ([ ]) around the enclosure ID value and slot
ID value.
Syntax
start physicalDisk [enclosureID,slotID] initialize
Parameters
Parameter Description
physicalDisk Identifies the enclosure and slot where the physical disk resides.
Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You
must put brackets ([ ]) around the enclosure ID value and slot
ID value.
Syntax
start physicalDisk [enclosureID,slotID]
reconstruct
Parameters
Parameter Description
physicalDisk Identifies the enclosure and slot where the physical disk resides.
Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You
must put brackets ([ ]) around the enclosure ID value and slot
ID value.
Syntax
start storageArray blink
Parameters
None.
Example
-c "start storageArray blink ;"
Syntax
start diskGroup [diskGroupNumber] (import |
export)
Parameter
Parameter Description
diskGroupNumber The number of the disk group that you want to import. Enclose
the disk group number in square brackets ([ ]).
NOTE: Higher-level virtual disks that are specifically related to premium features
(Snapshot, Remote Virtual Disk Mirroring, Virtual Disk Copy, host-to-virtual disk
mapping, and persistent reservations) are removed as part of the import operation.
NOTE: The show diskGroup importDependencies command must be run before the
start diskGroup import command.
Syntax
start virtualDisk [virtualDiskName] initialize
Parameters
Parameter Description
virtualDisk Name of the virtual disk for which to start the formatting. You
must put brackets ([ ]) around the virtual disk name. If the
virtual disk name has special characters, you must also put
quotation marks (" ") around the virtual disk name.
Syntax
stop diskGroup blink
Parameters
None.
Syntax
stop enclosure blink
Parameters
None.
Syntax
stop storageArray iscsiSession [integer]
Parameter
Parameter Description
integer The identifier number of the iSCSI session. Enclose the identifier
number of the iSCSI session in square brackets ([ ]).
Parameters
None.
Syntax
stop physicalDiskChannel faultDiagnostics
Parameters
None.
Stop Snapshot
This command stops a copy-on-write operation.
Syntax
stop snapshot (virtualDisk [virtualDiskName] |
virtualDisks [virtualDiskName1 ...
virtualDiskNamen]
Parameters
Parameter Description
virtualDisk or virtualDisks Name of the specific virtual disk for which to stop a copy-
on-write operation. You can enter more than one virtual
disk name. You must put brackets ([ ]) around the virtual
disk names. If the virtual disk names have special
characters, you must also put quotation marks (" ")
around the virtual disk names.
Syntax
stop storageArray blink
Parameters
None.
Example
-c "stop storageArray iscsiSession [5];"
Syntax
stop storageArray physicalDiskFirmwareDownload
Parameters
None.
Syntax
stop virtualDiskCopy target [targetName] [source
[sourceName]]
Parameter Description
target Name of the target virtual disk for which to stop a virtual disk copy
operation. You must put brackets ([ ]) around the target virtual disk
name. If the target virtual disk name has special characters, you must
also put quotation marks (" ") around the target virtual disk name.
source Name of the source virtual disk for which to stop a virtual disk copy
operation. You must put brackets ([ ]) around the source virtual disk
name. If the source virtual disk name has special characters, you
must also put quotation marks (" ") around the source virtual disk
name.
A CLI
commands, 16
activate storage array
usage examples, 27
firmware, 114
clocks, RAID controller module,
adding comments to a script, 41
synchronizing, 95
assigning global hot spares, 59
collecting physical disk data, 98
autoconfigure storage array, 115
command formatting rules, 106
autoconfigure storage array hot
command line interface, how to
spares, 116
use, 14
command line parameters, 18
C commands
listed alphabetically, 114
changing
listed by function, 108
RAID controller module
ownership, 101 commands listed by
RAID level, 97 function, 108
segment size, 97 comments, adding, 41
Snapshot Virtual Disk settings, 73
configuration
Virtual Disk Copy settings, 83
script example 1, 233
check virtual disk script example 2, 236
consistency, 117
configure
clear autoconfigure storage array, 115
physical disk channel autoconfigure storage array hot
statistics, 118 spares, 116
storage array configuration, 118 changing RAID levels, 97
storage array event log, 119 changing segment size, 97
storage array firmware create RAID virtual disk,
pending, 119 automatic physical disk
virtual disk reservations, 120 select, 126
Index 239
configure (continued) delete (continued)
create RAID virtual disk, free host group, 140
capacity base select, 128 host port, 141
create RAID virtual disk, manual iSCSI initiator, 141
physical disk select, 130 Snapshot Virtual Disk, 74-75
storage array, 44 virtual disk, 142
storage partitioning, 88
detailed error reporting, 24
copying
determining
virtual disk, 81
Virtual Disk Copy candidates, 79
create what is on your storage array, 44
disk group, 120
diagnosing RAID controller
host, 122 module, 99, 143
host group, 123
host port, 124 disable storage array feature, 146
iSCSI initiator, 125 disk group
Snapshot Virtual Disk, 63-72 commands, 108
Snapshot virtual disk, 133 create disk group, 120
virtual disk, 48-52 defragmenting, 98, 223
Virtual Disk Copy, 78, 137 delete disk group, 139
create RAID virtual disk reviving, 163
automatic physical disk show, 204
select, 126 stop blink, 229
free capacity base select, 128 download
manual physical disk select, 130 enclosure management module
creating firmware, 146
snapshot virtual disk, 66 physical disk firmware, 147
Virtual Disk Copy, 79 storage array firmware
NVSRAM, 148
storage array NVSRAM, 149
storage array physical disk
D firmware, 150
defragmenting a disk group, 98
delete
disk group, 139
host, 140
240 Index
E host port
create host port, 124
enable
delete host port, 141
RAID controller module, 151
set, 179
storage array feature key, 151
show host ports, 205
Virtual Disk Copy, 64, 79
hot spare
enclosure
assigning global hot spares, 59
commands, 109
set physical disk hot spare, 182
enclosure loss protection, 52
how to use the command line
enclosure management module interface, 14
firmware
download, 146
exit status, 25 I
initializing
physical disk, 101
F virtual disk, 102
foreign physical disk interaction with other
set to native, 176 features, 88
formatting considerations, 24 ISCSI
recurring syntax values, 39
iSCSI
H commands, 109
host iSCSI initiator
create host, 122 create iSCSI initiator, 125
delete host, 140 delete iSCSi initiator, 141
set host, 176
show storage array host
topology, 214
L
topology commands, 109
locating physical disks, 95
host group
create host group, 123
delete host group, 140
set host group, 178
Index 241
M RAID controller module
(continued)
media scan, running, 91
enabling RAID controller module
modifying configuration, 55 data, 94
monitoring performance, 96 reset, 94, 160
saving NVSRAM values, 165
set, 183
setting operational mode, 100
P
show, 208
partitioning, storage, 88
RAID level, changing, 97
performance tuning, 95
RAID virtual disk
persistent reservations, recover, 153
removing, 94
reconstructing a physical
physical disk disk, 102
commands, 110
recopy
download firmware, 147
virtual disk, 86, 152
initializing, 101
locating, 95 recopying virtual disk, 84
reconstructing, 102 recover
reviving, 163 RAID Virtual Disk, 153
set commands, 182-183 RAID virtual disk, 153
set state, 183
recovery operations, 100
show commands, 205-208
start, 226-227 re-creating
stop blink, 229 snapshot virtual disk, 76
recurring syntax elements, 34
redistributing virtual disk, 103
R
redundancy check, running, 93
RAID controller module
remove
changing ownership, 101
copy pairs, 87
clocks, synchronizing, 95
persistent reservations, 94
commands, 111
virtual disk copy, 158
diagnosing, 99, 143
virtual disk LUN mapping, 159
enable RAID controller
module, 151
242 Index
repair virtual disk save (continued)
consistency, 160 storage array SAS PHY
reset Counts, 169
RAID controller module, 160 storage array state capture, 170
storage array battery install storage array support data, 170
date, 161 save storage array iSCSI
storage array virtual disk statistics, 168
distribution, 162
saving
reset a RAID controller RAID controller module
module, 94 NVSRAM values, 165
reset storage array iSCSI script command
baseline, 162 structure, 30
reset storage array SAS PHY synopsis, 32
baseline, 162 usage guidelines, 40
restarting a Snapshot Virtual segment size, changing, 97
Disk, 74-75 session command, 111
revive Set, 170
disk group, 163
physical disk, 163 set
enclosure id, 175
routine maintenance, 91 foreign physical disk to
running native, 176
media scan, 91 host group, 178
redundancy check, 93 physical disk channel status, 182
physical disk hot spare, 182
physical disk state, 183
S RAID controller module, 183
session, 188
save Snapshot Virtual Disk, 189
configuration to a file, 47 storage array, 191
enclosure log data, 164 storage array enclosure
storage array, 166-170 positions, 192
storage array events, 167 virtual disk, 198
storage array performance Virtual Disk Copy, 203
statistics, 169
set controller, 170
Index 243
set disk group, 173 show (continued)
set enclosure attribute, 174 physical disk channel
statistics, 207
set host, 176 physical disk download
set host port, 179 progress, 208
RAID controller module, 208
set iSCSI initiator, 179
RAID controller module
set iSCSI target properties, 180 NVSRAM, 209
set storage array ICMP storage array autoconfigure, 212
response, 193 storage array command, 210
set storage array iSNS server IPv4 storage array host topology, 214
address, 194-195 storage array LUN mappings, 214
storage array unreadable
set storage array iSNS server IPv6 sectors, 215
address, 195
string, 216
set storage array iSNS server string command, 111
listening port, 195 unconfigured iSCSI
set storage array iSNS server initiators, 216
refresh, 196 virtual disk, 217
set storage array learn cycle, 197 virtual disk action progress, 218
Virtual Disk Copy, 219
set storage array time, 197 Virtual Disk Copy source
set unnamed discovery candidates, 220
session, 198 Virtual Disk Copy target
setting candidates, 220
controller clocks, 57 virtual disk reservations, 222
modification priority, 58 show current iSCSI sessions, 203
RAID controller module show disk group import
operational mode, 100 dependencies, 220
storage array host type, 57
show storage array negotiation
storage array password, 56
defaults, 214
show
show unconfigured iSCSI
disk group, 204 initiators, 216
host ports, 205
physical disk, 205 show virtual disk performance
statistics, 221
244 Index
SMcli commands, 16 stop (continued)
snapshot Snapshot, 230
commands, 111 Snapshot Virtual Disk, 74-75
names, 72 storage array blink, 231
virtual disks, 89 storage array physical disk
firmware download, 231
Snapshot Virtual Disk Virtual Disk Copy, 87, 231
creating, 64-72
stop iSCSI session, 229
deleting, 76
enabling, 64 stop physical disk channel fault
restarting, 75 isolation diagnostics, 230
stopping, 74-75 storage array
snapshot virtual disk accept pending topology, 114
creating, 66 commands, 111
re-creating, 76 download commands, 148-151
save commands, 166-170
start
set commands, 191-198
disk group blink, 223
show commands, 210-216
disk group defragment, 223
show host topology, 214
enclosure blink, 223
show LUN mappings, 214
physical disk blink, 226
show pending topology, 215
physical disk initialize, 226
show unreadable sectors, 215
physical disk reconstruction, 227
start blink, 227
storage array blink, 227
stop blink, 231
virtual disk initialization, 228
storage array feature
start disk group import, 227
disable, 146
Start Disk Group
storage partitioning, 88
Import/Export, 227
support.dell.com, 13
start iSCSI DHCP refresh, 224
synchronizing RAID controller
start physical disk channel fault
module clocks, 95
isolation diagnostics, 224
syntax element statement
stop
data, 185
disk group blink, 229
enclosure blink, 229 syntax elements
physical disk blink, 229 ISCSI values, 39
Index 245
T virtual disk (continued)
recopy, 86
troubleshooting storage array, 98
recopy virtual disk, 152
recopying, 84
redistributing, 103
U repair consistency, 160
user-defined parameters, 70 set, 198
show commands, 217-222
Virtual Disk Copy
V command, 113
virtual disk show, 219
check consistency, 117 stop, 231
commands, 113 viewing properties, 82
copying, 81 virtual disk copy
creating in an existing disk remove, 158
group, 51
creating with software-assigned
physical disks, 50
creating with user-assigned
physical disks, 48
initializing, 102
246 Index