enatest is used to provide configuration verification, fault isolation, and repair validation of the Sun Enterprise Network Array.
The Sun Enterprise Network Array 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.
enatest detects all Sun Enterprise Network Array enclosures connected to the host and collects relevant configuration information. Figure 11-1 shows the Options menu which contains a sample configuration listing and test parameters. Table 11-1 describes the extent of the test coverage and provides samples of the configuration information that is displayed.
Table 11-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 socal 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 "Fault Isolation Capability"" for more information. |
Sample Output:
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 "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 11-2 Element Enclosure Status
Enclosure Element |
Information |
---|---|
Disk |
Fault Sensed: Yes/No Status of ports A and B: Connected or Bypassed |
Power Supply |
Status: ON/OFF Temperature: OK/Critical Overtemp/Abnormal AC Input: OK/Not OK DC Output: OK/Not OK |
Fan |
Status: On/Off Speed: High/Low/Stopped |
Backplane |
Status: OK/Failed Status of ports A and B: Connected/Bypassed |
Interface Board |
Temperature: OK/Critical Overtemp Loop A status: OK/Failed Loop B status: OK/Failed |
GBIC |
Status: Disabled/Enabled Signal Level: OK/Too low Transmitter: OK/Failed |
enatest Options |
Description |
---|---|
Enclosure Services Functional Test (General Description) |
Certain control operations are performed on devices in the enclosure through the SES device and verified that the operation was performed successful. This functional test involves the following steps: (a) Perform control operation. (b) Verify control operation was successful. (c) Restore state to what it was before (a). (d) Verify restore operation was successful. The test will fail if any one of the above steps fails.
This test targets the Disks and the Fans in the enclosure. |
Enclosure Services Functional Test (Detailed disk test description) |
(a) Control Operation: Each port of the disk is toggled from its original state: a port that was originally connected will be bypassed and vice-versa. (b) Verify Control Operation: This is done in two ways. First, the new status of the disk ports is verified by reading the status through the SES device. The test will fail if the status read back does not reflect the change. Next, disk access is attempted through the port that was originally connected but has now been bypassed. The test will fail if the access attempt is successful. (c) Restore State: The port states are restored to what they were before the Control Operation. (d) Verify Restore Operation: This is done in two ways. First the status of the disk ports is verified by reading the status through the SES device. The test will fail if the status read back does not reflect the change. Next, disk access is attempted through the port that have been reconnected. The test will fail if the access attempt is unsuccessful. |
Enclosure Services Functional Test (Detailed Fan test description) |
(a) Control Operation: The speed of each fan is toggled. Possible speeds are HIGH and LOW. (b) Verify Control Operation: The status is read back through the SES device and the speeds are compared. Failure to vary the speed in this case will result in an INFO message indicating that the fan speed could not be changed but does not result in a test failure. This is because SES can ignore fan speed change requests if required because of existing ambient temperature conditions. (c) Restore State: Restore the fan speed to the original speed. (d) Verify Restore Operation: This is similar to the Verify Control Operation step above. |
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.
Table 11-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 |
Description |
---|---|
Connection Test |
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. Non-critical 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 |
When invoked through SyMON, The Enclosure Services Functional Test is not allowed and the Disk Access option is disabled by default. When the test is invoked through regular SunVTS GUI, all the 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
Table 11-6 enatest Command Line Syntax
Argument |
Explanation |
---|---|
dev |
The name of a ses device in the enclosure. |
disk |
The disks will be accessed only if this option is enabled. |
disks |
This argument consists of a ":" separated list of disks contained within this enclosure, that the test will attempt to access if the disks_access option is enabled. If this option is absent the test will access all the disks that it can find in the enclosure. |
disp |
Detailed status information regarding the enclosure elements will be displayed only if this option is enabled. |
esfunc |
The Enclosure Services Functional Test will be performed only if this option is enabled. |
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".
This table describes the enatest error messages, probable causes, and recommended actions.
Table 11-7 enatest Error Messages
|
Error Message |
Probable Cause(s) |
Recommended Action |
---|---|---|---|
6000 |
enclosure_name: Unable to access disk diskname (enclosure name, Front|Rear, Slot) |
Bad disk. |
Contact your authorized Sun service representative. |
6001 |
Unable to access any disk through host adapter: host adapter device |
Bad host adapter. |
Run SunVTS socaltest on the host adapter. |
6003 |
enclosure_name: Unable to access disk diskname (enclosure_name, Front|Rear, Slot) through Host adapter device name. This disk is still accessible through other path(s) |
Port A or B of the disk is faulty. |
Contact your authorized Sun service representative. |
6004 |
enclosure_name: Failed to determine the location of disk diskname |
Invalid device name. |
Contact your authorized Sun service representative. |
6005 |
enclosure_name: Could not access diskname (enclosure_name, Front|Rear, Slot) through Host adapter device name |
Host adapter is faulty. |
Contact your authorized Sun service representative. |
6006 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
Critical failure in the Interface Board (in the enclosure) through which this disk is accessed. |
Contact your authorized Sun service representative. |
6007 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
Interface Board (in the enclosure) through which this disk is accessed is not installed. |
|
6008 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
Critical failure (transmitter fault) in the GBIC module (in the enclosure) through which this disk is accessed. |
Contact your authorized Sun service representative. |
6009 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
Loss of light at the GBIC module (in the enclosure) through which this disk is accessed. |
Contact your authorized Sun service representative. |
Faulty cable. |
|||
Faulty GBIC module on the host side. |
|||
6013 |
enclosure_name: Could not access diskname (enclosure name, Front|Rear, Slot) through Host adapter device name |
Faulty GBIC module on host side. |
|
Bad cable connection. |
|||
6014 |
enclosure_name: Could not access diskname (enclosure name, Front|Rear, Slot) through Host adapter device name |
Faulty Host Adapter. |
|
Faulty GBIC on host side. |
|||
Faulty cable. |
|||
6015 |
enclosure_name: Could not access diskname through Host adapter device name |
Disk is not installed. |
|
6016 |
enclosure_name: Could not access diskname through Host adapter device name |
Disk detected to be installed, but may be bypassed or powered off. |
|
6017 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
Critical failure in the enclosure backplane through which this disk is accessed. |
Contact your authorized Sun service representative. |
6018 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
Enclosure backplane through which this disk is accessed is not installed. |
|
6019 |
enclosure_name: Disk diskname cannot be accessed through Host adapter device name |
GBIC module (in the enclosure) through which this disk is accessed is not installed. |
|
6020 |
enclosure_name: Cannot communicate with the enclosure via Host adapter device name |
Critical failure in the Interface Board (top/bottom one in enclosure). |
Contact your authorized Sun service representative. |
6021 |
enclosure_name: Cannot communicate with the enclosure via Host adapter device name |
Interface board (top or bottom) is not installed in the enclosure. |
|
6022 |
enclosure_name: Cannot communicate with the enclosure via Host adapter device name; possibly connected to location GBIC in the enclosure |
Critical failure (transmitter fault in the GBIC module in the enclosure). |
Contact your authorized Sun service representative. |
6023 |
enclosure_name: Cannot communicate with the enclosure via Host adapter device name; possibly connected to location GBIC in the enclosure |
Signal level too low at the GBIC module in the enclosure. |
Ensure the cables are properly connected. Contact your authorized Sun service representative. |
|
Faulty cable or cable disconnected. |
||
|
Faulty GBIC module on the host side. |
||
6024 |
enclosure_name: Cannot communicate with the enclosure via Host adapter device name |
GBIC module (location) is not installed in the enclosure. |
|
6026 |
enclosure_name: Failed to Restore|Toggle disk (Front|Rear, slot slot_number) state. Expected: Port A: Bypassed|Connected; Port B: Bypassed|Connected; Observed: Port A: Bypassed|Connected; Port B: Bypassed|Connected |
Error in Enclosure Services or Enclosure Element. |
Contact your authorized Sun service representative. |
6027 |
enclosure_name: Unable to access disk diskname (Front|Rear slot slot_number) through port A|B even after bringing the port online |
Error in Enclosure Services or Enclosure Element. |
Contact your authorized Sun service representative. |
6028 |
enclosure_name: Disk access succeeded for diskname (Front|Rear slot slot_number) through port A|B even after requesting that the port be bypassed |
Error in Enclosure Services or Enclosure Element. |
Contact your authorized Sun service representative. |
6035 |
enclosure_name: Cannot access enclosure through Host adapter device name |
Critical GBIC failure in the enclosure; location GBIC: disabled|enabled Signal: signal_level; Transmitter: Failed|OK; location GBIC: disabled|enabled Signal: signal_level; Transmitter: Failed|OK |
Contact your authorized Sun service representative. |
6036 |
enclosure_name: Critical condition detected in enclosure! |
|
Run this test in 'Functional' mode for more information. Contact your authorized Sun service representative. |
8001 |
Could'nt determine the host adapter through which diskname being accessed |
Software error. |
Contact your authorized Sun service representative. |
8003 |
Internal error |
Software error in test. |
Contact your authorized Sun service representative |
system error message. |
|||
8004 |
enclosure_name: Could not communicate with enclosure via Host adapter device name |
Bad connection. |
Ensure the cables are properly connected. Contact your authorized Sun service representative. |
8005 |
Could not communicate with the enclosure |
Faulty connection. |
Ensure the cables are properly connected. Run SunVTS socaltest to verify the host adapter. Contact your authorized Sun service representative. |