arraycfg(1M)

NAME

arraycfg — configures LUNs (logical drives) and physical disks.

SYNOPSIS

arraycfg -L LUN { -a capacity | -d | -r newLUN } [-V] [-?] array-id

arraycfg -D slot { -a | -d [-v] [-R|-Z] } [-V] [-?] array-id

Remarks

This command and the HP Advanced Disk Array management software are not supported on systems running HP-UX 11i Version 1.5, HP-UX 11i Version 1.6, and later versions.

DESCRIPTION

arraycfg is used to manage both the logical and physical configuration of the disk array identified by array-id. Logical configuration involves creating, deleting, and renumbering LUNS (logical drives) on the disk array. Physical configuration involves including or downing disks from the array configuration.

WARNING: Deleting a LUN will destroy all the data on the LUN. Backup all vital data before deleting a LUN.

The array-id used to address the disk array can be the disk array serial number, the character device file name of any LUN on the array (LUN 0 if no LUNs are created), or the alias text string assigned to the disk array.

Options

arraycfg supports the following options:

-a capacity

If -L is specified, create the indicated LUN. The capacity parameter indicates the size of the LUN. By default, the size is specified in Mbytes. The size can also be specified in Gbytes by appending a "G" to the value, or in Kbytes by appending a "K" to the value.

If -D is specified, include the indicated disk in the array configuration. When performing this operation, capacity is not included.

-d [ -v ] [ -R | -Z ]

If -L is specified, delete the indicated LUN. The remaining options are not used.

If -D is specified, bring down the indicated disk. When downing a disk, the following supplemental options are used

-v

Specifies whether the down operation is destructive or nondestructive. This determines whether or not the disk array will assume there is any valid data on the disk when it is returned to the array configuration. If the -v option is included, the down is nondestructive and the array assumes any data on the disk that was not updated in the disk's absence is valid. By default, the array performs a destructive down and assumes no valid data remains on the disk when it is returned to the array configuration.

-R

Allows the disk to be downed even if a loss of redundancy would result, but not data unavailability. When using this option, the disk array will continue to offer full data availability but the disk array is not protected against another disk failure. If -R is not included, the command to down a disk will fail if it would result in a loss of redundancy.

-Z

Allows the disk to be downed even if data unavailability would occur. If -Z is not included, the command to down a disk will fail if it would result in data unavailability.

WARNING: Specifying the -Z option could cause the disk array to become unavailable.

-D slot

Perform a physical configuration operation on the disk installed in the cabinet slot identified by slot. Slot numbers must be of the form An or Bn, where A or B correspond to a cabinet column, and n corresponds to a shelf position (1-6).

-L LUN

Perform a logical configuration operation on the LUN identified by LUN.

-r newLUN

Renumber the LUN specified by LUN to the value specified by newLUN. This option is only used with the -L option.

-V

Verbose mode displays additional command execution, state, and/or status messages.

-?

Display expanded usage message. This option overrides all others.

EXTERNAL INFLUENCES

Environment Variables

LC_MESSAGES determines the language in which messages are displayed. The current language settings can be checked with locale(1).

RETURN VALUE

arraycfg returns the following values:

0: Successful completion.
1: An error in execution (I/O, subsystem, security, etc.) occurred.
2: An error in command syntax occurred: for example, an unknown command-line option was passed.
3: Timeout in communication to server. May indicate ARMServer is not running.

DIAGNOSTICS

The following messages can be generated by arraycfg:

Usage: arraycfg -L LUN {-a capacity | -d | -r newLUN} 
[-V] [-?] <array-id> 

An error in command syntax has occurred. Re-enter the command with all necessary arguments.

Usage: arraycfg -D slot {-a | -d [-v] [-R | -Z]} 
[-V] [-?] <array-id> 

An error in command syntax has occurred. Re-enter the command with all necessary arguments.

arraycfg: Arg out of range

One of the arguments has exceeded its maximum or minimum size, or is incorrect in form. Check the size and form of each argument.

arraycfg: Unknown argument

An invalid argument was specified. Check command usage.

arraycfg: No such file or directory

The specified array-id does not exist or does not identify a disk array LUN that is communicating with the system. Verify the correct array-id with ioscan(1M) or arraydsp(1M).

arraycfg: Error in command execution, <Additional Error Info>: 
<Error Info Decode> 

The command failed due to a device error, an internal error, or a system error. The Additional Error Info and Error Info Decode fields will hold specifics about the failure and its cause.

arraycfg: The disk is already included.

An attempt was made to include a disk that is already included in the array configuration.

arraycfg: Previously downed disk has been downed.

A down command was issued to a disk that was already downed. The type of down (destructive or nondestructive) specified by the latest command will be implemented.

arraycfg: LUN nn does not exist in the array.

An attempt was made to perform an operation on a nonexistent LUN.

arraycfg: Not enough space to create LUN.

An attempt was made to create a LUN that was larger than the available unallocated capacity. Reduce the size of the LUN, or make more capacity available by adding a disk or deleting an existing LUN.

arraycfg: The specified LUN exists, cannot create.

An attempt was made to create a LUN that already exists. Use a different number to create the LUN.

arraycfg: The specified LUN does not exist or is invalid.

An attempt was made to perform an operation on a LUN that does not exist.

arraycfg: The specified LUN is invalid.

An attempt was made to perform an operation on an invalid LUN.

arraycfg: The specified newLUN already exists, cannot renumber.

An attempt was made to renumber a LUN using the number of an existing LUN. Select an unused number for the LUN being renumbered.

arraycfg: Disk was not downed, redundancy or data would be lost.

The specified operation cannot be performed because it would result in loss of data availability or data redundancy. The -R and -Z options can be used to override this error.

arraycfg: Disk was not downed, data would be lost.

The specified operation cannot be performed because it would result in loss of data. The -Z option can be used to override this error.

arraycfg: A diagnostic is currently running on this disk, cannot 
include disk until the diagnostic completes. 

An attempt was made to include a disk that is currently undergoing diagnostic testing. Wait until the diagnostic completes, or cancel the diagnostic using the dteststat utility.

arraycfg: The specified disk is not installed.

An attempt was made to perform an operation on a disk that is not installed in the array.

arraycfg: The array is in a state that cannot process this command.

The disk array is unable to execute the command. This typically occurs because the disk array is shutdown. Check disk array status.

arraycfg: Array was just powered-on or reset.

The command failed because the disk array has been powered-on or reset. Reissue the command and it should succeed.

EXAMPLES

Create LUN 6 with a size of 500 Mbytes on the disk array identified by device file /dev/rdsk/c2t0d0:

arraycfg -L 6 -a 500 /dev/rdsk/c2t0d0 

Renumber LUN 1 to LUN 2 on disk array serial number 00786b5c0000:

arraycfg -L 1 -r 2 00786b5c0000 

Delete LUN 3 on the disk array identified by device file /dev/rdsk/c2t0d0:

arraycfg -L 3 -d /dev/rdsk/c2t0d0 

Include the disk in slot B4 in the configuration of disk array serial number 00786b5c0000:

arraycfg -D B4 -a 00786b5c0000 

Down the disk in slot A3 on disk array serial number 00786b5c0000. Allow the command to execute even if redundancy will be lost:

arraycfg -D A3 -d -R 00786b5c0000 

DEPENDENCIES

ARMServer must be running to execute this command. See ARMServer(1M).

SECURITY CONFIGURATION

This command is modified for all security configurations.

Security Behavior/Restrictions

Use of this command is restricted to authorized users only.

Command Authorizations

This command requires the sysadmin authorization to successfully execute.

Privileges

The command has been modified to support least privilege. The potential privileges possessed by the command and their uses include:

allowdacread: This privilege is raised to provide discretionary read access to the devices.
allowdacwrite: This privilege is raised to provide discretionary write access to the devices.
allowmacread: This privilege is raised to provide mandatory read access to the devices.
allowmacwrite: This privilege is raised to provide mandatory write access to the devices.
filesysops: This privilege is raised to allow the mknod(2) system call to succeed.
writeaudit: The command generates its own audit records and submits these directly to the system audit trail. This privilege is raised whenever the command needs to write an audit record.

WARNINGS