Overview
The Script Editor and the Command Line Interface each support the use of the following seven commands. These commands, used in conjunction with specific parameters, let you perform various storage subsystem management tasks. Click on the command in the Command column to jump to the command syntax and examples.
Command |
Lets you ... |
create logical drives on a set of drives (unconfigured capacity), turning those drives into a new array, or create logical drives on an existing array (free capacity). Primary Parameters: driveCount [number of drives], drive or drives [drive list], array [array number] Secondary Parameters: capacity, owner, RAIDlevel, usageHint, userLabel, segmentSize, mapping Note: the mapping parameter is not used when creating new arrays. |
|
delete an array or logical drive. Primary Parameter: logical drive[userLabel] or array [array number] |
|
download new firmware or NVSRAM to the storage subsystem. Primary Parameter: storageSubsystem firmwareFile or storageSubsystem NVSRAMFile |
|
dictate the script behavior when execution fails. The default behavior is for the script to continue executing subsequent commands after a command has failed. Primary Parameter: stop or continue |
|
change the properties of a storage subsystem component, controller, array, logical drive, or drive. You can set multiple properties for a specific storage subsystem element using one set command. Primary Parameters: storageSubsystem, controller [controller-spec], array [array number], logical drive [userLabel], drive or drives [drive list], Secondary Parameters:
|
|
display the properties of the different logical and physical components comprising the storage subsystem. You can also use the show command to embed text strings (comments) in your command line that will display in the output area during command execution. Primary Parameters: storageSubsystem, controller [controller-spec], string, Secondary Parameters:
|
|
specify the password to use for destructive commands. Currently there is only one option for the use command. Primary Parameter: password Notes:
|
Common Syntax
Create Logical Drive Syntax |
||||||
If you want to... |
Base Command |
Primary and Secondary Parameters |
||||
create a logical drive using any unassigned drives (unconfigured capacity) |
create |
|
||||
create a logical drive using specific unassigned drives (unconfigured capacity) |
create |
|
||||
create a logical drive on an existing array (free capacity) |
create |
|
||||
1You can specify all other logical drive parameters using the set Command. |
Create Logical Drive Examples |
|||||
Task |
Command Statement and Execution Results |
||||
Create a logical drive using any unassigned drives. |
|
||||
Create a logical drive using specific unassigned drives. |
|
||||
Create a logical drive on array number 3. |
|
||||
|
Delete Syntax |
||
If you want to... |
Base Command |
Primary Parameters |
delete a logical drive |
delete |
|
delete an array |
delete |
array [array number] |
Delete Examples |
|||||
Task |
Command Statement and Execution Results |
||||
Delete the logical drive named Chevelle. |
|
||||
Delete array number 3 and its associated logical drives. |
|
Download Syntax |
||
If you want to... |
Base Command |
Primary Parameters |
download a firmware file |
download |
storageSubsystem firmwareFile = filename |
download an NVSRAM file |
download |
storageSubsystem NVSRAMFile = filename
|
Download Examples |
|||||
Task |
Command Statement and Execution Results |
||||
Download a firmware file. |
|
||||
Download an NVSRAM file. |
|
On Error Syntax |
||
If you want to... |
Base Command |
Primary Parameters |
stop execution of the script if any commands following the On Error Stop command fail. |
on error |
stop |
continue execution of the script even if any commands following the On Error Continue command fail. |
on error |
continue1 |
1The default behavior is for the script to continue executing subsequent commands after a command has failed. This command is for execution errors, not syntax errors. Also, there may be certain error conditions that override the "on error continue" parameter. |
On Error Examples |
|||||
Task |
Command Statement and Execution Results |
||||
Stop execution of the script when an error is encountered. |
|
||||
Continue execution of the script when an error is encountered. |
|
Set Syntax |
||||||
If you want to... |
Base Command |
Primary Parameters |
||||
set properties of the storage subsystem |
set |
|
||||
set properties of a controller |
set |
|
||||
set properties of an array |
set |
|
||||
set properties of a logical drive |
set |
|
||||
create a hot spare drive from an unassigned drive |
set |
|
Set Examples |
||||||
Task |
Command Statement and Execution Results |
|||||
Provide a name for the storage subsystem and set the cache to flush when it reaches 85 percent full, and stop flushing the cache when it reaches 15 percent full. |
|
|||||
Set the controller in slot A to active mode. |
|
|||||
Set host-specific NVSRAM configurations |
|
|||||
Set global NVSRAM configurations |
|
|||||
Change the owner of array 3, and its associated logical drives, to the controller in slot B. |
|
|||||
Enable the write cache and cache mirroring properties on the logical drive named Nova. |
|
|||||
Create two hot spares using the unassigned drives at enclosureID = 1, slotID = 2, and enclosureID = 1, slotID = 3. |
|
Show Syntax |
||||||
If you want to... |
Base Command |
Primary and Secondary Parameters |
||||
show properties of storage subsystem |
show |
|
||||
show properties of controller |
show |
|
||||
show a comment and display it to the output area |
show |
|
Show Examples |
|||||
Task |
Command Statement and Execution Results |
||||
Display the health and profile of the storage subsystem. |
|
||||
Show the current mode of the controller in Slot B. |
|
||||
Include several comments in the script. |
|
||||
Show all host-type labels and host-type indexes known to the controller to determine which host-type indexes to use when writing NVSRAM configuration scripts. |
|
||||
Show which hosts will be affected by a host-specific change to the NVSRAM configuration, assuming that a host-type index has already been picked. |
|
Use Syntax |
||
If you want to... |
Base Command |
Primary Parameters |
specify the password to use for destructive commands |
use |
password |
Notes:
|
Use Example |
|||||
Task |
Command Statement and Execution Results |
||||
specify the password to use for destructive commands |
|