SunVTS 2.1.3 Test Reference Manual
只搜寻这本书
以 PDF 格式下载本书
CHAPTER 10

Sun Enterprise Network Array Test(enatest)


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 can be used for validation, configuration verification, repair verification and fault isolation.
enatest detects all Sun Enterprise Network Array enclosures connected to the host and collects relevant configuration information. FIGURE 10-1 shows the Options menu which contains a sample configuration listing and test parameters. TABLE 10-1 describes the extent of the test coverage and provides samples of the configuration information that is displayed.
TABLE 10-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" on page 108" 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" on page 108"for more information.
TABLE 10-1 enatest
Test CoverageDescription
Enclosure StatusThe 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. TABLE 10-2 shows how the status information is reported.

TABLE 10-2
Enclosure ElementInformation
DiskFault Sensed: Yes/No
Status of ports A and B: Connected or Bypassed
Power SupplyStatus: ON/OFF
Temperature: OK/Critical Overtemp/Abnormal
AC Input: OK/Not OK
DC Output: OK/Not OK
FanStatus: On/Off
Speed: High/Low/Stopped
BackplaneStatus: OK/Failed
Status of ports A and B:
Connected/Bypassed
Interface BoardTemperature: OK/Critical Overtemp
Loop A status: OK/Failed
Loop B status: OK/Failed
GBICStatus: Disabled/Enabled
Signal Level: OK/Too low
Transmitter: OK/Failed

enatest Options

图形

FIGURE 10-1 enatest

TABLE 10-3 enatest
enatest OptionsDescription
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.

TABLE 10-3 enatest
enatest OptionsDescription
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.


Fault Isolation Capability

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 10-4 enatest



Host
Enclosure Elements


Connections
to Enclosure


System
Architecture

SOC+
Host
Adapter
Side
GBIC
or
Cable


Disk


Backplane


IB


GBIC
Multiplesun4uYesYesYesYesYesYes
Multiplesun4dYesNoYesYesNoNo
Singlesun4uYesNoNoNoNoNo
Singlesun4dYesNoNoNoNoNo

enatest Test Modes

TABLE 10-5 enatest
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.

enatest Command Line Syntax

/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 10-6 enatest
ArgumentExplanation
devThe name of a ses device in the enclosure.
diskThe disks will be accessed only if this option is enabled.
disksThis 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.
dispDetailed status information regarding the enclosure elements will be displayed only if this option is enabled.
esfuncThe Enclosure Services Functional Test will be performed only if this option is enabled.

enatest Error Messages

TABLE 10-7 describes the enatest error messages, probable causes, and recommended actions.
TABLE 10-7 enatest
Error MessageProbable 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 deviceBad host adapter.Run SunVTS socaltest on the host adapter.
TABLE 10-7 enatest(Continued)
Error MessageProbable Cause(s)Recommended Action
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 disknameInvalid device name.Contact your authorized Sun service representative.
6005 enclosure_name: Could not access diskname (enclosure_name, Front|Rear, Slot) through Host adapter device nameHost adapter is faulty.Contact your authorized Sun service representative.
6006 enclosure_name: Disk diskname cannot be accessed through Host adapter device nameCritical 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 nameInterface 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 nameCritical 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

Loss of light at the GBIC module Contact your authorized Sun
cannot be accessed             (in the enclosure) through which

service representative.
through Host adapter device name this disk is accessed.
Faulty cable.
Faulty GBIC module on the host side.
6013  enclosure_name: Could not

Faulty GBIC module on host side.
access diskname (enclosure
name, Front|Rear, Slot)
through Host adapter device

Bad cable connection.
name

Faulty Host Adapter.
6014  enclosure_name: Could not
      access diskname (enclosure
      name, Front|Rear, Slot)
      through Host adapter device

Faulty GBIC on host side.
Faulty cable.
name

TABLE 10-7 enatest(Continued)
Error MessageProbable Cause(s)Recommended Action
6015 enclosure_name: Could not access diskname through Host adapter device nameDisk is not installed.
6016 enclosure_name: Could not access diskname through Host adapter device nameDisk detected to be installed, but may be bypassed or powered off.
6017 enclosure_name: Disk diskname cannot be accessed through Host adapter device nameCritical 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 nameEnclosure backplane through which this disk is accessed is not installed.
6019 enclosure_name: Disk diskname cannot be accessed through Host adapter device nameGBIC 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 nameCritical 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 nameInterface 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 enclosureCritical failure (transmitter fault in the GBIC module in the enclosure).Contact your authorized Sun service representative.
6023  enclosure_name: Cannot

Signal level too low at the GBIC Ensure the cables are properly
module in the enclosure....connected. Contact your authorized Sun service
communicate with the
enclosure via Host adapter
device name; possibly
connected to location GBIC

Faulty cable or cable
representative.
disconnected.
in the enclosure
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.
TABLE 10-7 enatest(Continued)
Error MessageProbable Cause(s)Recommended Action
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 onlineError 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 nameCritical GBIC failure in the enclosure; location GBIC: disabled|enabled Signal: signal_level; Transmitter: Failed|OK; location GBIC: disabled|enabled Signal: signal_level; Transmitter: Failed|OKContact 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 accessedSoftware error.Contact your authorized Sun service representative.
8003  Internal error

Software error in test.....Contact your authorized Sun service representative
system error message.
TABLE 10-7 enatest(Continued)
Error MessageProbable Cause(s)Recommended Action
8004 enclosure_name: Could not communicate with enclosure via Host adapter device nameBad connection.Ensure the cables are properly connected. Contact your authorized Sun service representative.
8005 Could not communicate with the enclosureFaulty connection.Ensure the cables are properly connected. Run SunVTS socaltest to verify the host adapter. Contact your authorized Sun service representative.