ida_menu(1M) ida_menu(1M)
NAME
ida_menu - Compaq Intelligent Disk Array Diagnostic Utility
SYNOPSIS
/usr/bin/compaq/diags/ida/ida_menu
DESCRIPTION
The menu-driven program ida_menu allows you to identify IDA
hardware characteristics, configure IDA features, and monitor
performance. Only a user with the appropriate privileges can
execute this command.
USAGE
This section tells how to run the IDA Diagnostic Utility.
1. Log in as root and execute the following commands:
cd /usr/bin/compaq/diags/ida
./ida_menu
2. The following menu is displayed:
*************************************************************
COMPAQ Intelligent Disk Array Diagnostic Utility Menu
Version 1.3 Copyright (C) COMPAQ Computer Corporation 1992, 1993, 1994
*************************************************************
Device List:
/dev/****
/dev/****
Enter device name (*=all devices, q=quit):
3. Enter the device name. The following menu appears:
******************************************
COMPAQ IDA Diagnostic Menu
******************************************
>>> Current Device: /dev/**** <<<
1 - Identify Controller
2 - Identify Logical Drive Status
3 - Sense Configuration
4 - Sense Drive Monitor & Performance Threshold Violation Status
5 - Return Drive Monitor & Performance Statistics
6 - Return Drive Monitor & Performance Thresholds
7 - Return Monitor & Performance Parameter Control Data
Copyright 1994 Novell, Inc. Page 1
ida_menu(1M) ida_menu(1M)
8 - Return Posted Write Status
9 - Flush/Disable/Enable Posted Write Memory
10 - Set Periodic Statistics Sampling Interval
11 - Disable/Enable Alarm Beep
12 - Accept Media Exchange (SMART Disk Array Controller only)
13 - Read Error Log (SMART Disk Array Controller only)
14 - Specify a New Device
q - Quit
If * is specified for the device selection, the
information for all IDA controllers in the system is
displayed on the screen and the menu is not seen; return
to step 2. In addition, all information is logged in
the file /usr/bin/compaq/diags/ida/ida_file.
Menu Options
The following provides information on each of the menu
options:
Identify Controller
Use this option to identify the configuration of the IDA
controllers. It displays the following information:
Controller Type
the type of the controller.
Slot Number
the slot number the controller is in.
Signature
the configuration signature is supplied by the
Compaq EISA Configuration Utility (calculated
based on the system and date), and is written to
the reserve sector(s) on each physical drive and
to EISA nonvolatile memory. The configuration
signature is used by the IDA controller firmware
to reliably identify that a physical drive is a
member of a configured array.
Firmware Revision
the firmware revision of the controller.
Drive Assignment Map
bit map showing which physical drives are assigned
to this controller.
Copyright 1994 Novell, Inc. Page 2
ida_menu(1M) ida_menu(1M)
Drive Assignment ID(s)
the ID(s) of physical drives that are assigned to
the controller.
Drive Spare Map
bit map showing which physical drives are assigned
as spares.
Drive Spare ID(s)
the ID(s) of physical drives that are assigned as
spares.
Number of Logical Drives
the number of logical drives that are assigned to
the controller.
Number of Physical Drives
the number of physical drives that are assigned to
the controller.
Boardid (3rd byte)
the third byte of the board ID for this
controller.
The following information is displayed for SMART Controllers
only.
ProLiant Version
the version of the ProLiant Storage System
ProLiant FW Rev
the firmware revision of the ProLiant Storage
System
ProLiant Vendor ID
the vendor ID of the ProLiant Storage System
ProLiant Product ID
the product ID of the ProLiant Storage System
Fan Status
the fan status of the ProLiant Storage System
Temperature Status
the temperature status of the ProLiant Storage
System
Copyright 1994 Novell, Inc. Page 3
ida_menu(1M) ida_menu(1M)
Side Panel Status
the side panel status of the ProLiant Storage
System
Identify Logical Drive Status
Use this option to display the status of a logical drive. It
first determines the number of logical drives configured, and
if there are more than one configured, the following message
is displayed:
Identify Logical Drive Status: /dev/***
Enter logical drive number:
After you enter the number of the logical drive you are
examining, the following information is displayed:
Logical Drive Status: message
where message is one of the following:
OK Logical drive operable
Failed
Logical drive failure. The failed drive ID(s) are
returned to identify which physical drive failed.
Not configured
Logical drive needs to be configured Using Interim
Recovery Mode - Logical drive is operating in regenerate
mode
Ready for Recovery Mode
Logical drive is ready to start recovery
Currently Recovering
Logical drive will resume recovery after a power off
Wrong Logical Drive was Replaced
Logical drive has wrong physical drive replaced
A Physical Drive is Not Properly Connected
Logical drive has a loose cable
Copyright 1994 Novell, Inc. Page 4
ida_menu(1M) ida_menu(1M)
Hardware is Overheating
Fault Tolerance Type
The type of fault tolerance
Logical Drive Size
The size of the logical drive
Physical Drive ID(s)
The ID(s) of physical drives that are assigned to this
logical volume
Physical Drive Size
The size of physical drives that are assigned to this
logical drive. (For SMART and IDA expansion controller
only)
Spare Drive Status: message
This information is displayed only if a SMART Controller
or IDA Expansion with Spare Drive is configured. The
message is one of the following:
Inactive
At least one of the physical drives designated as an
on-line spare drive has not been activated and is
currently available for activation
Active
At least one of the designated physical drives is
currently activated as an on-line spare for this logical
drive
Building
An activated on-line spare drive is rebuilding
Failed
At least one activated on-line spare drive has failed
Recovering Drive ID
The drive ID of recovering drive
Blocks Left to Recover
The number of sectors left to rebuild in a current drive
rebuild operation
Copyright 1994 Novell, Inc. Page 5
ida_menu(1M) ida_menu(1M)
Replacement Drive ID
The ID of the replacement drive
Active Spare Drive ID
The ID of the active spare drive
Sense Configuration
This option is used to return the configuration of logical
drives configured on the controller. When selecting this
option, a check is made to determine if more than one logical
drive is configured. If the IDA controller has more than one
logical drive, the following is displayed:
Sense Configuration: /dev/***
Enter logical drive number:
Enter the logical drive number.
The following information is displayed:
Signature
The configuration signature is supplied by the
Compaq EISA Configuration Utility (calculated
based on the system and date), and is written to
the reserve sector(s) on each physical drive and
to EISA nonvolatile memory. The configuration
signature is used by the IDA controller firmware
to reliably identify that a physical drive is a
member of a configured array.
Physical Drive Count
The total number of physical drives for this
controller.
Number of Physical Drives in Logical Volume
The number of physical drives assigned to this
logical drive by the configuration utility.
Fault Tolerance Type
The type of fault tolerance assigned to this
logical drive.
Drive Assignment Map
A bit map showing which physical drives are
assigned to this logical volume.
Copyright 1994 Novell, Inc. Page 6
ida_menu(1M) ida_menu(1M)
Drive Assignment ID(s)
The ID(s) of physical drives that are assigned to
this logical volume.
Cylinders
The number of cylinders in this logical volume.
Heads The number of heads in this logical volume.
Sectors Per Track
The number of sectors per track in this logical
drive.
Sense Drive Monitor & Performance Threshold Violation Status
This option is used to return the drive threshold status
information for each drive attached to the controller.
Sense Drive THreshold Violation Status: /dev/***
If the drive threshold(s) has(have) been exceeded, the
following messages will be displayed:
Drive threshold(s) has(have) been exceeded for device:
/dev/***, slot number: *
drive: *
The controller has detected drive(s) that exceeded one or more
factory preset thresholds for performance degradation. Many
Compaq high-performance drive array hard drives are
``stamped'' by the drive manufacturer with minimum performance
characteristics. As a result of normal wear and tear, the
performance of a hard drive may gradually deteriorate. If
certain thresholds are exceeded, the drive may not perform to
specified levels, and may be subject to hardware failure
sometime in the future. Drives that exceed these thresholds
are considered ``failed,'' although true catastrophic failure
has not yet occurred.
If the drive threshold(s) has(have) not been exceeded, the
following messages will be displayed:
Drive threshold(s) has(have) not been exceeded for device:
/dev/***, slot number: *
Copyright 1994 Novell, Inc. Page 7
ida_menu(1M) ida_menu(1M)
Return Drive Monitor & Performance Statistics
This option is used to get statistical information for all
drives attached to an IDA controller. When selecting this
option, the following is displayed:
Return Physical Drive Monitor & Performance Statistics:
/dev/***
Enter 0: Since Manufacture or 1: Since Power On:
Enter <0> or <1>.
Some of the following information for all physical drives on
this controller is displayed depending on the controller type.
Serial Number
The drive serial number.
Firmware Revision
The drive firmware revision.
Product Revision
The drive manufacturer/model number.
Service Time
This value specifies the drive operating time
interval over which the following values have been
accumulated (in minutes).
Sector Read
The number of sectors read from the media.
Rd Err-Hard
The number of unrecoverable read errors.
Rd Err-Recovrd
The number of retry-recovered read errors.
Sector Written
The number of sectors written to the media.
Wrt Err-Hard
The number of unrecoverable write errors.
Copyright 1994 Novell, Inc. Page 8
ida_menu(1M) ida_menu(1M)
Wrt Err-Recovrd
The number of retry-recovered write errors.
Seek Errors
The number of seek errors.
Performance Test 2
The average track-to-track seek time, 100us
increment.
Performance Test 3
The average 1/3-stroke seek time, 100us increment.
Performance Test 4
The average full-stroke seek time, 100us
increment.
Realloc Used
The number of reallocated sectors.
DRQ Timeout
The number of DRQ timeouts.
Other Timeout
Timeouts other than DRQ timeouts.
Recovry Failed-Rd
The number of times a recover of another physical
drive in the logical drive failed due to a hard
read error from this drive.
Recovry Failed-Wt
The number of times a recover of another physical
drive in the logical drive failed due to a hard
write error from this drive.
Format Errors
The number of times a format command (used when
remapping defects) failed. A failed remap
operation may cause the controller to fail a
drive.
Self Test Failures
The number of times the drive failed due to a
failure of the drive "self test" command.
Copyright 1994 Novell, Inc. Page 9
ida_menu(1M) ida_menu(1M)
Not Ready Failures
The number of times the drive failed because it
never became ready after the ``spin-up'' command
was issued.
Remap Abort Failures
The number of times the drive was failed due to
excessive read errors when trying to determine the
precise media location of a defect.
IRQ Deglitch Count
The number of times that a glitch was detected on
the IRQ line from the drive. A software de-glitch
filter is implemented in the IDA-2 controller to
detect and filter out these spurious drive
interrupts.
Return Drive Monitor & Performance Thresholds
This option is used to obtain threshold information on the
drive parameter returned by the Monitor & Performance
Statistics command (option 4). When selecting this option,
the following is displayed:
Return Drive Monitor & Performance: /dev/***
The Monitor & Performance Threshold information for all
physical drives on this controller is displayed.
Return Monitor & Performance Parameter Control Data
This option is used to get the data that describe each of the
elements in the Monitor & Performance data structure (option 4
of the IDA Diagnostic Menu), and is also used to pass
information between the Diagnostics program and the IDA
Monitoring Agent. When selecting this option, the following
is displayed:
Return Monitor & Performance Parameter Control Data: /dev/***
The Monitor & Performance Parameter Control Data for all
physical drives on this controller are displayed. Each word
of the data corresponds to an element in the Physical-Drive
Monitor & Performance Structure. The meanings of some of
these bits are as follows:
Copyright 1994 Novell, Inc. Page 10
ida_menu(1M) ida_menu(1M)
Bit 7 -- Threshold Exists:
Indicates whether a threshold corresponding to this
attribute exists in the threshold data structure.
0 = threshold doesn't exist
1 = threshold exists.
Bit 11 -- Attribute Not Supported:
Indicates whether the controller supports this attribute
for the attached drive.
0 = attribute supported
1 = attribute not supported.
Bit 12 -- Threshold Exceeded:
Indicates whether the value of the corresponding
attribute has exceeded the corresponding threshold since
this bit was last reset.
0 = threshold not exceeded
1 = threshold was exceeded.
Bit 13 -- Threshold Comparison Enabled:
Enables/Disables the threshold comparison for the
corresponding attribute.
0 = disable comparison and alert
1 = enable threshold comparison.
Bit 15 -- Include in MIB:
Diagnostics sets this bit to 1 if the corresponding
attribute should be included in the Server Manager MIB
and displayed by the Server Manager.
0 = not included in MIB
1 = included in MIB
Return Posted Write Status
This option is used to inquire about the status of the posted
write parameter for the IDA controller with the write cache
feature. When selecting this option, a check is made to
determine if the write cache feature is supported for this
controller. If the write cache feature is not supported for
this controller, the following message is displayed:
Copyright 1994 Novell, Inc. Page 11
ida_menu(1M) ida_menu(1M)
the "return cache status cmd" is not supported for device
/dev/***
Press <Enter> to continue
If the ``write cache'' feature is supported, the following
information is displayed:
Status - the current status of IDA posted write operations.
Possible status messages are:
Enabled
Posted write operations are currently configured and
enabled.
Temporarily Disabled
The posted write operations have been temporarily
disabled. See the Disable Code field to determine the
reason.
Permanently Disabled
The posted write operations have been permanently
disabled. See the Disable Code field to determine the
reason.
Posted Writes Drive Bit Map
Each bit in this map corresponds to a respective logical
drive number. When a bit is set to 0, posted write
operations are enabled for that logical drive. A value
of 1 indicates that posted write operations are disabled
for that logical drive. Logical drives that are not
configured have a value of zero.
Posted Writes Logical Drive ID(s)
The logical drive ID(s) that have posted write
operations enabled.
Kbytes for Read Cache
Kbytes of available Array Accelerator memory that has
been reserved for the read cache. Since read caching is
not supported, expect a value of zero here.
Kbytes for Posted Write Memory
Kbytes of available Array Accelerator memory that has
been reserved for posted write operations. Since data
Copyright 1994 Novell, Inc. Page 12
ida_menu(1M) ida_menu(1M)
for posted write operations is saved in duplicate
(mirrored), the maximum amount of posted write data that
can be stored here is actually no greater than half of
the value of this field.
Disable Flag
A value of 1 indicates that configuration data does not
exist for the daughter board. A value of 0 indicates
the presence of configuration data.
Failed Battery Map
This is a bit map indicating which batteries have not
fully recharged within the maximum recharge time. The
current recharge time is 36 hours.
Failed Battery ID(s)
This is an ID indicating which batteries have not fully
recharged within the maximum recharge time. The current
recharge time is 36 hours.
Number of Array Accelerator Attached
0: the posted write Array Accelerator is not attached.
1: the posted write Array Accelerator is attached.
Disable Code
The value of this field should be referenced to
determine the reason that posted write operations were
either temporarily or permanently disabled. The value
of this field is only meaningful if posted write
operations are either temporarily or permanently
disabled. Possible Disable Code messages are:
Bad Configuration
The Array Accelerator seems to have been configured for
a different IDA controller. The configuration signature
in the posted write memory does not match the one stored
in the configuration data stored on the drives.
Low Battery Power
Posted write operations have been disabled because less
than 75% of the battery packs (currently 4 total battery
packs) are at the sufficient voltage level.
Copyright 1994 Novell, Inc. Page 13
ida_menu(1M) ida_menu(1M)
Disable Command Issued
Posted write operations were disabled by the bus master
interface controller (BMIC) Flush/Disable command.
No Resources Available
The controller does not currently have sufficient
resources to perform posted write operations.
Board Not Connected
Array Accelerator is not attached to the controller.
Bad Mirror Data
Data was found at reset initialization in the posted
write memory, however, the mirror data compare test
failed resulting in the data being marked as invalid.
Data loss could possibly occur.
Read Failure
Soft errors occurred when trying to read the same data
from both sides of the mirrored posted write memory.
Data was lost.
Write Failure
Data could not be written to the posted write memory in
duplicate because of parity errors. Data was not lost.
Config. Command Issued
A BMIC set configuration command was issued. Posted
write operations remain disabled until a BMIC set posted
write command is issued once again.
Total Memory Size
The total amount (in Kbytes) available on the Array
Accelerator to be used for both read cache operations
(not currently supported) and posted write operations.
This figure includes mirrored RAM for posted write
operations.
Battery Count
Total number of battery packs on the Array Accelerator.
Good Battery Map
Diagram depicting good batteries.
Copyright 1994 Novell, Inc. Page 14
ida_menu(1M) ida_menu(1M)
Good Battery ID(s)
The ID(s) of good batteries.
Parity Read Errors & Parity Write Errors
The respective total number of times that read and write
memory parity errors were detected on transfer between
the transfer buffer and the Array Accelerator memory.
Flush/Disable/Enable Posted Write Memory
This option is used to flush, disable, or enable the posted
write memory on the IDA controller with the write cache
feature. When selecting this option, a check is made to
determine if the write cache feature is supported on this
controller. If the write cache feature is not supported on
this controller, the following message is displayed:
The "flush cache cmd" is not supported for device: /dev/***
Press <Enter> to continue
If the write cache feature is supported, the following is
displayed:
Do you want to disable posted write operation
temporarily? (y/n)
If you enter n, the posted write operation remains "enabled"
after flushing the posted write memory to the disk. If you
enter y, the posted write operation becomes "temporarily
disabled" after the flush. To re-enable the posted write
operation, re-execute this program and answer n for the above
question. Then answer y for the following question. The
following is displayed:
About to flush the posted write memory with posted write
operation enabled (or disabled).
Do you want to flush? (y/n)
If you enter y, the following is displayed:
Flush posted write memory command completed.
Press <Enter> to continue . . .
Copyright 1994 Novell, Inc. Page 15
ida_menu(1M) ida_menu(1M)
If you enter n, the following is displayed:
Flush posted write buffer command aborted.
Press <Enter> to continue . . .
Set Periodic Statistics Sampling Interval
This option is used to set the time interval between sampling
drive statistics data. When selecting this option, the
following is displayed:
Set Periodic Statistics Sampling Interval: /dev/***
Enter Sample Time (minutes):
Enter the time in minutes. The following is displayed:
Sampling interval will be set to xxx minutes, please wait.
Press <Enter> to continue . . .
Disable/Enable Alarm Beep
This option is used to disable or enable the alarm beep. The
following is displayed:
Disabling/Enabling Alarm Beep: /dev/***
Enter 1 (Disable) or 0 (Enable):
Enter <1> to disable
or
Enter <0> to enable.
The following is displayed:
Disable (or Enable) alarm beeping, please wait.
Press ENTER to continue . . .
Accept Media Exchange
This option is for the Compaq SMART SCSI Array Controller
only. In a No Fault Tolerance (RAID 0) configuration, the
Accept Media Exchange command causes the SMART Controller to
set the state of the logical drive to OK after a logical drive
has failed and the failed physical drives have been replaced
through hot-plug exchanges.
Copyright 1994 Novell, Inc. Page 16
ida_menu(1M) ida_menu(1M)
After you have replaced the drives through a hot-plug exchange
a "Failed" Status will be returned before you select option 2
of the IDA Diagnostic Menu. After this command is issued, the
"Failed" status is cleared. If you select the Accept Media
Exchange command when the logical drive is not in a failed
state or has not been exchanged, the command terminates with a
fatal error.
When you use this command, the system checks to determine if
the media exchange feature is supported on the drive
controller. If the media exchange feature is not supported,
the system displays the following message:
The "Accept media exchange cmd" is not supported for device: /dev/***
Press <Enter> to continue
When this command is issued, the system also checks to
determine if more than one logical drive is configured. If
the IDA controller has more than 1 logical drive, the system
displays the following message:
Accept Media Exchange: /dev/***
Enter logical drive number:
If you don't know which logical drive has failed, use option 2
of the IDA Diagnostics Menus (Identify Logical Drive Status)
to find the logical drive that has a "Failed" status. Next,
the system displays the following message:
Accept Media Exchange cmd completed.
Press <Enter> to continue
If the logical drive you specified does not have a "Failed"
status, the system displays the following message:
ioctl: Can't accept media exchange for device: /dev/***
Read Error Log
This option is used to return logs of previous errors for all
drives in the controller. This function is only supported on
SMART Controllers. The following information is displayed.
For complete descriptions of this information, refer to the
SCSI-2 Logical Specification or other SCSI reference.
Copyright 1994 Novell, Inc. Page 17
ida_menu(1M) ida_menu(1M)
Error Type
0 = no error, 1 = SCSI error, 2 = CAM error
CAM Status
The current CAM Status
SCSI Status
The current SCSI status
Sense key
The sense key value from the SCSI Request Sense command
Qualifier
The sense code qualifier from the SCSI Request Sense
command
Sense Code
The sense code from the SCSI Request Sense command
Block Number
The block number where error occurred
Reference Time
Time stamp of the error
SCSI Operation
SCSI operation code
Additional Information
Additional Information
Block is Valid
True if the block number field is valid
Specify a New Device
This option is used to specify a new device. The main menu
reappears when this option is selected.
NOTICES
This command is only supported on applicable Compaq systems.
Copyright 1994 Novell, Inc. Page 18