User Guide

User Guide
Using the Storage Management Service: Dell OpenManage Server Administrator Version 2.2 Command Line Interface User's Guide

Back to Contents Page

Using the Storage Management Service

Dell OpenManage™ Server Administrator Version 2.2 Command Line Interface User's Guide

  CLI Command Syntax

  Syntax for Required, Optional, and Variable
    Command Elements

  User Privileges for omreport storage and omconfig
    storage

  omreport Command

  omreport Storage Help

  omconfig Global Commands

  omconfig Controller Commands

  omconfig Virtual Disk Commands

  omconfig Array Disk Commands

  omconfig Battery Commands

  omconfig Channel Commands

  omconfig Enclosure Commands


Storage Management has a fully-featured command line interface (CLI) that enables you to perform all of Storage Management's reporting, configuration, and management functions from an operating system command shell. The Storage Management CLI also enables you to script command sequences.

The Storage Management CLI provides expanded options for the Dell OpenManage™ Server Administrator omreport and omconfig commands. This chapter only documents the omreport and omconfig commands that apply to Storage Management. See the Dell OpenManage Installation and Security User's Guide for installation information.


CLI Command Syntax

Like all the Dell OpenManage Server Administrator commands, the omreport and omconfig command syntax consists of specifying command "levels." The first command level is the command name: omreport or omconfig. Subsequent command levels provide a greater degree of specificity regarding the type of object on which the command will operate or the information that the command will display.

For example, the following omconfig command syntax has three levels:

omconfig storage adisk

The following table describes these command levels.

Table 10-1. Example Command Levels

Command level 1

Command level 2

Command level 3

Use

omconfig

 

 

Specifies the command

 

storage

 

Indicates the Server Administrator service (in this case, Storage Management) that implements the command

 

 

adisk

Specifies the type of object on which the command operates

Following the command levels, the omreport and omconfig command syntax may require one or more name=value pairs. The name=value pairs specify exact objects (such as a specific array disk) or options (such as "blink" or "unblink") that the command will implement.

For example, the following omconfig command syntax for blinking an array disk has three levels and three name=value pairs:

omconfig storage adisk action=blink controller=id adisk= <channelNo:targetID>

where id indicates the controller, channel, and array disk number. For example, to blink array disk 1 on channel 2 and controller 1, you would enter:

omconfig storage adisk action=blink controller=1 adisk=2:1

In some cases, the command syntax enables you to specify more than one target. In this case, the target IDs should be comma-separated without spaces. For example, to blink array disks 1, 2, and 3 on channel 2 and controller 1, you would enter:

omconfig storage adisk action=blink controller=1 adisk=2:1,2,3


Syntax for Required, Optional, and Variable Command Elements

The omreport and omconfig commands have multiple name=value pairs. These name=value pairs may include required, optional, and variable parameters. The following table describes the syntax used to indicate these parameters.

Table 10-2. Syntax For Name=Value Pairs For Parameters 

Syntax

Description

controller=id

Indicates the controller ID as reported by the omreport storage controller command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=id to display the IDs for the array disks attached to the controller.

For example, the controller=id parameter might be specified as controller=1.

channel=id

Indicates the channel ID as reported by the omreport command. To obtain this value, you would enter omreport storage controller to display the controller IDs and then enter omreport storage channel controller=id to display the IDs for the channels attached to the controller.

For example, the channel=id parameter might be specified as channel=2.

vdisk=id

Indicates the virtual disk ID as reported by the omreport command. To obtain this value, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=id to display the IDs for the virtual disks on the controller.

For example, the vdisk=id parameter might be specified as vdisk=3.

enclosure=id

Indicates the enclosure ID as reported by the omreport command. To obtain this value, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=id to display the IDs for the enclosures attached to the controller. To display the IDs for the enclosure components, enter omreport storage enclosure controller=id enclosure=id.

For example, the enclosure=id parameter might be specified as enclosure=2.

channelNo:targetID

Indicates a particular array disk by specifying the controller channel that the array disk is attached to and the array disk number. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=id to display the IDs for the array disks attached to the controller.

For example, the channelNo:targetID parameter might be specified as 0:3.

battery=id

Indicates the battery ID as reported by the omreport command. To obtain this value, you would enter omreport storage controller to display the controller IDs and then enter omreport storage battery controller=id to display the ID for the controller battery.

< >

The caret symbols (< >) enclose variable elements that you must specify.

For example, the name=<string> parameter might be specified as name=VirtualDisk1.

[ ]

The bracket symbols ([ ]) indicate optional elements that you can choose to specify or not.

For example, when creating a virtual disk, the [name=<string>] parameter indicates that you have the option of specifying the virtual disk name. If you omit this parameter from the syntax, then a default name for the virtual disk is chosen for you.

|

The pipe symbol (|) separates two or more options from which one only must be selected.

For example, when creating a virtual disk, the cachepolicy=d|c indicates that the cache policy must be specified as either cachepolicy=d or cachepolicy=c.


User Privileges for omreport storage and omconfig storage

Storage Management requires Administrator privileges to use the omconfig storage command. User and Power User privileges are sufficient to use the omreport storage command.


omreport Command

The following sections provide the omreport command syntax required to display the status of various storage components.


omreport Storage Help

The following table provides the omreport storage command syntax.

Table 10-3. omreport storage help 

Command Level 1

Command Level 2

Command Level 3

Use

omreport

 

 

 

 

storage

 

Displays a list of storage components for which omreport commands are available.

 

 

adisk

Displays a list of the omreport storage adisk parameters for displaying array disk information.

 

 

vdisk

Displays a list of omreport storage vdisk parameters for displaying virtual disk information.

 

 

controller

Displays a list of the omreport storage controller parameters for displaying controller information.

 

 

enclosure

Displays a list of the omreport storage enclosure parameters for displaying enclosure information.

 

 

channel

Displays a list of the omreport storage channel parameters for displaying channel information.

 

 

battery

Displays a list of the omreport storage battery parameters for displaying battery information.

 

 

globalinfo

Displays a list of the omreport storage globalinfo parameters for displaying global storage property information.

omreport Controller Status

Table 10-4. omreport Controller Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

Use

omreport storage controller

 

Displays property information for all controllers attached to the system.

 

controller=id

where id is the controller number. For example: controller=0

Displays the specified controller and all attached components such as enclosures, virtual disks, array disks, and so on.

omreport Global Information (Smart Thermal Shutdown Status)

Table 10-5. omreport Global Information Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

Use

omreport storage globalinfo

 

Displays whether smart thermal shutdown is enabled or disabled. See the omconfig Global Enable Smart Thermal Shutdown command for more information.

omreport Battery Status

Table 10-6. omreport Battery Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

Use

omreport storage battery

 

Displays all batteries present on all controllers on the system. (Some controllers do not have batteries).

 

controller=id

where id is the controller number. For example: controller=0

Displays the battery on the specified controller.

omreport Channel Status

Table 10-7. omreport Channel Commands

Required Command Levels (1, 2, 3) and name=value pair

Use

omreport storage channel controller=id

where id is the controller number. For example: controller=0

Displays all channels on the specified controller.

omreport storage channel controller=id channel=id

where id is the controller number. For example: controller=0

Displays information for the specified channel on the controller.

omreport Enclosure Status

Table 10-8. omreport Enclosure Commands 

Required Command Levels (1, 2, 3)

Optional name=value pairs

Use

omreport storage enclosure

 

Displays property information for all enclosures attached to the system.

 

controller=id enclosure=id

where id is the controller number and the enclosure number. For example: controller=0 enclosure=2

Displays the specified enclosure and its components.

omreport Temperature Probe Status

Table 10-9. omreport Temperature Probe Commands

Required Command Levels (1, 2, 3) and name=value pair

Optional name=value pairs

Use

omreport storage enclosure

 

Displays property information for all enclosures attached to the system.

 

controller=id enclosure=id
info=temps

where id is the controller number and the enclosure number. For example: controller=0 enclosure=2

Displays the temperature probes for the specified enclosure.

 

controller=id enclosure=id
info=temps index=n

where id is the controller number and the enclosure number and "n" is the number of a temperature probe. For example: controller=0 enclosure=2 info=temps index=1

Displays the specified temperature probe.

omreport Fan Status

Table 10-10. omreport Fan Status

Required Command Levels (1, 2, 3) and name=value pair

Optional name=value pairs

Use

omreport storage enclosure

 

Displays property information for all enclosures attached to the system.

 

controller=id enclosure=id
info=fans

where id is the controller number and the enclosure number.
For example: controller=0 enclosure=2

Displays the fans for the specified enclosure.

 

controller=id enclosure=id
info=fan index=n

where id is the controller number and the enclosure number and "n" is the number of a fan.
For example: controller=0 enclosure=2 info=fans index=1

Displays the specified fan.

omreport Power Supply Status

Table 10-11. omreport Power Supply Commands 

Required Command Levels (1, 2, 3) and name=value pair

Optional name=value pairs

Use

omreport storage enclosure

 

Displays property information for all enclosures attached to the system.

 

controller=id enclosure=id
info=pwrsupplies

where id is the controller number and the enclosure number.
For example: controller=0 enclosure=2

Displays the power supplies for the specified enclosure.

 

controller=id enclosure=id
info=pwrsupplies index=n

where id is the controller number and the enclosure number and "n" is the number of a power supply.
For example: controller=0 enclosure=2 info=pwrsupplies index=1

Displays the specified power supply.

omreport EMM Status

Table 10-12. omreport EMM Commands

Required Command Levels (1, 2, 3) and name=value pair

Optional name=value pairs

Use

omreport storage enclosure

 

Displays property information for all enclosures attached to the system.

 

controller=id enclosure=id
info=emm
s

where id is the controller number and the enclosure number.
For example: controller=0 enclosure=2

Displays the enclosure management modules (EMMs) for the specified enclosure.

 

controller=id enclosure=id
info=emms index=n

where id is the controller number and the enclosure number and "n" is the number of an EMM.
For example: controller=0 enclosure=2
info=emms index=1

Displays the specified EMMs.

omreport Array Disk Status

Table 10-13. omreport Array Disk Commands

Required Command Levels (1, 2, 3) and name=value pair

Optional name=value pairs

Use

omreport storage adisk controller=id

where id is the controller number. For example: controller=0

 

Displays all array disks attached to the specified controller.

 

channel=id

where id is the channel number. For example: channel=1

Displays all array disks attached to the specified channel on the controller.

 

vdisk=id

where id is the virtual disk number. For example: vdisk=1

Displays all array disks included in the specified virtual disk on the controller.

 

adisk=channelID:targetID

where id is the channel and array disk number. For example: adisk=0:3

Displays the specified array disk on the specified channel on the controller.

omreport Virtual Disk Status

Table 10-14. omreport Virtual Disk Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

Use

omreport storage vdisk

 

Displays property information for all virtual disks on all controllers.

 

controller=id

where id is the controller number. For example: controller=0.

Displays all virtual disks on the specified controller.

 

controller=id vdisk=id

where id is the controller number and the virtual disk number. For example: controller=0 vdisk=1.

Displays the specified virtual disk on the controller.


omconfig Global Commands

The following sections provide the omconfig command syntax required to execute the global commands. When executed, these commands apply to all controllers. These global commands also correspond to the global tasks provided by the Storage tree view object's Information/Configuration subtab.

Table 10-15. omconfig Global Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage globalinfo

 

 

action=enablests

 

action=disablests

 

action=globalrescan

omconfig Global Enable Smart Thermal Shutdown

By default, the operating system and server shut down when the PV220S and PV221S enclosures reach a critical temperature of 0 or 50 degrees celsius. If you have implemented channel redundancy on the PV220S and PV221S enclosures, however, you can specify that only the enclosure and not the operating system and server be shut down when the enclosure reaches a critical temperature of 0 or 50 degrees celsius. Specifying that only the enclosure be shutdown during excessive temperatures is known as "smart thermal shutdown." See the "Channel Redundancy and Thermal Shutdown" section in the online help for more information.

Use the following omconfig command syntax to enable smart thermal shutdown.

Complete Syntax

omconfig storage globalinfo action=enablests

Example Syntax

The omconfig command syntax for enabling thermal shutdown does not require that you specify a controller or enclosure ID. To enable thermal shutdown, enter the following:

omconfig storage globalinfo action=enablests

NOTE: You can use the omreport storage globalinfo command to determine whether smart thermal shutdown is currently enabled or disabled. The status of smart thermal shutdown is also displayed by the Server Administrator graphical user interface. To locate this status, select the Storage object and the Information/Configuration tab.

omconfig Global Disable Smart Thermal Shutdown

If you have previously enabled smart thermal shutdown using the omconfig command, you can disable smart thermal shutdown and return the system to its default setting. When smart thermal shutdown is disabled, the operating system and the server will shut down when the PV220S and PV221S enclosures reach a critical temperature of 0 or 50 degrees celsius.

Use the following omconfig command syntax to disable smart thermal shutdown. This command will disable smart thermal shutdown for all controllers.

Complete Syntax

omconfig storage globalinfo action=disablests

Example Syntax

The omconfig command syntax for disabling thermal shutdown does not require that you specify a controller or enclosure ID. To disable thermal shutdown, enter the following:

omconfig storage globalinfo action=disablests

NOTE: You can use the omreport storage globalinfo command to determine whether smart thermal shutdown is currently enabled or disabled. The status of smart thermal shutdown is also displayed by the Server Administrator graphical user interface. To locate this status, select the Storage object and the Information/Configuration tab.

omconfig Global Rescan Controller

Use the following omconfig command syntax to rescan all controllers on the system. See the online help for more information about using this command.

Complete Syntax

omconfig storage globalinfo action=globalrescan

Example Syntax

The omconfig command syntax for rescanning all controllers on the system does not require that you specify a controller ID. To do a global rescan of all controllers, enter the following:

omconfig storage globalinfo action=globalrescan

NOTE: Global rescan is not supported on non-RAID SCSI controllers. You must reboot the system before Storage Management can see configuration changes on non-RAID SCSI controllers.

omconfig Controller Commands

The following sections provide the omconfig command syntax required to execute controller tasks.

NOTICE: The omconfig storage controller action=resetconfig controller=id resets the controller configuration. Resetting the controller configuration permanently destroys all data on all virtual disks attached to the controller. If the system or boot partition resides on these virtual disks, it will be destroyed.

Table 10-16. omconfig Controller Commands 

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage controller

 

 

action=rescan controller=id

 

action=globalrescan

 

action=enablealarm controller=id

 

action=disablealarm controller=id

 

action=quietalarm controller=id

 

action=testalarm controller=id

 

action=resetconfig controller=id [force=yes]

 

action=createvdisk controller=id raid=<c| r0| r1| r1c| r5| r10| r50> size=<number | max | min> adisk=<channel:targetID> [stripesize=< 2kb| 4kb| 8kb| 16kb| 32kb| 64kb| 128kb>] [cachepolicy=<d | c>] [readpolicy=<ra| nra| ara| rc| nrc>] [writepolicy=<wb| wt| wc| nwc>] [name=<string>] [spanlength=<n>]

 

action=setrebuildrate controller=id rate=<0 to 100>

 

action=exportlog controller=id

omconfig Rescan Controller

Use the following omconfig command syntax to rescan a controller. See the online help for more information about using this command.

Complete Syntax

omconfig storage controller action=rescan controller=id

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to rescan controller 1, you would enter:

omconfig storage controller action=rescan controller=1

NOTE: The rescan controller is not supported on non–RAID SCSI controllers. You must reboot the system before Storage Management can see configuration changes on non-RAID SCSI controllers.

omconfig Global Rescan Controller

The omconfig storage controller action=globalrescan command was supported in previous releases of Storage Management. This command has been replaced by the omconfig storage globalinfo action=globalrescan command. When rescanning all controllers on the system and creating CLI scripts, it is preferable to use the omconfig storage globalinfo action=globalrescan command.

See the online help for more information about using this command.

omconfig Enable Controller Alarm

Use the following omconfig command syntax to enable the controller alarm. See the online help for more information about using this command.

Complete Syntax

omconfig storage controller action=enablealarm controller=id

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to enable the alarm on controller 1, you would enter:

omconfig storage controller action=enablealarm controller=1

omconfig Disable Controller Alarm

Use the following omconfig command syntax to disable the controller alarm. See the online help for more information about using this command.

Complete Syntax

omconfig storage controller action=disablealarm controller=id

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to disable the alarm on controller 1, you would enter:

omconfig storage controller action=disablealarm controller=1

omconfig Quiet Controller Alarm

Use the following omconfig command syntax to silence an activated controller alarm. See the online help for more information about using this command.

Complete Syntax

omconfig storage controller action=quietalarm controller=id

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to quiet the alarm on controller 1, you would enter:

omconfig storage controller action=quietalarm controller=1

omconfig Test Controller Alarm

Use the following omconfig command syntax to test the functionality of the controller alarm. The alarm will sound for about two seconds. See the online help for more information about using this command.

Complete Syntax

omconfig storage controller action=testalarm controller=id

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to test the alarm on controller 1, you would enter:

omconfig storage controller action=testalarm controller=1

omconfig Reset Controller Configuration

Use the following omconfig command syntax to reset the controller configuration.

NOTICE: Resetting a configuration permanently destroys all data on all virtual disks attached to the controller. If the system or boot partition resides on these virtual disks, it will be destroyed. You may receive a warning message if this command will result in deleting the system or boot partition. However, this warning message is not generated in all circumstances. You should be certain that you are not deleting the system or boot partition or other vital data when using this command.

Complete Syntax

omconfig storage controller action=resetconfig controller=id

where id is the controller ID as reported by the omreport storage controller command.

In some circumstances, you may receive a warning message if this command will delete the system or boot partition. You can override this warning by using the [force=yes] parameter. In this case, the syntax is as follows:

omconfig storage controller action=resetconfig controller=id [force=yes]

Example Syntax

For example, to reset the configuration on controller 1, you would enter:

omconfig storage controller action=resetconfig controller=1

omconfig Create Virtual Disk

The online help provides additional information about creating virtual disks.

The omconfig syntax for creating a virtual disk has several parameters. You must specify the following parameters:

  • Controller (controller=id)

  • RAID level (raid=<c| r0| r1| r1c| r5| r10| r50>)

  • Size (size=<number | max | min>)

  • Array disk (adisk=<channel:targetID, channel:targetID>)

The omconfig command supplies default values for any of the other parameters that you do not specify.

Complete Syntax

omconfig storage controller action=createvdisk controller=id raid=<c| r0| r1| r1c| r5| r10| r50> size=<number | max | min> adisk=<channel:targetID,channel:targetID,.....> [stripesize=< 2kb| 4kb| 8kb| 16kb| 32kb| 64kb| 128kb>] [cachepolicy=<d | c>] [readpolicy=<ra| nra| ara| rc| nrc>] [writepolicy=<wb| wt| wc| nwc>] [name=<string>] [spanlength=<n>]

Parameter Specification for Create and Reconfigure Virtual Disk

The following sections indicate how to specify the omconfig storage controller action=createvdisk parameters.

controller=id Parameter (Required)

raid=<c| r0| r1| r1c| r5| r10| r50> Parameter (Required)

size=<number | max | min> Parameter (Required)

adisk=<channel:targetID,channel:targetID,.....> Parameter (Required)

[stripesize=< 2kb| 4kb| 8kb| 16kb| 32kb| 64kb| 128kb>] Parameter (Optional)

[cachepolicy=<d | c>] Parameter (Optional)

[readpolicy=<ra| nra| ara| rc| nrc>] Parameter (Optional)

[writepolicy=<wb| wt| wc| nwc>] Parameter (Optional)

[name=<string>] Parameter (Optional)

[spanlength=<n>] Parameter (Optional)

controller=id Parameter (Required)

Specify the controller ID as reported by the omreport storage controller command. For example:

controller=2

raid=<c| r0| r1| r1c| r5| r10| r50> Parameter (Required)

Use the raid=<c| r0| r1| r1c| r5| r10| r50> parameter to specify concatenation or a RAID level for a virtual disk. Different controllers support different RAID levels. See the online help for information on the RAID levels a controller supports and for general information about RAID levels and concatenation. The following table indicates how to specify the raid=n parameter for each RAID level and concatenation.

Table 10-17. Raid Level And Concatenation 

RAID Level or Concatenation

raid=n Parameter Specification

RAID 0

raid=r0

RAID 1

raid=r1

RAID 5

raid=r5

RAID 10

raid=r10

RAID 50

raid=r50

RAID 1-concatenated

raid=r1c

Concatenation

raid=c

size=<number | max | min> Parameter (Required)

The following table indicates how to specify the size=<number | max | min> parameter.

Table 10-18. Size Parameter

size=<number | max | min> Parameter Specification

Description

size=<n>

Use this specification to indicate a specific size for the virtual disk. The virtual disk size may be specified in b (bytes), m (megabytes), or g (gigabytes). For example, size=500m indicates that the virtual disk should be 500 MB.

size=max

To create a virtual disk that is the maximum size possible, specify size=max. When creating a RAID 50 virtual disk, this parameter must be specified as size=max.

size=min

To create a virtual disk that is the minimum size possible, specify size=min.

adisk=<channel:targetID,channel:targetID,.....> Parameter (Required)

Use this parameter to specify the array disks that will be included in the virtual disk.

When reconfiguring a virtual disk, you must specify all array disks to be included in the reconfigured virtual disk. The array disk specification applies to array disks that were in the original virtual disk and will continue to be in the reconfigured virtual disk and to any new array disks being added to the reconfigured virtual disk. Some controllers allow you to remove an array disk from a virtual disk. In this case, you would not specify the array disk to be removed.

The channel:targetID element indicates an array disk by specifying the controller channel that the array disk is attached to and the array disk number. Repeat the channel:targetID element as many times as necessary to specify additional array disks. For example:

adisk=1:0,1:1,1:2

stripesize=< 2kb| 4kb| 8kb| 16kb| 32kb| 64kb| 128kb>] Parameter (Optional)

Different controllers support different stripe sizes. See the online help for information on which stripe sizes are supported for a controller. All stripe sizes are specified in kilobytes. For example, when specifying 128 KB as the stripe size, you would enter:

stripesize=128kb

[cachepolicy=<d | c>] Parameter (Optional)

Different controllers support different cache policies. See the online help for more information. The following table indicates how to specify the [cachepolicy=<d | c>] parameter for each of the cache policies.

Table 10-19. Cache Policy Parameters

Read Policy

cachepolicy=d | c Parameter Specification

Direct I/O

cachepolicy=d

Cache I/O

cachepolicy=c

[readpolicy=<ra| nra| ara| rc| nrc>] Parameter (Optional)

Different controllers support different read policies. See the online help for more information. The following table indicates how to specify the [readpolicy=<ra| nra| ara| rc| nrc>] parameter for each of the read policies.

Table 10-20. Read Policy Paramaters 

Read Policy

readpolicy=ra | ara | nra | rc | nrc Parameter Specification

Read ahead

readpolicy=ra

Adaptive read ahead

readpolicy=ara

No read ahead

readpolicy=nra

Read cache

readpolicy=rc

No read cache

readpolicy=nrc

[writepolicy=<wb| wt| wc| nwc>] Parameter (Optional)

Different controllers support different write policies. See the online help for more information. The following table indicates how to specify the [writepolicy=<wb| wt| wc| nwc>] parameter for each of the write policies.

Table 10-21. Write Policies Parameters 

Read Policy

writepolicy=wb | wt | wc | nwc Parameter Specification

Write–back cache

writepolicy=wb

Write–through cache

writepolicy=wt

Write cache

writepolicy=wc

No write cache

writepolicy=nwc

[name=<string>] Parameter (Optional)

Use this parameter to specify a name for the virtual disk. For example:

name=VirtualDisk1

NOTE: The CERC SATA 1.5/2s controller does not allow you to specify a virtual disk name. The virtual disk will be created with a default name.

[spanlength=<n>] Parameter (Required for RAID 50)

Use this parameter to specify the number of array disks to be included in each stripe. This parameter only applies to RAID 50 virtual disks. If you are not creating a RAID 50 virtual disk, do not specify this parameter. For example:

spanlength=3

Example Syntax

For example, you may want to create a RAID 5 virtual disk on a PERC 3/QC controller. The online help will help you understand which read, write, and cache policies are supported by this controller. In this example, you decide to create a virtual disk with the following read, write, and cache policy:

  • Read-ahead

  • Write–through caching

  • Cache I/O

The virtual disk will be 500 MB with a stripe size of 16 KB. The name of the virtual disk will be vd1 and it will reside on channel 0 of controller 1. Because the virtual disk will be a RAID 5, it requires at least three array disks. In this example, you specify four array disks. These are array disks 0 through 3.

To create the virtual disk described in this example, you would enter:

omconfig storage controller action=createvdisk controller=1 raid=r5 size=500m adisk=0:0,0:1,0:2,0:3 stripesize=16kb cachepolicy=c readpolicy=ra writepolicy=wt

The only parameters that require specification are for the controller, RAID level, virtual disk size, and array disk selection. The omconfig command supplies default values for all other unspecified parameters.

omconfig Set Controller Rebuild Rate

Use the following omconfig command syntax to set the controller rebuild rate:

Complete Syntax

omconfig storage controller action=setrebuildrate controller=id rate=<0 to 100>

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to set the rebuild rate on controller 1 to 50, you would enter:

omconfig storage controller action=setrebuildrate controller=1 rate=50

omconfig Export the Controller Log

Use the following omconfig command syntax to export the controller log to a text file. For more information about the exported log file, see the online help.

Complete Syntax

omconfig storage controller action=exportlog controller=id

where id is the controller ID as reported by the omreport storage controller command.

Example Syntax

For example, to export the log on controller 1, you would enter:

omconfig storage controller action=exportlog controller=1

By default, the log file is exported to the <install-directory>/sm directory where <install-directory> is the directory where you have installed Server Administrator.

Depending on the controller, the log file name will be either afa_<mmdd>.log or lsi_<mmdd>.log where <mmdd> is the month and date. For more information on the controller log file, see the online help.

NOTE: The Export Log File command is not supported on the PERC 2/SC, 2/DC, 4/IM, CERC ATA 100/4ch, and CERC SATA 1.5/2s controllers.

omconfig Virtual Disk Commands

The following sections provide the omconfig command syntax required to execute virtual disk tasks.

NOTICE: The omconfig storage vdisk action=deletevdisk controller=id vdisk=id command deletes a virtual disk. Deleting a virtual disk destroys all information including file systems and volumes residing on the virtual disk.

Table 10-22. omconfig Manage Virtual Disk Commands 

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage vdisk

 

 

action=checkconsistency controller=id vdisk=id

 

action=cancelcheckconsistency controller=id vdisk=id

 

action=pausecheckconsistency controller=id vdisk=id

 

action=resumecheckconsistency controller=id vdisk=id

 

action=blink controller=id vdisk=id

 

action=unblink controller=id vdisk=id

 

action=initialize controller=id vdisk=id

 

action=cancelinitialize controller=id vdisk=id

 

action=cancelbginitialize controller=id vdisk=id

 

action=restoresegments controller=id vdisk=id

 

action=splitmirror controller=id vdisk=id

 

action=unmirror controller=id vdisk=id

 

action=assigndedicatedhotspare controller=id vdisk=id adisk=<channelNo:targetID> assign=<yes|no>

 

action=deletevdisk controller=id vdisk=id [force=yes]

 

action=format controller=id vdisk=id

 

action=reconfigure controller=id vdisk=id raid=<c| r0| r1| r1c| r5| r10> size=<size> adisk=<channel:targetID,channel:targetID,.....>

 

action=changepolicy controller=id vdisk=id [readpolicy=<ra| nra| ara| rc| nrc> | writepolicy=<wb| wt| wc| nwc> | cachepolicy=<d | c>]

 

action=rename controller=id vdisk=id

omconfig Blink Virtual Disk

Use the following omconfig command syntax to blink the array disks included in a virtual disk.

Complete Syntax

omconfig storage vdisk action=blink controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to blink the array disks in virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=blink controller=1 vdisk=4

omconfig Unblink Virtual Disk

Use the following omconfig command syntax to unblink the array disks included in a virtual disk.

Complete Syntax

omconfig storage vdisk action=unblink controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to blink the array disks in virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=unblink controller=1 vdisk=4

omconfig Initialize Virtual Disk

Use the following omconfig command syntax to initialize a virtual disk.

Complete Syntax

omconfig storage vdisk action=initialize controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to initialize virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=initialize controller=1 vdisk=4

omconfig Cancel Initialize Virtual Disk

Use the following omconfig command syntax to cancel the initialization of a virtual disk.

Complete Syntax

omconfig storage vdisk action=cancelinitialize controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to cancel the initialization of virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=cancelinitialize controller=1 vdisk=4

omconfig Cancel Background Initialize

Use the following omconfig command syntax to cancel the background initialization process on a virtual disk.

Complete Syntax

omconfig storage vdisk action=cancelbginitialize controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to cancel background initialization on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=cancelbginitialize controller=1 vdisk=4

omconfig Restore Dead Segments

Use the following omconfig command syntax to recover data from a RAID-5 virtual disk that has been corrupted. This task attempts to reconstruct data from a corrupt portion of an array disk included in a RAID-5 virtual disk.

Complete Syntax

omconfig storage vdisk action=restoresegments controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to restore segments on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=restoresegments controller=1 vdisk=4

omconfig Split Mirror

Use the following omconfig command syntax to separate mirrored data originally configured as a RAID 1, RAID 1–concatenated, or RAID 10 virtual disk. Splitting a RAID 1 or RAID 1–concatenated mirror creates two concatenated nonredundant virtual disks. Splitting a RAID 10 mirror creates two RAID 0 (striped) nonredundant virtual disks. Data is not lost during this operation.

Complete Syntax

omconfig storage vdisk action=splitmirror controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to initiate a split mirror on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=splitmirror controller=1 vdisk=4

omconfig Unmirror

Use the following omconfig command syntax to separate mirrored data and restore one half of the mirror to free space. Unmirroring a RAID 1 or RAID 1–concatenated virtual disk results in a single, nonredundant concatenated virtual disk. Unmirroring a RAID 10 virtual disk results in a single, nonredundant RAID 0 (striped) virtual disk. Data is not lost during this operation. See the online help for more information about using this command.

Complete Syntax

omconfig storage vdisk action=unmirror controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to unmirror virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=unmirror controller=1 vdisk=4

omconfig Assign Dedicated Hot Spare

Use the following omconfig command syntax to assign one or more array disks to a virtual disk as a dedicated hot spare.

NOTE: The PERC 2/SC, 2/DC, and CERC SATA 1.5/2s controllers do not support dedicated hot spares.

Complete Syntax

omconfig storage vdisk action=assigndedicatedhotspare controller=id vdisk=id [adisk= channelID:targetID,channelID:targetID,...] assign=yes

where id is the controller ID and virtual disk ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID and omreport storage adisk controller=ID to display the IDs for the virtual disks and array disks attached to the controller.

Example Syntax

For example, to assign array disk 3 on channel 0 of controller 1 to virtual disk 4, you would enter:

omconfig storage vdisk action=assigndedicatedhotspare controller=1 vdisk=4 adisk=0:3 assign=yes

You may want to assign more than one array disk as a dedicated hot spare. In this example, you want to assign array disk 3 on channel 0 and array disk 2 on channel 1 as dedicated hot spares:

omconfig storage vdisk action=setdedicatedhotspare controller=1 vdisk=4 adisk=0:3,1:2 assign=yes

omconfig Unassign Dedicated Hot Spare

Use the following omconfig command syntax to unassign one or more array disks that were previously assigned as a hot spare to a virtual disk.

Complete Syntax

omconfig storage vdisk action=assigndedicatedhotspare controller=id vdisk=id [adisk= channelID:targetID,channelID:targetID,...] assign=no

where id is the controller ID and virtual disk ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID and omreport storage adisk controller=ID to display the IDs for the virtual disks and array disks attached to the controller.

Example Syntax

For example, to unassign array disk 3 on channel 0 of controller 1 to virtual disk 4, you would enter:

omconfig storage vdisk action=assigndedicatedhotspare controller=1 vdisk=4 adisk=0:3 assign=no

You can also unassign more than one array disks that have been assigned as hot spares. In this example, you want to unassign array disk 3 on channel 0 and array disk 2 on channel 1 as dedicated hot spares:

omconfig storage vdisk action=assigndedicatedhotspare controller=1 vdisk=4 adisk=0:3,1:2 assign=no

omconfig Check Consistency

Use the following omconfig command syntax to initiate a check consistency on a virtual disk. The check consistency task verifies the virtual disk's redundant data.

Complete Syntax

omconfig storage vdisk action=checkconsistency controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to run a check consistency on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=checkconsistency controller=1 vdisk=4

omconfig Cancel Check Consistency

Use the following omconfig command syntax to cancel a check consistency while it is in progress.

Complete Syntax

omconfig storage vdisk action=cancelcheckconsistency controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to cancel a check consistency on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=cancelcheckconsistency controller=1 vdisk=4

omconfig Pause Check Consistency

Use the following omconfig command syntax to pause a check consistency while it is in progress. See the online help for more information.

Complete Syntax

omconfig storage vdisk action=pausecheckconsistency controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to pause a check consistency on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=pausecheckconsistency controller=1 vdisk=4

omconfig Resume Check Consistency

Use the following omconfig command syntax to resume a check consistency after it has been paused.

Complete Syntax

omconfig storage vdisk action=resumecheckconsistency controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to resume a check consistency on virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=resumecheckconsistency controller=1 vdisk=4

omconfig Delete Virtual Disk

Use the following omconfig command syntax to delete a virtual disk.

NOTICE: Deleting a virtual disk destroys all information including file systems and volumes residing on the virtual disk. You may receive a warning message if you attempt to delete the system or boot partition. However, this warning message is not generated in all circumstances. You should be certain that you are not deleting the system or boot partition or other vital data when using this command.

Complete Syntax

omconfig storage vdisk action=deletevdisk controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

In some circumstances, you may receive a warning message if you attempt to delete a virtual disk containing the system or boot partition. You can override this warning by using the [force=yes] parameter. In this case, the syntax is as follows:

omconfig storage vdisk action=deletevdisk controller=id vdisk=id [force=yes]

Example Syntax

For example, to delete virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=deletevdisk controller=1 vdisk=4

omconfig Format Virtual Disk

Use the following omconfig command syntax to format a virtual disk.

Complete Syntax

omconfig storage vdisk action=format controller=id vdisk=id

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to format virtual disk 4 on controller 1, you would enter:

omconfig storage vdisk action=format controller=1 vdisk=4

omconfig Reconfiguring Virtual Disks

You can reconfigure a virtual disk in order to change the virtual disk's RAID level or increase its size by adding array disks. On some controllers, you can also remove array disks.

Complete Syntax

omconfig storage vdisk action=reconfigure controller=id vdisk=id raid=<c| r0| r1| r1c| r5| r10> size=<size> adisk= <channel:targetID,channel:targetID,.....>

See the online help for information on specifying the parameters.

Example Syntax

For example, you wish to reconfigure virtual disk 4 to a size of 800 MB. You will use RAID 5 and array disks 0 through 3 on channel 0 of controller 1. In this example, you would enter:

omconfig storage vdisk action=reconfigure controller=1 vdisk=4 raid=r5 size=800m adisk=0:0,0:1,0:2,0:3

omconfig Change Virtual Disk Policy

Use the following omconfig command syntax to change a virtual disk's read, write, or cache policy.

Complete Syntax

omconfig storage vdisk action=changepolicy controller=id vdisk=id [readpolicy=<ra| nra| ara| rc| nrc> | writepolicy=<wb| wt| wc| nwc> | cachepolicy=<d | c>]

where id is the controller ID and virtual disk ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

For information on the controller-specific read, write, and cache policy, see the online help. For information on how to specify these parameters using the omconfig command, see the following:

  • [readpolicy=<ra| nra| ara| rc| nrc>] Parameter (Optional)

  • [writepolicy=<wb| wt| wc| nwc>] Parameter (Optional)

  • [cachepolicy=<d | c>] Parameter (Optional)

Example Syntax

For example, to change the read policy of virtual disk 4 on controller 1 to no-read-ahead, you would enter:

omconfig storage vdisk action=changepolicy controller=1 vdisk=4 readpolicy=nra

omconfig Rename Virtual Disk

Use the following omconfig command syntax to rename a virtual disk.

NOTE: On a CERC SATA 1.5/2s controller, you cannot change the default name of a virtual disk.

Complete Syntax

action=rename controller=id vdisk=id name=<string>

where id is the controller ID and virtual disk ID as reported by the omreport command and <string> is the new name for the virtual disk. To obtain the values for controller ID and virtual disk ID, you would enter omreport storage controller to display the controller IDs and then enter omreport storage vdisk controller=ID to display the IDs for the virtual disks attached to the controller.

Example Syntax

For example, to rename virtual disk 4 on controller 1 to vd4, you would enter:

omconfig storage vdisk action=rename controller=1 vdisk=4 name=vd4


omconfig Array Disk Commands

The following sections provide the omconfig command syntax required to execute array disk tasks.

Table 10-23. omconfig Array Disk Commands 

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage adisk

 

 

action=blink controller=id adisk=<channelNo:targetID>

 

action=unblink controller=id adisk=<channelNo:targetID>

 

action=remove controller=id adisk=<channelNo:targetID>

 

action=initialize controller=id adisk=<channelNo:targetID>

 

action=offline controller=id adisk=<channelNo:targetID>

 

action=online controller=id adisk=<channelNo:targetID>

 

action=assignglobalhotspare controller=id adisk=<channelNo:targetID> assign=<yes|no>

 

action=rebuild controller=id adisk=<channelNo:targetID>

 

action=cancelrebuild controller=id adisk=channelID:targetID

 

action=removedeadsegments controller=id adisk=<channelNo:targetID>

omconfig Blink Array Disk

You can blink the light (light emitting diode or LED display) on one or more array disks attached to a controller. Use the following omconfig command syntax to blink one or more array disks.

Complete Syntax

action=blink controller=ID action=blink controller=id adisk= <channelNo:targetID>

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to blink array disks 0 through 2 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=blink controller=1 adisk= 0:0,0:1,0:2

omconfig Unblink Array Disk

You unblink the light (light emitting diode or LED display) on one or more array disks attached to a controller. Use the following omconfig command syntax to unblink one or more array disks.

Complete Syntax

omconfig storage adisk action=unblink controller=id adisk= channelID:targetID, channelID:targetId, channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to unblink array disks 0 through 2 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=unblink controller=1 adisk= 0:0,0:1,0:2

omconfig Prepare to Remove Array Disk

Use the following omconfig command syntax to prepare an array disk for removal:

Complete Syntax

omconfig storage adisk action=remove controller=id adisk= channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to prepare array disk 3 on channel 0 of controller 1 for removal, you would enter:

omconfig storage adisk action=remove controller=1 adisk=0:3

omconfig Initialize Array Disk

Use the following omconfig command syntax to initialize an array disk.

Complete Syntax

omconfig storage adisk action=initialize controller=id adisk= channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to initialize array disk 3 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=initialize controller=1 adisk=0:3

omconfig Offline Array Disk

Use the following omconfig command syntax to offline an array disk:

Complete Syntax

omconfig storage adisk action=offline controller=id adisk= channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to offline array disk 3 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=offline controller=1 adisk=0:3

omconfig Online Array Disk

Use the following omconfig command syntax to bring an offline array disk back online.

Complete Syntax

omconfig storage adisk action=online controller=id adisk= channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to bring array disk 3 on channel 0 of controller 1 back online, you would enter:

omconfig storage adisk action=online controller=1 adisk=0:3

omconfig Assign Global Hot Spare

Use the following omconfig command syntax to assign an array disk as a global hot spare.

Complete Syntax

omconfig storage adisk action=assignglobalhotspare controller=id adisk=channelID:targetID assign=yes

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to assign array disk 3 on channel 0 of controller 1 as a global hot spare, you would enter:

omconfig storage adisk action=assignglobalhotspare controller= 1 adisk=0:3 assign=yes

omconfig Unassign Global Hot Spare

Use the following omconfig command syntax to unassign an array disk as a global hot spare.

Complete Syntax

omconfig storage adisk action=assignglobalhotspare controller=id adisk=channelID:targetID assign=no

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to unassign array disk 3 on channel 0 of controller 1 as a global hot spare, you would enter:

omconfig storage adisk action=assignglobalhotspare controller=1 adisk=0:3 assign=no

omconfig Rebuild Array Disk

Use the following omconfig command syntax to rebuild a failed array disk. Rebuilding a disk may take several hours. If you need to cancel the rebuild, use the Cancel Rebuild task. For more information, see the online help.

Complete Syntax

omconfig storage adisk action=rebuild controller=id adisk= channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to rebuild array disk 3 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=rebuild controller=1 adisk=0:3

omconfig Cancel Rebuild Array Disk

Use the following omconfig command syntax to cancel a rebuild that is in progress. If you cancel a rebuild, the virtual disk remains in a degraded state. See the online help for more information.

Complete Syntax

omconfig storage adisk action=cancelrebuild controller=id adisk=channelID:targetID

where "id" is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to cancel the rebuild of array disk 3 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=cancelrebuild controller=1 adisk=0:3

omconfig Remove Dead Segments

Use the following omconfig command syntax to recover unusable disk space. See the online help for more information.

Complete Syntax

omconfigs storage adisk action=removedeadsegments controller=id adisk=channelID:targetID

where id is the controller ID and "channelID:targetID" is the channel number and array disk number as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage adisk controller=ID to display the IDs for the array disks attached to the controller.

Example Syntax

For example, to remove dead disk segments on array disk 3 on channel 0 of controller 1, you would enter:

omconfig storage adisk action=removedeadsegments controller=1 adisk=0:3


omconfig Battery Commands

The following sections provide the omconfig command syntax required to execute battery tasks.

Table 10-24. omconfig Battery Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage battery

 

 

action=recondition controller=id battery=id

omconfig Recondition Battery

Use the following omconfig command to recondition a controller battery. For more information on batteries and the recondition process, see the online help.

Complete Syntax

omconfig storage battery action=recondition controller=id battery=id

where id is the controller ID and battery ID as reported by the omreport command. To obtain this value, you would enter omreport storage controller to display the controller IDs and then enter omreport storage battery controller=ID to display the ID for the controller battery.

Example Syntax

For example, to recondition the battery on controller 1, you would enter:

omconfig storage battery action=recondition controller=1 battery=0


omconfig Channel Commands

The following sections provide the omconfig command syntax required to execute channel tasks.

Table 10-25. omconfig Channel Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage channel

 

 

action=rescan controller=id channel=id

omconfig Rescan Channel

Use the following omconfig command to rescan a controller channel. This command rescans all channels on the controller and is therefore similar to performing a controller rescan.

Complete Syntax

omconfig storage channel action=rescan controller=id channel=id

where id is the controller ID and the channel ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage channel controller=ID to display the IDs for the channels attached to the controller.

Example Syntax

For example, to rescan channel 2 on controller 1, you would enter:

omconfig storage channel action=rescan controller=1 channel=2


omconfig Enclosure Commands

The following sections provide the omconfig command syntax required to execute enclosure tasks.

Table 10-26. omconfig Enclosure Commands

Required Command Levels (1, 2, 3)

Optional name=value pairs

omconfig storage enclosure

 

 

action=enablealarm controller=id enclosure=id

 

action=disablealarm controller=id enclosure=id

 

action=enablests

 

action=disablests

 

action=setassettag controller=id enclosure=id assettag=<string>

 

action=setassetname controller=id enclosure=id assetname=<string>

 

action=settempprobes controller=id enclosure=id index=id minwarn=n maxwarn=n

 

action=resettempprobes controller=id enclosure=id index=id

omconfig Enable Enclosure Alarm

Use the following omconfig command syntax to enable the enclosure alarm:

Complete Syntax

omconfig storage enclosure action=enablealarm controller=id enclosure=id

where id is the controller ID and enclosure ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=ID to display the IDs for the enclosures attached to the controller.

Example Syntax

For example, to enable the alarm on enclosure 2 on controller 1, you would enter:

omconfig storage enclosure action=enablealarm controller=1 enclosure=2

omconfig Disable Enclosure Alarm

Use the following omconfig command syntax to disable the enclosure alarm.

Complete Syntax

omconfig storage enclosure action=disablealarm controller=id enclosure=id

where id is the controller ID and enclosure ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=ID to display the IDs for the enclosures attached to the controller.

Example Syntax

For example, to disable the alarm on enclosure 2 on controller 1, you would enter:

omconfig storage enclosure action=disablealarm controller=1 enclosure=2

omconfig Enable Smart Thermal Shutdown

The omconfig storage enclosure action=enablests command was supported in previous releases of Storage Management. This command has been replaced by the omconfig storage globalinfo action=enablests command. When enabling smart thermal shutdown and creating CLI scripts, it is preferable to use the omconfig storage globalinfo action=enablests command.

See the omconfig Global Enable Smart Thermal Shutdown command for more information.

omconfig Disable Smart Thermal Shutdown

The omconfig storage enclosure action=disablests command was supported in previous releases of Storage Management. This command has been replaced by the omconfig storage globalinfo action=disablests command. When disabling smart thermal shutdown and creating CLI scripts, it is preferable to use the omconfig storage globalinfo action=disablests command.

See the omconfig Global Disable Smart Thermal Shutdown command for more information.

omconfig Set Enclosure Asset Tag

Use the following omconfig command syntax to specify the enclosure's asset tag:

Complete Syntax

omconfig storage enclosure action=setassettag controller=id enclosure=id assettag=<string>

where id is the controller ID and enclosure ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=ID to display the IDs for the enclosures attached to the controller.

In this syntax, <string> is a user-specified alphanumeric string.

Example Syntax

For example, to specify the asset tag on enclosure 2 on controller 1 to encl20, you would enter:

omconfig storage enclosure action=setassettag controller=1 enclosure=2 assettag=encl20

omconfig Set Enclosure Asset Name

Use the following omconfig command syntax to specify the asset name for an enclosure.

Complete Syntax

omconfig storage enclosure action=setassetname controller=id enclosure=id assetname=<string>

where id is the controller ID and enclosure ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=ID to display the IDs for the enclosures attached to the controller.

In this syntax, <string> is a user-specified alphanumeric string.

Example Syntax

For example, to specify the asset name for enclosure 2 on controller 1 to encl43, you would enter:

omconfig storage enclosure action=setassetname controller=1 enclosure=2 assetname=encl43

omconfig Set Temperature Probe Thresholds

Use the following omconfig command syntax to set the minimum and maximum warning temperature thresholds for a specified temperature probe.

Complete Syntax

omconfig storage enclosure action=settempprobes controller=id enclosure=id index=id minwarn=n maxwarn=n

where id is the controller ID, the enclosure ID, and the temperature probe ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=ID to display the IDs for the enclosures attached to the controller. To display the IDs for the enclosure components, enter omreport storage enclosure controller=ID enclosure ID.

In this syntax, "n" is a user-specified value for the temperature in celsius.

Example Syntax

For example, you may want to specify the minimum and maximum warning thresholds for temperature probe 3 in enclosure 2 on controller 1. To set these thresholds to 10 celsius and 40 celsius you would enter:

omconfig storage enclosure action=settempprobes controller=1 enclosure=2 index=3 minwarn=10 maxwarn=40

omconfig Reset Temperature Probe Thresholds

Use the following omconfig command syntax to reset the minimum and maximum warning temperature thresholds back to their default values.

Complete Syntax

omconfig storage enclosure action=resettempprobes controller= id enclosure=id index=id

where id is the controller ID, the enclosure ID, and the temperature probe ID as reported by the omreport command. To obtain these values, you would enter omreport storage controller to display the controller IDs and then enter omreport storage enclosure controller=ID to display the IDs for the enclosures attached to the controller. To display the IDs for the enclosure components, enter omreport storage enclosure controller=ID enclosure ID.

Example Syntax

For example, you may want to reset the thresholds for temperature probe 3 in enclosure 2 on controller 1. To reset these thresholds you would enter:

omconfig storage enclosure action=resettemprobes controller=1 enclosure=2 index=3


Back to Contents Page

 

All rights reserved : About Dell | Site Terms | Terms and Conditions | Unresolved Issues | Privacy | Site Map | Feedback

* IMPORTANT DELL DETAILS:

DELL'S NORMAL TERMS AND CONDITIONS APPLY AND ARE AVAILABLE ONLINE OR UPON REQUEST. While all efforts are made to check pricing and other errors, inadvertent errors do occur from time to time and Dell reserves the right to decline orders arising from such errors.

Product image on the page is for your reference only.

snWEB3