Home » Dell Manuals » Storage Devices » Dell PowerVault MD3000i » Manual Viewer

Dell PowerVault MD3000i Command Line Interface Guide - Page 13

About the Command Line Interface - configuration guide

View all Dell PowerVault MD3000i manuals

Add to My Manuals
Save this manual to your list of manuals

Page 13 highlights

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. About the Command Line Interface 13

Section	Page
Contents	3
About the Command Line Interface	13
How to Use the Command Line Interface	14
Usage Notes	15
CLI Commands	16
Command Line Parameters	18
Formatting Considerations	24
Detailed Error Reporting	24
Exit Status	25
Usage Examples	27
About the Script Commands	29
Script Command Structure	30
Script Command Synopsis	32
Recurring Syntax Elements	34
Usage Guidelines	40
Adding Comments to a Script File	41
Configuring a Storage Array	43
Configuring a Storage Array	44
Determining What is on Your Storage Array	44
Saving a Configuration to a File	47
Using the Create Virtual Disk Command	48
Using the Auto Configure Command	53
Modifying Your Configuration	55
Setting the Storage Array Password	56
Setting Up SMTP and SNMP Alerts	56
Setting the RAID Controller Module Clocks	57
Setting the Storage Array Host Type	57
Setting Modification Priority	58
Assigning Global Hot Spares	59
Using the Snapshot Feature	61
Using Host Servers to Create an Initial Snapshot Virtual Disk	63
Creating a Snapshot Virtual Disk	63
Enabling the Snapshot Virtual Disk Feature	64
Creating a Snapshot Virtual Disk with User-Assigned Physical Disks	64
Preparing Host Servers to Create an Initial Snapshot Virtual Disk	65
Creating the Initial Snapshot Virtual Disk	66
Creating a Snapshot Virtual Disk with Software-Assigned Physical Disks	67
Creating a Snapshot Virtual Disk by Specifying a Number of Physical Disks	69
User-Defined Parameters	70
Names of Snapshot Virtual Disks and Repository Virtual Disks	72
Changing Snapshot Virtual Disk Settings	73
Stopping and Deleting a Snapshot Virtual Disk	74
Re-creating the Snapshot Virtual Disk	75
Preparing Host Servers to Re-create a Snapshot Virtual Disk	75
Re-creating a Snapshot Virtual Disk	76
Using the Virtual Disk Copy Feature	77
Creating a Virtual Disk Copy	78
Enabling the Virtual Disk Copy Feature	79
Determining Virtual Disk Copy Candidates	79
Creating a Virtual Disk Copy	79
Preparing Host Servers to Create a Virtual Disk Copy	80
Copying the Virtual Disk	81
Viewing Virtual Disk Copy Properties	82
Changing Virtual Disk Copy Settings	83
Recopying a Virtual Disk	84
Preparing Host Servers to Recopy a Virtual Disk	85
Recopying the Virtual Disk	86
Stopping a Virtual Disk Copy	87
Removing Copy Pairs	87
Interaction with Other Features	88
Storage Partitioning	88
Snapshot Virtual Disks	89
Maintaining a Storage Array	91
Routine Maintenance	91
Running a Media Scan	91
Running a Consistency Check	93
Resetting a RAID Controller Module	94
Enabling RAID Controller Module Data Transfer	94
Resetting Battery Age	94
Removing Persistent Reservations	94
Synchronizing RAID Controller Module Clocks	95
Locating Physical Disks	95
Performance Tuning	95
Monitoring Performance	96
Changing RAID Levels	97
Changing Segment Size	97
Defragmenting a Disk Group	98
Troubleshooting and Diagnostics	98
Collecting Physical Disk Data	98
Diagnosing a RAID Controller Module	99
Recovery Operations	100
Setting RAID Controller Module Operational Mode	100
Changing RAID Controller Module Ownership	101
Initializing a Physical Disk	101
Reconstructing a Physical Disk	102
Initializing a Virtual Disk	102
Redistributing Virtual Disks	103
Script Commands	105
Command Formatting Rules	106
Commands Listed by Function	108
Disk Group Commands	108
Enclosure Commands	108
Host Topology Commands	109
iSCSI Commands	109
Physical Disk Commands	110
RAID Controller Module Commands	111
Session Command	111
Show String Command	111
Snapshot Commands	111
Storage Array Commands	111
Virtual Disk Commands	113
Virtual Disk Copy Commands	113
Commands Listed Alphabetically	114
Accept Storage Array Pending Topology	114
Activate Storage Array Firmware	114
Autoconfigure Storage Array	114
Autoconfigure Storage Array Hot Spares	116
Check Disk Consistency	117
Clear Physical Disk Channel Statistics	118
Clear Storage Array Configuration	118
Clear Storage Array Event Log	118
Clear Storage Array Firmware Pending Area	119
Clear Virtual Disk Reservations	119
Create Host	120
Create Host Group	121
Create Host Port	121
Create iSCSI Initiator	122
Create RAID Virtual Disk (Automatic Physical Disk Select)	123
Create RAID Virtual Disk (Free Capacity Base Select)	126
Create RAID Virtual Disk (Manual Physical Disk Select)	128
Create Snapshot Virtual Disk	131
Create Virtual Disk Copy	135
Delete Disk Group	137
Delete Host	138
Delete Host Group	138
Delete Host Port	139
Delete iSCSI Initiator	139
Delete Virtual Disk	140
Diagnose RAID Controller Module	141
Disable Storage Array Feature	144
Download Enclosure Management Module Firmware	144
Download Physical Disk Firmware	145
Download Storage Array Firmware/NVSRAM	146
Download Storage Array NVSRAM	147
Download Storage Array Physical Disk Firmware	148
Enable RAID Controller Module	149
Enable Storage Array Feature Key	149
Recopy Virtual Disk Copy	150
Recover RAID Virtual Disk	151
Re-create Snapshot	153
Remove Virtual Disk Copy	155
Remove Virtual Disk LUN Mapping	156
Repair Virtual Disk Consistency	157
Reset RAID Controller Module	157
Reset Storage Array Battery Install Date	158
Reset Storage Array iSCSI Baseline	158
Reset Storage Array SAS PHY Baseline	159
Reset Storage Array Virtual Disk Distribution	159
Revive Disk Group	160
Revive Physical Disk	160
Save Enclosure Log Data	161
Save Physical Disk Log	161
Save RAID Controller Module NVSRAM	162
Save Storage Array Configuration	162
Save Storage Array Events	163
Save Storage Array iSCSI Statistics	164
Save Storage Array Performance Statistics	165
Save Storage Array SAS PHY Counts	165
Save Storage Array State Capture	166
Save Storage Array Support Data	166
Set Controller	166
Set Disk Group	169
Set Enclosure Attribute	170
Set Enclosure Identification	171
Set Host	171
Set Host Group	173
Set Host Port	174
Set iSCSI Initiator	175
Set iSCSI Target Properties	176
Set Physical Disk Channel Status	177
Set Physical Disk Hot Spare	178
Set Physical Disk State	178
Set Session	179
Set Snapshot Virtual Disk	180
Set Storage Array	182
Set Storage Array Enclosure Positions	184
Set Storage Array ICMP Response	184
Set Storage Array iSNS Server IPv4 Address	185
Set Storage Array iSNS Server IPv6 Address	186
Set Storage Array iSNS Server Listening Port	187
Set Storage Array iSNS Server Refresh	188
Set Storage Array Time	188
Set Unnamed Discovery Session	188
Set Virtual Disk	189
Set Virtual Disk Copy	194
Show Current iSCSI Sessions	194
Show Disk Group	195
Show Host Ports	196
Show Physical Disk	196
Show Physical Disk Channel Statistics	198
Show Physical Disk Download Progress	199
Show RAID Controller Module	200
Show RAID Controller Module NVSRAM	201
Show Storage Array	202
Show Storage Array Autoconfigure	204
Show Storage Array Host Topology	206
Show Storage Array LUN Mappings	206
Show Storage Array Negotiation Defaults	206
Show Storage Array Pending Topology	207
Show Storage Array Unreadable Sectors	207
Show String	208
Show Unconfigured iSCSI Initiators	208
Show Virtual Disk	209
Show Virtual Disk Action Progress	210
Show Virtual Disk Copy	211
Show Virtual Disk Copy Source Candidates	212
Show Virtual Disk Copy Target Candidates	212
Show Virtual Disk Performance Statistics	212
Show Virtual Disk Reservations	213
Start Disk Group Blink	214
Start Disk Group Defragment	214
Start Enclosure Blink	215
Start iSCSI DHCP Refresh	215
Start Physical Disk Blink	216
Start Physical Disk Initialize	216
Start Physical Disk Reconstruction	217
Start Storage Array Blink	217
Start Virtual Disk Initialization	217
Stop Disk Group Blink	218
Stop Enclosure Blink	218
Stop iSCSI Session	218
Stop Physical Disk Blink	219
Stop Snapshot	219
Stop Storage Array Blink	220
Stop Storage Array Physical Disk Firmware Download	220
Stop Virtual Disk Copy	220
Sample Script Files	223
Configuration Script Example 1	223
Configuration Script Example 2	226

Match case Limit results 1 per page

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.