SunVTS 3.0 Test Reference Manual

Chapter 11 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:

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

Figure 11-1 enatest Option Menu

Graphic

Table 11-3 enatest Options

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.

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 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 

enatest Test Modes

Table 11-5 enatest Test Modes

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 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. 


Note -

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".


enatest Error Messages

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.