Table 1 lists the commands used for managing physical disks.
Table 1 Managing Physical Disks
Command |
IOC |
IOP |
ROC |
Description |
● |
● |
● |
Assign a disk as a spare drive. | |
● |
● |
● |
Delete virtual disk or spare drive. | |
● |
● |
● |
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. | |
● |
● |
● |
Locate the specified physical disk. | |
● |
● |
● |
Start, stop, pause, or resume media patrol for a physical disk. | |
● |
● |
● |
Set configuration parameters of PD. |
Use assign to assign a physical disk as a spare drive.
The syntax for the assign command (including all required and optional parameters) is as follows:
assign -o <hba|array> -d <PD id> [-a <array id>] [--waiveconfirmation] [-h]
Table 2 describes the required and optional parameters for the assign command.
Syntax |
Description |
Required Parameter |
|
-o <hba|array> |
Use one of the following options to assign a physical disk as either a global spare drive or dedicated spare drive: hba (global spare drive) array (dedicated spare drive) Note: If this parameter is not included in the command line, CLI uses the default object hba. |
-d <PD id> |
Use to specify ID of physical disk which is assigned as spare drive. |
Optional Parameters |
|
[-a <array id>] |
Use when creating a dedicated spare drive (-o array). Note: This is applicable only for RAID-On-Chip (ROC) controllers. |
[--waiveconfirmation] |
Use to waive step requiring user confirmation of spare drive assignment. |
[-h] |
Use to display help text for the assign command. |
Example |
|
assign -o array -a 3 -d 2 |
Assign physical disk 2 as a dedicated spare drive to array 3 after receiving user confirmation. |
Use delete to delete a virtual disk or release a physical disk from its spare status.
The syntax for the delete command (including all required and optional parameters) is as follows:
delete -o <vd|array|spare> -i <id> [-f] [--waiveconfirmation] [-h]
Table 3 describes the required and optional parameters for the delete command.
Table 3 Command Parameters: delete |
Syntax |
Description |
Required Parameter |
|
-o <vd|array|spare> |
Use one of the following options to select the object to be deleted: vd (virtual disk) array (array) spare (spare drive) |
-i <id> |
Use to specify object ID. |
Optional Parameters |
|
[-f] |
Use to force deletion of virtual disk or array even if rebuild or migration is in progress. |
[--waiveconfirmation] |
Use to waive step requiring user confirmation of object deletion. |
[-h] |
Use to display help text for the delete command. |
Examples |
|
delete -o spare -i 3 |
Release physical disk 3 from spare status. |
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 pd -i 2 |
Display properties of physical 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 (HBA) 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. |
Examples |
|
info -o exp |
Display information on all expanders |
info -o pm |
Display information on all port multipliers. |
Use locate to locate a physical disk in an enclosure or backplane.
Note: The locate command works for enclosures and backplanes that support the locate feature. When locate is turned on, the LED of the physical disk glows or blinks depending on the design of the enclosure.
The syntax for the locate command (including all required and optional parameters) is as follows:
locate -o <pd> -i <PD ID> -a <on|off>
Table 6 describes the required and optional parameters for the locate command.
Syntax |
Description |
Required Parameters |
|
-o <pd> |
Use to specify object as physical disk. |
-i <PD ID> |
Use to specify physical disk ID. |
-a <on/off> |
Use one of the following options to turn locate on and off: on (turn locate on) off (turn locate off) |
Optional Parameter |
|
[-h] |
Use to display help text on locate command. |
Example |
|
locate -o pd -i 1 -a on |
Turn locate on for physical disk 1. |
Use mp to start, stop, pause, or resume media patrol for a configured physical disk (that is part of a virtual disk) or a spare drive.
The syntax for the mp command (including all required and optional parameters) is as follows:
mp [-a <start|stop|pause|resume>] -d <PDid> [-h]
Table 7 describes the required and optional parameters for the mp command.
Syntax |
Description |
Required Parameters |
|
[-a <start|stop|pause|resume>] |
Use one of the following options to control media patrol for a physical disk: start stop pause resume Note: If this parameter is not included in the command line, CLI uses the default action start. |
-d <PDid> |
Use to specify physical disk ID. |
Optional Parameter |
|
[-h] |
Use to display help text for the mp command. |
Example |
|
mp -a pause -d 0 |
Pause media patrol on physical disk 0. |
The syntax for the set -o pd command (including all required and optional parameters) is as follows:
set -o <pd> -i <PD id> [<--cacheon|--cacheoff>] [-h]
Table 8 describes the required and optional parameters for the set -o pd command.
Syntax |
Description |
Required Parameter |
|
-i <PD id> |
Use to specify physical disk ID. |
Optional Parameters |
|
[<--cacheon|--cacheoff>] |
Use one of the following options to enable/disable caches: --cacheon (enable cache) --cacheoff (disable cache) |
[-h] |
Use to display help text for the set - o pd command. |
Example |
|
set -o pd -i 3 --cacheon |
Enable cache on physical disk 3. |