amdsp(1M) amdsp(1M)
NAME [Toc] [Back]
amdsp - display the status and operating configuration of the disk
array
SYNOPSIS [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
-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 deviceindependent,
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 colondelimited
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.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
SECURITY CONFIGURATION [Toc] [Back]
This command is modified for all security configurations.
Security Behavior/Restrictions
Use of this command is restricted to authorized users only.
Command Authorizations [Toc] [Back]
This command requires the sysadmin authorization to successfully
execute.
Privileges [Toc] [Back]
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 [Toc] [Back]
Environment Variables
LC_MESSAGES determines the language in which messages are displayed.
The current language settings can be checked with locale(1).
RETURN VALUE [Toc] [Back]
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.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
DIAGNOSTICS [Toc] [Back]
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 [Toc] [Back]
Display general information about disk array RACK_51:
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
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 [Toc] [Back]
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:
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
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
OR
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.
Hewlett-Packard Company - 6 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
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
OR
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.
Hewlett-Packard Company - 7 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
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".
Hewlett-Packard Company - 8 - HP-UX 11i Version 2: August 2003
amdsp(1M) amdsp(1M)
-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 [Toc] [Back]
AM60Srvr must be running to execute this command. See AM60Srvr(1M).
AUTHOR [Toc] [Back]
amdsp was developed by HP.
SEE ALSO [Toc] [Back]
ammgr(1M), amcfg(1M), amutil(1M), amlog(1M), AM60Srvr(1M).
Hewlett-Packard Company - 9 - HP-UX 11i Version 2: August 2003 [ Back ] |
