|
| 以 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 Coverage | Description |
| 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. TABLE 10-2 shows how the status information is reported. |
-
TABLE 10-2
| 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 10-1 enatest
-
TABLE 10-3 enatest
| 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.
|
-
TABLE 10-3 enatest
| enatest Options | Description |
| 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 |
| 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 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
| 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. |
enatest Error Messages
-
TABLE 10-7 describes the enatest error messages, probable causes, and recommended actions.
-
TABLE 10-7 enatest
| 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. |
-
TABLE 10-7 enatest(Continued)
| Error Message | Probable 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 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
- 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 Message | Probable Cause(s) | Recommended Action |
| 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
- 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 Message | Probable 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 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.
-
TABLE 10-7 enatest(Continued)
| Error Message | Probable Cause(s) | Recommended Action |
| 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. |
|
|