Managing Physical Disks

Table 1 lists the commands used for managing physical disks.

Table 1  Managing Physical Disks

Command

IOC

IOP

ROC

Description

assign

Assign a disk as a spare drive.

delete 

Delete virtual disk or spare drive.

get

Get configuration information of VD, PD, array, HBA, or driver.

info

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

Locate the specified physical disk.

mp

Start, stop, pause, or resume media patrol for a physical disk.

set -o pd

Set configuration parameters of PD.

assign

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.

Table 2  Command Parameters: assign

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.

delete

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.

get

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.

Table 4  Command Parameters: get (continued)

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.

info

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.

Table 5  Command Parameters: info

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.

locate

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.

Table 6  Command Parameters: locate

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.

mp

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.

Table 7  Command Parameters: mp

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.

set -o pd

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.

Table 8  Command Parameters: set -o pd

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.