amdsp(1M)

NAME

amdsp — display the status and operating configuration of the disk array

SYNOPSIS

amdsp [ -l [LUN] | -g | -d | -c | -s | -h | -a | -A | -r ] [-V] [-S] [-?] ArrayID

amdsp -p [-V] [-S] [-?] DeviceFile

amdsp -i [-V] [-S] [-?]

amdsp -R [-V] [-?]

DESCRIPTION

amdsp displays status and configuration information for the disk array identified by ArrayID. Logical configuration, physical configuration, and current status can all be displayed using amdsp. A list of all the disk arrays recognized by the host can also be displayed.

The ArrayID used to address the disk array can be the disk array serial number or name, if one has been assigned to the disk array.

Identifying Disk Modules

Disk modules are identified within Array Manager 60 using a numbered pair of the form n:n. The first number identifies the SCSI channel (or bus) connecting the array controller to the enclosure containing the disk module. The channel number is indicated on the back of the array controller enclosure. The second number is the disk module SCSI ID. The SCSI ID is determined by the slot in which the disk module is installed, but is not the same as the physical slot number (0-9).

For example, the numbered pair 2:1 identifies the disk module on channel 2 with a SCSI ID of 1. Refer to the Disk Array FC/60 User's Guide for more information on disk module addressing.

Options

amdsp supports the following options:

none: Display general information about the disk array. This includes product and vendor information, array state, and capacity usage.
-a: Display all information presented by the -c, -d, -g, -h, -s, -l, and -r options. This is a quick way of displaying all configuration and status information about the disk array. This option will display information for all LUNs.
-A: Display information related to the interface between the server and the specified disk array.
-c: Display information for both disk array controllers and the BCC disk system controllers.
-d: Display information for all disks installed in the array. Each disk is identified by a numbered pair of the form channel:ID. The enclosure and slot in which the disk is installed are also displayed.
-g: Display disk group information. Information will be displayed for each disk group on the disk array. There is a disk group for each LUN.
-h: Display information about the disk array hardware. This includes the hardware components in the disk array subsystem and each disk system.
-i: Display the ID of all disk arrays currently connected to and recognized by the server. If the disk array has been assigned a name, it will also be displayed. Because this option is device-independent, it does not use ArrayID.
-l [LUN]: Display information for the LUN identified by LUN. If LUN is not specified, display information for all LUNs on the disk array.
-p DeviceFile: Display hardware path information for the controller corresponding to the specified device file.
-r: Display the progress of all rebuilds currently in progress on the disk array.
-R: Rescan for disk arrays. The host will scan for all supported disk arrays and update the current list. This may be useful if a new disk array has been added but does not yet show up in the disk array list returned by the -i option.
-s: Display disk array state information. This includes cache settings for the disk array.
-S: Raw output display. Data is output as a colon-delimited ASCII text string. Raw output format is near the end of this page.
-V: Verbose mode displays additional command execution, state, and/or status messages.
-?: Display extended usage message. This option overrides all others.

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.

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

amdsp 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 AM60Srvr is not running.

DIAGNOSTICS

The following messages can be generated by amdsp:

Usage: amdsp [-l [LUN] | -d | -g | -c |

-s | -h | -r | -a | -A]
[-V] [-S] <ArrayID>

amdsp {-i | -R} [-V] [-S]

amdsp -p [-V] [-S] <DeviceFile>

Extended help: amdsp -?

An error in command syntax has occurred. Reenter the command with all necessary arguments.

amdsp: 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.
amdsp: The <ArrayID> entered does not identify a known, supported array
The specified ArrayID does not exist or does not identify a device that is communicating with the system. Verify the array exists and is operational.

amdsp: The specified controller is not physically installed.

A controller-specific command was issued to a non-existent or inaccessible controller.

amdsp: The specified LUN does not exist in this array.

The specified LUN does not exist.

amdsp: No array controllers installed

The software was unable to identify an installed controller in the array. This may be due to controller failure, or cabling problems. Correct the problem and re-issue the command.
amdsp: No controller hardware path was found for the given device file
A controller-specific command was issued to a non-existent or inaccessible controller.

amdsp: 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.

EXAMPLES

Display general information about disk array RACK_51:

amdsp RACK_51 

Display information for LUN 2 on disk array named RACK_51:

amdsp -l 2 RACK_51 

Display information for all LUNs on disk array RACK_51:

amdsp -l RACK_51 

Display information for all disks installed in disk array named RACK_51:

amdsp -d RACK_51 

List the serial numbers of all of the disk arrays recognized by the host:

amdsp -i 

RAW OUTPUT FORMAT

The contents of the raw output text string for each display option are listed here. Note that the raw output for the -a option comprises the individual strings displayed by the -l,-d,-c, -s,-g,-A, -r, and -h options. For clarification when evaluating Boolean expressions, TRUE=1 and FALSE=0.

OPTION

RAW OUTPUT DESCRIPTION

none

D:VendorID:ProductID:ArrayID:ServerName:ArrayType:

MfgProdCode:PhysCapacity:LUNCapacity:

HotSpareCapacity:UnallocatedCapacity:ArrayState:

ArrayAlias

The leading D is literal to identify this as a DEFAULT record.

All capacities are in GB where 1GB=1024^3 bytes , except LUN capacity, which is always in MB in raw output mode, where 1MB=1024^2 bytes .

-c

The following is output for each disk array controller:

C:Subsystem:CntrlrID:CompState:CntrlrMode:Quiesced:VendorID:

ModelNum:SerNumber:FWRevision:BootRevision:HPRev:LoopID:ALPA:

PreferredALPA:CntrlrDate:CntrlrTime:CacheBattAge:ArrayID:

NVRAMChecksum

The following is output for each disk enclosure controller:

C:Subsystem:CntrlrID:CompState:CntrlrMode:Quiesced:VendorID:

ModelNum:SerNumber:FWRevision:EncSerNum:EncID:SubsysChannel:

SubsysScsiID:ThumbwheelSetting:CntrlrDate:CntrlrTime:

CacheBattAge:ArrayID

The leading C is literal to identify this as a CONTROLLER record.

The above will be displayed for each controller installed. The first type of record shown above will be displayed for each Subsystem whose value is 0. The second record type will be displayed when the Subsystem is greater than 0.

Quiesced is a boolean field indicating whether the controller is quiescent.

CntrlrMode, Quiesced, CntrlrDate, CntrlrTime, and CacheBattAge are only defined when the Subsystem is 0 (array controller enclosure). Otherwise they are undefined.

EncSerNum is the serial number of the disk subsystem enclosure.

CntrlrTime is a colon delimited field having a format of HH:MM:SS.

If CompState is not GOOD (1), or CntrlrMode is FAILED (4), information in the remaining fields may be undefined or absent.

ALPA and PreferredALPA are displayed in hexadecimal.

CacheBattAge is the time in days (rounded to the nearest 90 days) since the cache battery age was last reset.

-d

The following output is provided for each installed disk:

PD:Channel:ID:EnclosureID:SlotID:DiskState:DiskGroupID:DGType:

Capacity:Manufacturer:Model:FWRevision:SerialNum:ArrayID

PD:Channel:ID:EnclosureID:SlotID:DiskState:DiskGroupID:DGType:

Capacity:Manufacturer:Model:FWRevision:SerialNum:ArrayID: SparedChannel:SparedID

The leading PD is literal to identify this as a PHYSICAL DISK record.

The above will be displayed for each disk slot. For disks which have been bound to a LUN and then removed, or assigned as a hot spare and then removed, the Manufacturer, Model, FWRevision and SerialNum fields may be undefined.

Unassigned disks which are removed will have no PD record.

Capacity is displayed in GB, rounded up to the nearest GB.

If DGType is 1 (HOT SPARE), and if this disk is currently sparing another disk, then two extra fields will be printed, designating the channel and SCSI ID of the spared disk.

-g

One or more LUN records will be displayed in the following format:

G:VendorID:ProductID:DiskGroupID:DGType: NumLUns:LUN...:RemCapacity:RAIDLevel:SegmentSize:nDisks: Channel-ID,Channel-ID...:ArrayID

The leading G is literal to identify this as a Disk Group record.

The above fields will be displayed for each disk group.

The following fields are undefined when DGType is 1 or 2: NumLUNs, LUN, RemCapacity, RAIDLevel, and SegmentSize.

Note that capacity will always be expressed in MB for raw output.

-h

One or more "component state records" will be displayed in the following format:

H:VendorID:ProductID:SubSystem:CntrlrAStatus:CntrlrBStatus:

PS1Status:PS2Status:Fan1Status:Fan2Status:TsensorStatus: BattStatus:EncSerNum:ArrayID

H:VendorID:ProductID:SubSystem:CntrlrAStatus:CntrlrBStatus:

PwrSupplyAStatus:PwrSupplyBStatus:FanAStatus:FanBStatus:

TsensorStatus:BattStatus:EncSerNum:ArrayID

The leading H is literal to identify this as a Hardware Status record.

When the SubSystem is greater than 0 (disk enclosure), the BattStatus is undefined.

When the SubSystem is greater than 0 (disk enclosure), the power supplies and fans are designated as A and B, rather than 1 and 2. The left to right orientation of the disk enclosure power supplies may not match that of the array controller power supplies.

EncSerNum is the disk enclosure serial number, and is only defined when the SubSystem is greater than 0; otherwise, it is undefined.

-i

The following output includes a separate field (ArrayID:Alias) for each disk array identified:

I:ArrayID:Alias:ArrayID:Alias:...

The leading I is literal to identify this as an Identify record.

-l

L:VendorID:ProductID:LunNumber:Present:LunState:

CacheState:Capacity:Owner:RaidLevel:SegmentSize:

DiskGroup:nDisks:Channel-ID,Channel-ID,...:ArrayID:

CME:CWOB:RCD:WCA:RCA:IsUtm:UtmLunState

The leading L is literal to identify this as a LUN record.

Present is a Boolean, TRUE if the LUN is configured, FALSE otherwise.

If no option is specified, the above will be displayed for all LUNs, both present and not present.

CacheState is a two-bit field in which the high order bit is the boolean CacheMirroringActive (CMA) state of the LUN's owning controller, and the low order bit is the boolean WriteCacheEnabled (WCE) state for the controller.

CME (Cache Mirroring Enabled), CWOB (Cache Without Batteries), RCD (Read Cache Disabled), WCA (Write Cache Active), and RCA (Read Cache Active) indicate the state of the caching parameters.

Capacities displayed in the raw output are always shown in MB, where 1MB=1024^2 bytes.

IsUtm is a boolean that indicates whether the current LUN is the Universal Transport Mechanism (UTM). When IsUtm is TRUE (1), only the following additional fields are valid: VendorID, ProductID, LunNumber, Present, and UtmLunState. The remaining fields are undefined.

When IsUtm is TRUE (1), UtmLunState indicates the status of the UTM LUN, as defined in the UTM Specification. Otherwise this field is undefined.

If nDisks is "0", the drive list (Chan-ID,Chan-ID,...) will also be "0".

-p

P:CntrlrID:SerNumber:ArrayID

P:AltCntrlrID:AltSerNumber:ArrayID

The leading P is literal to identify this as a HARDWARE PATH record.

The first hardware path record is for the controller that corresponds to the given device file. The second record is for the alternate controller. If the alternate controller is not present, its serial number will be 0.

-r

R:VendorID:ProductID:CntrlrID:LUN:RebuildProgress:Freq:

Amt:ArrayID

The leading R is literal, and identifies this as a LUN rebuild record.

One rebuild record is returned for each LUN that is currently rebuilding. If no LUN is rebuilding, no record will be returned.

RebuildProgress above is percent complete

Freq is the rebuild frequency in tenths of a second

Amt is the rebuild amount in blocks per rebuild command

-s

S:VendorID:ProductID:ValidData-A:ValidData-B:

CacheBlkSize-A:CacheBlkSize-B:CacheFlushThresh-A:

acheFlushThresh-B:CacheFlushLim-A:CacheFlushLim-B:

CacheSize-A:CacheSize-B:ArrayState:ArrayID

The leading S is literal to identify this as an ARRAY STATE record.

DEPENDENCIES

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

AUTHOR

amdsp was developed by HP.