Contained Within
Find More Documentation
Featured Support Resources
|  Descargar este libro en PDF
- CHAPTER 11
Sun Enterprise Network Array Test(enatest)
-
enatest tests 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.
- Disk enclosure capable of supporting up to 22 1-inch drives or 14 1.6-inch drives. Facility for display and control of the configuration is provided through a front panel display module.
- 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 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.
- The enatest probe detects all the Sun Enterprise Network Array enclosures connected to the host and collects relevant configuration information. FIGURE 11-1 displays the test parameters associated with enatest. See TABLE 11-1 for a sample of the configuration information that is displayed.
-
TABLE 11-1 enatest Coverage
-
Test Coverage Description
Host Connections 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. Please see
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 Each disk is accessed through each active connection leading upto
that disk. The access consists of opening partition 2 on the disk and
reading 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. Please see the
section on "Fault Isolation Capability" for more information.
|
-
TABLE 11-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. The following information is reported. See TABLE 11-2. |
-
TABLE 11-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 11-1 enatest
-
TABLE 11-3
| enatest Options | Description |
|
| Enclosure Services Functional Test | Certain control operations are performed on devices in the enclosure through the SES device and verified that the operation was performed successfuly. 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 Disk Test | (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(s) that was/were originally connected but has/have 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(s) that has/have been reconnected. The test will fail if the access attempt is unsuccessful.
|
-
TABLE 11-3
| enatest Options | Description |
|
| Enclosure Services Fan Test | (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 only result in an INFO message indicating that the fan speed could not be changed but 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 does fault isolation and reports 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
|
|
| 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 11-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 is below: Connection test starting.... ses0 Status: Connected Enclosure: Product Name=Sun 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 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
| Argument | Explanation |
|
| dev | This is 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 ":" seperated 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 11-7 describes the enatest error messages, probable causes, and recommended actions.
-
TABLE 11-7
| Error Message | Probable Cause(s) | Recommended Action |
|
| 6000 | <enclosure_name>: Unable to access disk <diskname> (<enclosure name>, <Front|Rear>, Slot) | Bad disk | Contact your 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 11-7 (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|B> of the disk faulty> | Contact your Sun service representative |
| 6004 | <enclosure_name>: Failed to determine the location of disk <diskname> | Invalid device name | Contact your Sun service representative |
| 6005 | <enclosure_name>: Could not access <diskname> (<enclosure_name>, <Front|Rear>, Slot) through <Host adapter device name> | Host adapter faulty | Contact your 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 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 Sun service representative |
- 6009 <enclosure_name>: Disk
- Loss of light at the GBIC module Contact your Sun service
- <diskname> cannot be accessed (in the enclosure) through which
- representative
- through <Host adapter device..this disk is accessed
- name>
- 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
- Bad cable connection
-
-
device name>
-
TABLE 11-7 (Continued)
| Error Message | Probable Cause(s) | Recommended Action |
- 6014 <enclosure_name>: Could not
- Faulty Host Adapter
- access <diskname> (<enclosure name>, <Front|Rear>, Slot)
Faulty GBIC on host side
- through <Host adapter device
Faulty cable
- name>
-
| 6015 <enclosure_name>: Could not access <diskname> through <Host adapter device name> | Disk 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 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 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 Sun service representative |
-
TABLE 11-7 (Continued)
| Error Message | Probable Cause(s) | Recommended Action |
-
-
6023 <enclosure_name>: Cannot
- Signal level too low at the GBIC Ensure the cables are properly
- module in the enclosure...connected. Contact your Sun service representative.
-
-
communicate with the
enclosure via <Host
adapter device name>;
possibly connected to
<location> GBIC in the
- Faulty cable or cable disconnected
- Faulty GBIC module on the
- enclosure
- 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 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 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 Sun service representative |
-
TABLE 11-7 (Continued)
| Error Message | Probable Cause(s) | Recommended Action |
|
| 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 Sun service representative |
| 6036 <enclosure_name>: Critical condition detected in enclosure! |
| Run this test in 'Functional' mode for moreinformation. Contact your Sun service representative |
| 8001 Could'nt determine the host adapter through which <diskname>is being accessed | Software error | Contact your Sun service representative |
-
-
8003 Internal error
- Software error in test....Contact your 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 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 Sun service representative. |
|
|
