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

Dell PowerVault MD3260i CLI Guide - Page 19

Exit Status, Status Value

View all Dell PowerVault MD3260i manuals

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

Page 19 highlights

When an exception occurs while executing a command, the CLI automatically saves the error information to a file named excprpt.txt. The CLI attempts to place excprpt.txt in the directory specified by the system property devmgr.datadir, which by default is the "client/data" directory under the main installation directory in Windows and the /var/opt/SM directory in Linux. If for any reason the CLI cannot place the file in the devmgr.datadir-specified directory, the CLI saves the excprpt.txt file in the same directory from which the CLI is running. You cannot change the file name or location. The excprpt.txt file is overwritten every time an exception occurs. To save the information in the excprpt.txt file, you must to copy the information to a new file or directory. 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 the following table. Table 3. Exit Status Status Value Meaning 0 The command terminated without an error. 1 The command terminated with an error. Error information is also displayed. 2 The script file does not exist. 3 An error occurred while opening an output file. 4 A storage array is not at the specified address. 5 Addresses specify different storage arrays. 6 A storage array name does not exist for the host agent connected. 7 The storage array name was not at the specified address. 8 The storage array name was not in the configuration file. 10 A management class does not exist for the storage array. 11 A storage array was not found in the configuration file. 12 An internal error occurred. 13 Invalid script syntax was found. 14 The RAID controller module was unable to communicate with the storage array. 15 A duplicate argument was entered. 16 An execution error occurred. 17 A host was not at the specified address. 18 The World Wide Identifier (WWID) was not in the configuration file. 19 The WWID was not at the address. 20 An unknown IP address was specified. 21 The event monitor configuration file was corrupted. 22 The storage array was unable to communicate with the event monitor. 23 The RAID controller module was unable to write alert settings. 19

Section	Page
Dell PowerVault Modular Disk Storage Arrays CLI Guide	3
About The Command Line Interface	11
How To Use The Command Line Interface	11
Usage Notes	12
CLI Commands	12
Command Line Parameters	14
Formatting Considerations	18
Detailed Error Reporting	18
Exit Status	19
Usage Examples	20
About The Script Commands	23
Script Command Structure	23
Script Command Synopsis	25
Recurring Syntax Elements	26
Usage Guidelines	30
Adding Comments To A Script File	30
Configuring A Storage Array	33
Configuring A Storage Array	33
Determining What Is On Your Storage Array	34
Saving A Configuration To A File	35
Using The Create Virtual Disk Command	36
Using The Auto Configure Command	38
Modifying Your Configuration	40
Setting The Storage Array Password	40
Setting Up SMTP And SNMP Alerts	40
Setting The RAID Controller Module Clocks	41
Setting The Storage Array Host Type	41
Setting Modification Priority	42
Assigning Global Hot Spares	42
Selecting The Event Levels For Alert Notifications	43
Configuring Alert Notifications	43
Using The Snapshot Feature	45
Using Host Servers To Create An Initial Snapshot Virtual Disk	46
Creating A Snapshot Virtual Disk	46
Enabling The Snapshot Virtual Disk Feature	47
Creating A Snapshot Virtual Disk With User-Assigned Physical Disks	47
Preparing Host Servers To Create An Initial Snapshot Virtual Disk	47
Creating The Initial Snapshot Virtual Disk	48
Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks	49
Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks	49
User-Defined Parameters	50
Names Of Snapshot Virtual Disks And Repository Virtual Disks	52
Changing Snapshot Virtual Disk Settings	53
Stopping And Deleting A Snapshot Virtual Disk	53
Re-creating The Snapshot Virtual Disk	54
Preparing Host Servers To Re-create A Snapshot Virtual Disk	54
Re-creating A Snapshot Virtual Disk	54
Using The Virtual Disk Copy Feature	57
Creating A Virtual Disk Copy	58
Enabling The Virtual Disk Copy Feature	58
Determining Virtual Disk Copy Candidates	58
Creating A Virtual Disk Copy	58
Preparing Host Servers To Create A Virtual Disk Copy	59
Copying The Virtual Disk	59
Viewing Virtual Disk Copy Properties	60
Changing Virtual Disk Copy Settings	61
Recopying A Virtual Disk	62
Preparing Host Servers To Recopy A Virtual Disk	62
Recopying The Virtual Disk	62
Stopping A Virtual Disk Copy	63
Removing Copy Pairs	63
Interaction With Other Features	64
Storage Partitioning	64
Snapshot Virtual Disks	64
Using The Remote Replication Premium Feature	67
How Remote Replication Works	67
Replication Repository Virtual Disks	68
Replication Relationships	68
Data Replication	68
Link Interruptions Or Secondary Virtual Disk Errors	69
Resynchronization	69
Creating A Remote Replicated Pair	70
Performance Considerations	70
Enabling The Remote Replication Premium Feature	71
Activating The Remote Replication Premium Feature	71
Determining Candidates For A Remote Replicated Pair	73
Creating A Remote Replicated Pair	73
Changing Remote Replication Settings	74
Suspending And Resuming A Replication Relationship	75
Removing A Replication Relationship	75
Deleting A Primary Virtual Disk Or A Secondary Virtual Disk	76
Disabling The Remote Replication Premium Feature	76
Deactivating The Remote Replication Premium Feature	76
Interaction With Other Premium Features	76
Snapshot Virtual Disks	77
Virtual Disk Copy	77
Storage Partitioning	77
Virtual Disk Expansion	78
Maintaining A Storage Array	79
Routine Maintenance	79
Running A Media Scan	79
Running A Consistency Check	80
Resetting A RAID Controller Module	80
Enabling RAID Controller Module Data Transfer	81
Resetting Battery Age	81
Removing Persistent Reservations	81
Synchronizing RAID Controller Module Clocks	81
Locating Physical Disks	81
Performance Tuning	82
Monitoring Performance	82
Changing RAID Levels	83
Changing Segment Size	83
Defragmenting A Disk Group	83
Troubleshooting and Diagnostics	83
Collecting Physical Disk Data	84
Diagnosing A RAID Controller Module	84
Recovery Operations	84
Setting RAID Controller Module Operational Mode	85
Changing RAID Controller Module Ownership	85
Initializing A Physical Disk	85
Reconstructing A Physical Disk	86
Initializing A Virtual Disk	86
Redistributing Virtual Disks	86
Script Commands	89
Command Formatting Rules	89
Firmware Compatibility Levels	91
Commands Listed By Function	91
Disk Group Commands	91
Enclosure Commands	91
Host Topology Commands	91
iSCSI Commands	92
Physical Disk Commands	92
RAID Controller Module Commands	93
Remote Replication Commands	93
Session Command	94
Show String Command	94
Snapshot Commands	94
Storage Array Commands	94
Virtual Disk Commands	95
Virtual Disk Copy Commands	96
Commands Listed Alphabetically	96
Activate Remote Replication Feature	96
Activate Storage Array Firmware	99
Autoconfigure Storage Array	99
Autoconfigure Storage Array Hot Spares	100
Check Remote Replication Status	100
Check Virtual Disk Consistency	101
Clear Physical Disk Port Statistics	102
Clear Storage Array Configuration	102
Clear Storage Array Core Dump	103
Clear Storage Array Event Log	103
Clear Storage Array Firmware Pending Area	103
Clear Storage Array Recovery Mode	104
Clear Virtual Disk Reservations	104
Clear Virtual Disk Unreadable Sectors	104
Configure Automatic Support Bundle Collection	105
Create Disk Group	105
Create Disk Pool	109
Create Host	111
Create Host Group	111
Create Host Port	111
Create iSCSI Initiator	112
Create RAID Virtual Disk (Automatic Physical Disk Select)	113
Create RAID Virtual Disk (Free Capacity Base Select)	114
Create RAID Virtual Disk (Manual Physical Disk Select)	116
Create RAID Virtual Disk On A Disk Pool	119
Create Remote Replication	120
Create Snapshot Virtual Disk	122
Scheduling Snapshots	126
Create Storage Array Security Key	127
Create Virtual Disk Copy	129
Deactivate Remote Replication	130
Delete Disk Group	130
Delete Disk Pool	131
Delete Host	131
Delete Host Group	131
Delete Host Port	132
Delete iSCSI Initiator	132
Delete Snapshot Virtual Disk or Delete Snapshot Virtual Disk Schedule	133
Delete Virtual Disk	133
Delete Virtual Disk On A Disk Pool	134
Diagnose RAID Controller Module	135
Diagnose RAID Controller Module iSCSI Host Cable	136
Diagnose Remote Replication	137
Disable Storage Array Feature	138
Display Automatic Support Bundle Collection Configuration	138
Display Support Bundle Collection Schedule	138
Download Enclosure Management Module Firmware	139
Download Physical Disk Firmware	139
Download Storage Array Firmware/NVSRAM	140
Download Storage Array Physical Disk Firmware	141
Download Storage Array NVSRAM	142
Enable Disk Group Security	142
Enable Disk Pool Security	142
Enable RAID Controller Module Data Transfer	143
Enable Storage Array Feature	143
Increase Virtual Disk Capacity On A Disk Pool	144
Load Storage Array DBM Database	144
Recopy Virtual Disk Copy	145
Re-Create Remote Replication Repository Virtual Disk	146
Re-Create Snapshot	148
Reduce Disk Pool Capacity	150
Remove Remote Replication	150
Remove Virtual Disk Copy	151
Remove Virtual Disk LUN Mapping	151
Repair Virtual Disk Consistency	152
Replace Physical Disk	152
Reset RAID Controller Module	153
Reset Storage Array Battery Install Date	154
Reset Storage Array iSCSI Baseline	154
Reset Storage Array SAS PHY Baseline	155
Reset Storage Array Virtual Disk Distribution	155
Resume Remote Replication	155
Resume Snapshot Rollback	156
Revive Disk Group	156
Revive Disk Pool	157
Revive Physical Disk	157
Save Enclosure Log Data	157
Save Physical Disk Channel Fault Isolation Diagnostic Status	158
Save Physical Disk Log	158
Save RAID Controller Module NVSRAM	158
Save Storage Array Configuration	159
Save Storage Array Events	160
Save Storage Array iSCSI Statistics	161
Save Storage Array Performance Statistics	161
Save Storage Array SAS PHY Counts	162
Save Storage Array State Capture	162
Save Storage Array Support Data	162
Schedule Support Bundle Collection Configuration	163
Scheduling Snapshots	164
Set Disk Group	165
Set Disk Group Forced State	167
Set Disk Pool	167
Set Enclosure Attribute	168
Set Enclosure Identification	168
Set Foreign Physical Disk to Native	169
Set Host	169
Set Host Channel	170
Set Host Group	171
Set Host Port	171
Set iSCSI Initiator	172
Set iSCSI Target Properties	172
Set Physical Disk Channel Status	173
Set Physical Disk Hot Spare	174
Set Physical Disk State	174
Set RAID Controller Module	175
Set Remote Replication	177
Set Session	179
Set Snapshot Virtual Disk	180
Set Storage Array	181
Set Storage Array Enclosure Positions	183
Set Storage Array ICMP Response	184
Set Storage Array iSNS Server IPv4 Address	184
Set Storage Array iSNS Server IPv6 Address	185
Set Storage Array iSNS Server Listening Port	185
Set Storage Array Learn Cycle	185
Set Storage Array Redundancy Mode	186
Set Storage Array Security Key	186
Set Storage Array Time	187
Set Storage Array Unnamed Discovery Session	187
Set Virtual Disk	187
Set Virtual Disk Copy	190
Show Current iSCSI Sessions	191
Show Disk Group	192
Show Disk Group Export Dependencies	192
Show Disk Group Import Dependencies	193
Show Disk Pool	193
Show Host Ports	193
Show Physical Disk	194
Show Physical Disk Channel Statistics	195
Show Physical Disk Download Progress	196
Show RAID Controller Module	196
Show RAID Controller Module NVSRAM	197
Show Remote Replication Virtual Disk Candidates	198
Show Remote Replication Virtual Disk Synchronization Progress	198
Show Storage Array	199
Show Storage Array Auto Configure	200
Show Storage Array Host Topology	201
Show Storage Array LUN Mappings	202
Show Storage Array Negotiation Defaults	202
Show Storage Array Unconfigured iSCSI Initiators	202
Show Storage Array Unreadable Sectors	203
Show String	203
Show Virtual Disk	203
Show Virtual Disk Action Progress	205
Show Virtual Disk Copy	205
Show Virtual Disk Copy Source Candidates	206
Show Virtual Disk Copy Target Candidates	206
Show Virtual Disk Performance Statistics	206
Show Virtual Disk Reservations	207
Start Configuration Database Diagnostic	207
Start Disk Group Blink	208
Start Disk Group Defragment	208
Start Disk Group Export	208
Start Disk Group Import	209
Start Disk Pool Locate	209
Start Enclosure Blink	209
Start iSCSI DHCP Refresh	210
Start Physical Disk Blink	210
Start Physical Disk Channel Blink	211
Start Physical Disk Channel Fault Isolation Diagnostics	211
Start Physical Disk Initialize	212
Start Physical Disk Reconstruction	212
Start Remote Replication Synchronization	213
Start Secure Physical Disk Erase	213
Start Snapshot Rollback	213
Stop Snapshot Rollback	214
Start Storage Array Blink	214
Start Storage Array iSCSI Refresh	214
Start Virtual Disk Initialization	215
Stop Configuration Database Diagnostic	215
Stop Disk Group Blink	215
Stop Disk Pool Locate	216
Stop Enclosure Blink	216
Stop Physical Disk Blink	216
Stop Physical Disk Channel Blink	216
Stop Physical Disk Channel Fault Isolation Diagnostics	216
Stop Snapshot	217
Stop Storage Array Blink	217
Stop Storage Array iSCSI Session	217
Stop Storage Array Physical Disk Firmware Download	217
Stop Virtual Disk Copy	218
Suspend Remote Replication	218
Validate Storage Array Security Key	219
Sample Script Files	221
Configuration Script Example 1	221
Configuration Script Example 2	222
CLI Command Updates	225
New Commands	225

Match case Limit results 1 per page

When an exception occurs while executing a command, the CLI automatically saves the error information to a file

named

excprpt.txt

. The CLI attempts to place

excprpt.txt

in the directory specified by the system property

devmgr.datadir

, which by default is the "client/data" directory under the main installation directory in Windows and

the

/var/opt/SM

directory in Linux. If for any reason the CLI cannot place the file in the

devmgr.datadir

-specified

directory, the CLI saves the

excprpt.txt

file in the same directory from which the CLI is running. You cannot change the

file name or location. The

excprpt.txt

file is overwritten every time an exception occurs. To save the information in the

excprpt.txt

file, you must to copy the information to a new file or directory.

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 the following table.

Table 3. Exit Status

Status Value

Meaning

The command terminated without an error.

The command terminated with an error. Error information is also displayed.

The script file does not exist.

An error occurred while opening an output file.

A storage array is not at the specified address.

Addresses specify different storage arrays.

A storage array name does not exist for the host agent connected.

The storage array name was not at the specified address.

The storage array name was not in the configuration file.

A management class does not exist for the storage array.

A storage array was not found in the configuration file.

An internal error occurred.

Invalid script syntax was found.

The RAID controller module was unable to communicate with the storage array.

A duplicate argument was entered.

An execution error occurred.

A host was not at the specified address.

The World Wide Identifier (WWID) was not in the configuration file.

The WWID was not at the address.

An unknown IP address was specified.

The event monitor configuration file was corrupted.

The storage array was unable to communicate with the event monitor.

The RAID controller module was unable to write alert settings.