enatest is used to provide configuration verification, fault isolation, and repair validation of the Sun StorEdgeTM A5x00 subsystem. The enatest tests Sun StorEdge models A5000 (14 slot disk array) and A5200 (22 slot disk array).
The Sun StorEdge A5x00 is a high availability mass storage subsystem consisting of:
SCSI Fibre Channel protocol host adapters with dual 100-Megabyte FC-AL ports.
A disk enclosure.
A front panel display for configuration information.
Up to two interface boards in the enclosure, which provide FC-AL connections to the enclosure and also provide status information and control of the conditions within the enclosure.
Other field-replaceable units (FRUs) within the enclosure include power supply units, fan trays, and backplane.
Do not run enatest and socaltest at the same time, otherwise test failures might occur.
The Sun StorEdge A5x00 was formally known as the Sun Enterprise Network ArrayTM. The enatest tests both of these disk array subsystems.
enatest detects all Sun StorEdge A5x00 enclosures connected to the host and collects relevant configuration information. Figure 17-1 shows the Test Parameter Options menu which contains a sample configuration listing and test parameters. Table 17-1 describes the extent of the test coverage and provides samples of the configuration information that is displayed.
Table 17-1 enatest Coverage
Test Coverage |
Description |
---|---|
Host Connections |
enatest searches for all the active and inactive connections between the host and the enclosure and reports the number of existing active connections. If the VERBOSE mode is enabled, the port on the host side and the GBIC port on the enclosure side is reported for each active connection. The test also diagnoses any inactive connection(s) and reports the possible causes for the failure. The test will fail if there are one or more inactive connections. See the section on "enatest Fault Isolation Capability" for more information. |
Sample Output, for an enclosure attached to an SBus socal card:
SUNWvts.enatest.1010 06/05/97 13:48:53 enatest ses0 VERBOSE: "MYBOX: Lower-Right GBIC connected to host via /devices/sbus@1f,0/SUNW,socal@0,0:1" SUNWvts.enatest.1006 06/05/97 13:48:53 enatest ses0 VERBOSE: "MYBOX: Interface Board (Bottom one in the enclosure) detected to be installed and OK" SUNWvts.enatest.6023 06/05/97 13:48:53 enatest ses0 ERROR: "MYBOX: Cannot communicate with the enclosure via /devices/sbus@1f,0/SUNW,socal@0,0:0; possibly connected to Lower-Left GBIC in the enclosure" Probable_Cause(s): (1)Signal too low at the GBIC module in the enclosure (2)Faulty cable or cable disconnected (3)Faulty GBIC module on the host side Recommended_Action(s): (1)Ensure the cables are properly connected (2)Please contact your service representative
SUNWvts.enatest.2006 06/05/97 13:48:53 enatest ses0 INFO: "MYBOX: Number of connections to the host: 1" |
|
Disk Access |
During the testing, each disk is accessed through each active connection leading to that disk. The enatest opens partition 2 on the disk and reads 512 bytes of raw data. If there are any failures, the test tries to isolate the fault to either an enclosure element, the cable, the host adapter card, or the OE module on the host adapter. See the section on "enatest Fault Isolation Capability" for more information. |
Enclosure Status |
The status of the enclosure is obtained by querying the SCSI Enclosure Services (SES) device in the enclosure. Detailed information regarding the status of the elements within the enclosure is reported. The test fails if a critical condition is detected in the enclosure. The table below shows how the status information is reported. |
Table 17-2 Element Enclosure Status
To reach the dialog box below, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.
Table 17-3 enatest Options
In the case of a failure, the test aids in fault isolation by reporting the possible cause(s) of failure. The fault isolation capability varies depending on the nature of the fault and the system configuration. enatest can detect and isolate hard faults. The following table shows the fault isolation capability for different configurations. A Yes indicates that fault isolation capability is available for that component in that configuration and a No indicates lack of fault isolation capability for that component in that configuration.
The following table is not applicable when using the PCI-based Fibre Channel card due to the card's lack of fault isolation capabilities.
Table 17-4 enatest Fault Isolation Configurations
Connections to Enclosure |
System Architecture |
SOC+ Host Adapter |
Host Side GBIC or Cable |
Enclosure Elements |
|||
---|---|---|---|---|---|---|---|
Disk |
Backplane |
IB |
GBIC |
||||
Multiple |
sun4u |
Yes |
Yes |
Yes |
Yes |
Yes |
Yes |
Multiple |
sun4d |
Yes |
No |
Yes |
Yes |
No |
No |
Single |
sun4u |
Yes |
No |
No |
No |
No |
No |
Single |
sun4d |
Yes |
No |
No |
No |
No |
No |
Test Mode |
Supported? |
Description |
---|---|---|
Connection test |
Yes |
In this mode, the host connections and the status of the enclosure are checked. The test fails if there are any broken connections or if a critical enclosure condition is detected. Noncritical conditions result in a warning. A sample of the output follows. |
Connection test starting....
ses0 Status: Connected Enclosure: Product Anemones Enterprise Network Array, Enclosure Name=MYBOX, Host Connections: Number of Active Connections=2, Enclosure State: Critical Conditions=None, Non-Critical Conditions=None
Connection test complete |
||
Functional (offline) |
Yes |
All test options are allowed in this mode. |
/opt/SUNWvts/bin/enatest standard_arguments -o dev=device_name, disk_access=enable|disable,disks=disk1:disk2:disk3:...diskn,disp=enable|disable, esfunc=enable|disable,conn=enable|disable,delay=delay_in_seconds
Table 17-6 enatest Command-Line Syntax
Argument |
Description |
---|---|
dev=device_name |
Specifies the name of an ses device in the enclosure. |
disk_access=enable|disable |
Enables or disables disk access. |
disks=disk1:disk2:disk3:... diskn |
Lists the disks contained in this enclosure that the disk_access test should attempt to access. The disk names are separated by colons (:). If this option is disabled, the test will access all disks found in the enclosure. |
disp=enable|disable |
Enables or disables the display of detailed status information regarding the enclosure elements. |
esfunc=enable|disable |
Enables or disables the Enclosure Services Functional test. |
conn=enable|disable |
Displays information about the connection to the host. |
delay=delay_in_seconds |
Sets the minimum delay (in seconds) between successive invocations of the test. |
64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".