C H A P T E R  18

hrconf Commands


hrconf Commands

The following are the hrconf commands:

hrconf backup

Description

For large-scale deployments, stores the current controller and disk drive configuration setting to a specific file. Stored files can be used with the restore command to restore to another controller or disk drive. To restore, the controller or disk drive must have the same configuration as it did before the backup. For example: the same type of controller, same number and type of disk drives with same IDs and channels.

Syntax

hrconf backup controller# filename

Options

The controller number

The relative or absolute path with filename

Example


hrconf BACKUP 1 C:\WINDOWS\HR2200

hrconf create

Description

Creates logical drives. You must provide the channel and device ID of the physical devices. On redundant logical drives, hrconf performs autosynchronization.

Syntax

hrconf create controller# logicaldrive [[stripesize size] | [name] | [low | medium | high] | [build | clear | quick]] max RAID# channel# id# [channel# id#] [noprompt]

Options

The controller number

A logical drive will be created

Optional parameter to specifying a stripe size. The size can be 16, 32, or 64 KB.

Optional parameter to specify the name of a logical device to be created.

Initialization priority for logical drive to be created.

Initialization method for the logical drive.

The size of the logical drive

RAID level for the new logical drive. 0, 1, 10, and volume are supported.

The space-delimited channel number and device number pairs for each device to add to the logical drive.

Used mostly for the purpose of scripting setup, this parameter overrides all user confirmations.

Example


hrconf create 1 logicaldrive STRIPESIZE 64 MAX 0 1 0 1 1 1 2


hrconf delete

Description

Deletes a logical drive. All data stored on the logical drive will be lost. Spanned drives cannot be deleted with this function.

Syntax

hrconf delete controller# logicaldrive [logicaldrive# [logicaldrive#] | all] [noprompt]

Options

The controller number

The number of the logical drive(s) to be deleted or all to delete all logical drives

Used mostly for the purpose of scripting setup, this parameter overrides all user confirmations.

Examples


hrconf delete 1 logicaldrive 1 2 3
hrconf delete 1 logicaldrive all

hrconf driverupdate

Description

Updates Windows device drivers. When given a directory name, it will attempt to update a driver to the version found in the given directory.



Note - This command is available only on Windows systems.


Syntax

hrconf driverupdate dirname

Options

The directory path containing the driver that you want to update.

Example


hrconf driverupdate C:\windowsall

hrconf getconfig

Description

Lists information about the controllers, logical drives, and physical devices. This information can include (but is not limited to) the following items:

Syntax

hrconf getconfig controller# [ad | ld | pd | al]

Options

The controller number

Adapter information only

Logical drive information only

Physical device information only

All information

Example


hrconf getconfig 1 ad

hrconf getstatus

Description

The getstatus function displays the status of any background command that is currently running.

Syntax

hrconf getstatus controller#

Parameters

The controller number

Example


hrconf getstatus 1

hrconf getversion

Description

Returns the version information for all controllers or the optionally specified controller.

Syntax

hrconf getversion [controller#]

Options

The controller number. If a controller number is not specified, information is returned for all controllers.

Example


hrconf getversion 1

hrconf identify

Description

Blinks the LEDs on a device(s) connected to a controller.

Syntax

hrconf identify controller# logicaldrive logicaldrive# | all

hrconf identify controller# device device# channel# id#

Options

The controller number

The number of the logical drive to be identified or all to identify all logical drives

The device number for the drive

The channel and ID number for the device

Examples


hrconf identify 1 device 0 0
hrconf identify 1 all

hrconf rescan

Description

Enables the controller to check for the removal of any disk drives in the ready state, and to check for the connection of any new disk drives to the controller. The command returns when the rescan is complete.

Syntax

hrconf rescan controller#

Options

The controller number to scan

Example


hrconf rescan 1

hrconf restore

Description

Restores the controller configuration by importing its configuration settings from a specified file. Deletes the current configuration. The file must have been saved through the backup command from a controller of the same type, same number, and type of physical devices with same channels and device IDs. A reboot is required for the configuration change to take effect.

Syntax

hrconf restore controller# filename [noprompt]

Options

The controller number

The name of the file from which to read the configuration

Used mostly for the purpose of scripting setup, this parameter overrides all user confirmations.

Example


hrconf restore 1 C:\WINDOWS\HR2200 noprompt

hrconf romupdate

Description



Note - This command is only available on systems running Windows or Linux.


Updates the controller or enclosure firmware. The ROM image file must be in the same directory prior to invoking hrconf.

Syntax

hrconf romupdate controller# [controller] filename

Options

The controller number

Update the controller, not the firmware

The relative or absolute path with filename

Example


hrconf romupdate 1 controller AS4830.UFI

hrconf setboot

Description

Marks a logical device bootable.

Syntax

hrconf setboot controller# logicaldrive logicaldrive#

Options

The controller number

The number of the logical drive to mark bootable

Example


hrconf setboot 1 logicaldrive 1

hrconf setconfig

Description

Resets the controller's configuration. Logical drives are deleted, hard disks are reset to the READY state.

Syntax

hrconf setconfig controller# default [noprompt]

Options

The controller number

Restores the controller’s default configuration

Used mostly for the purpose of scripting setup, this parameter overrides all user confirmations.

Example


hrconf setconfig 1 default

hrconf setstate

Description

Redefines the state of a physical device from its current state to the designated state, or redefines a logical device state to force the logical drive online.

Syntax

hrconf setstate controller# logicaldrive logicaldrive# optimal [noprompt]

hrconf setstate controller# device channel# id# hsp | rdy | rbl [noprompt]

Options

The controller number

The logical drive whose state will be altered

force a logical drive online

The channel and ID number for the device

Create a hot spare from a ready drive

Remove a hot spare designation

Rebuild drive

Used mostly for the purpose of scripting setup, this parameter overrides all user confirmations.

Examples


hrconf setstate 1 0 1 hsp
hrconf setstate 1 0 2 rdy
hrconf setstate 1 0 2 rbl
hrconf setstate 1 logicaldrive 1 optimal

hrconf task

Description

Performs a task on a logical drive.

Syntax

hrconf task start controller# logicaldrive logicaldrive# verify_fix | verify | clear [noprompt]

Options

The controller number

The number of the logical drive on which the task is to be performed

Verifies the disk media and repairs the disk if bad data is found

Verifies the disk media

Removes all data from the drive

Used mostly for the purpose of scripting setup, this parameter overrides all user confirmations.

Examples


hrconf task start 1 logicaldrive 1 verify noprompt
hrconf task stop 1 logicaldrive 1