Table 1 lists the commands used for managing virtual disks/arrays.
Table 1 Managing Virtual Disk/Array
Command |
IOC |
IOP |
ROC |
Description |
● |
● |
● |
Start, stop, pause, or resume consistency check for a virtual disk. | |
|
|
● |
Pause or resume copy back operation on array. | |
● |
● |
● |
Get configuration information of VD, PD, array, HBA, or driver. | |
● |
● |
● |
Display information on adapter (hba), virtual disk (vd), disk array, physical disk (pd), Port multiplexer (pm), expander (exp), block disk (blk) or spare drive information. | |
● |
● |
● |
Start, stop, pause, or resume VD initialization | |
● |
● |
● |
Set configuration parameters of VD. |
Use cc to start, stop, pause, or resume consistency check for a virtual disk.
The syntax for the cc command (including all required and optional parameters) is as follows:
cc [-o <vd>] [-a <start|stop|pause|resume>] [-l <id>] [-t <sync|check>] [-h]
Table 2 describes the required and optional parameters for the cc command.
Syntax |
Description |
Required Parameter |
|
None |
n/a |
Optional Parameters |
|
[-o <vd>] |
Use to specify object as virtual disk. Note: If this parameter is not included in the command line, CLI uses the default object vd. |
[-a <start|stop|pause|resume>] |
Use one of the following options to control consistency check for the virtual disk: start stop pause resume Note: If this parameter is not included in the command line, CLI uses the default action start. |
[-l <id>] |
Use to specify virtual disk ID. Note: If this parameter is not included in the command line, CLI performs the specified action on all virtual disks. |
[-t <sync|check>] |
Use one of the following options to enable/disable synchronization: sync (consistency check with synchronization) check (consistency check only) Note: If this parameter is not included in the command line, CLI uses the default initialization type sync. |
[-h] |
Use to display help text for the cc command. |
Example |
|
cc -a start -l 0 -t sync |
Start consistency check on virtual disk 0 and synchronize. |
Note: The copyback command is supported only on RAID-On-Chip (ROC) controllers.
Use copyback to pause and resume the copy back operation on an array.
The syntax for the copyback command (including all required and optional parameters) is as follows:
copyback -a <pause|resume> -l <id> [-h]
Table 3 describes the required and optional parameters for the copyback command.
Syntax |
Description |
Required Parameters |
|
-a <pause|resume> |
Use one of the following options to control the copyback operation: pause resume |
-l <id> |
Use to specify array ID. |
Optional Parameter |
|
[-h] |
Use to display help text for the copyback command. |
Examples |
|
copyback -a pause -l 0 |
Pauses copyback operation on array 0. |
Use get to display the properties of virtual disks, physical disks, arrays, HBA (adapter/controller), and the driver.
The syntax for the get command (including all required and optional parameters) is as follows:
get -o <vd|array|pd|hba|aes|aeslink|driver> [-i <VD id|array id|PD id|HBA id|aes port id>] [-h]
Table 4 describes the required and optional parameters for the get command.
Syntax |
Description |
Required Parameter |
|
-o <vd|array|pd|hba|aes|aeslink|driver> |
Use one of the following options to select the object: vd (virtual disk) array (disk array) pd (physical disk) hba (adapter/controller) aes (AES) aeslink (AES link) driver (driver) Note: CLI does not support get -o driver in Linux or Mac OS X. |
Optional Parameters |
|
[-i <VD id|array id|PD id|HBA id|aes port id>] |
Use to specify object ID. Note: This parameter is not applicable to objects aeslink and driver. If this parameter is not included in the command line for all other objects, CLI displays properties for all instances of the object. |
[-h] |
Use to display help text on get command. |
Example |
|
get -o vd -i 2 |
Display properties of virtual disk 2. |
Use info for information on all hardware and software components.
The syntax for the info command (including all required and optional parameters) is as follows:
info -o <hba|vd|pd|array|pm|exp|blk|spare|bbu> [-i <id>] [-h]
Table 5 describes the required and optional parameters for the info command.
Syntax |
Description |
Required Parameter |
|
-o <hba|vd|pd|array|pm|exp|blk|spare|bbu> |
Use one of the following options to select the object: hba (adapter/controller) vd (virtual disk) pd (physical disk) pm (port multiplexer) exp (expander) spare (spare drives) bbu (battery backup unit) |
Optional Parameters |
|
[-i <id>] |
Use to specify object ID. Note: If this parameter is not included in the command line, CLI displays information for all instances of the object. |
[-h] |
Use to display help text on info command. |
Example |
|
info -o vd -i 1 |
Display information on virtual disk 1. |
Use init to start, stop, pause, or resume background initialization for a virtual disk.
The syntax for the init command (including all required and optional parameters) is as follows:
init [-o <vd>] [-a <start|stop|pause|resume>] -l <id>
Table 6 describes the required and optional parameters for the init command.
Syntax |
Description |
Required Parameter |
|
-l <id> |
Use to specify ID of virtual disk. |
Optional Parameters |
|
[-o <vd>] |
Use to specify object as virtual disk. Note: If this parameter is not included in the command line, CLI uses the default object vd. |
[-a <start|stop|pause|resume>] |
Use one of the following options to control background initialization of the virtual disk: start stop pause resume Note: If this parameter is not included in the command line, CLI uses the default action start. |
[-h] |
Use to display help text on init command. |
Example |
|
init -a start -l 0 |
Start full initialization on virtual disk 0. |
The syntax for the set -o vd command (including all required and optional parameters) is as follows:
set -o vd -i <VD id> [-n <new name>] [<--writeback|--writethrough>] [<--readaheadon|--readaheadoff>] [--setfree] [-h]
Table 7 describes the required and optional parameters for the set -o vd command.
Syntax |
Description |
Required Parameter |
|
-i <VD id> |
Use to specify virtual disk ID. |
Optional Parameters |
|
[-n <new name>] |
Use to specify new name for virtual disk. If the name has blank characters, enclose <new name> in quotes. Note: To delete the current name, set <new name> to . (dot). |
[<--writeback|--writethrough>] |
Use one of the following options to select the write cache mode: --writeback (Write Back, Performance) --writethrough (Write Through, Reliable) |
[<--readaheadon|--readaheadoff>] |
Use one of the following options to enable/disable Read Ahead: --readaheadon (Enable Read Ahead) --readaheadoff (Disable Read Ahead) |
[--setfree] |
Use to release an offline disk from a virtual disk. |
[-h] |
Use to display help text on set - o vd command. |
Example |
|
set -o vd -i 2 --readaheadon --writethrough |
Enable Read Ahead and Write Through cache mode on virtual disk 2.
|