Enclosure Widget

EnclosureW

Command-Line Invocation and Application Notes

This widget will determine of the attached device supports both SES and SAF-TE class enclosures, and automatically enumerates the appropriate information.

SAF-TE

SAF-TE enclosures are the equivalent of SES enclosures, but for SCSI-attached hosts. Unlike SES enclosures, SAF-TE enclosures always present a unique SCSI ID and LUN to the host computer. The internal mechanism and commands that SMARTMon has to use to determine the health of a SAF-TE enclosure are different from those commands used to communicate with a SES enclosure. The net result is the same, however.

SAF-TE is the name for a specialized command set that is used to manage and sense the state of the power supplies, cooling devices, displays, indicators, individual drives, and other non-SCSI elements installed in a SCSI enclosure. If you have a SAF-TE-compliant enclosure, this software can decode and report this information.

Unless you have a very inexpensive enclosure, chances are good that your enclosure is SAF-TE-compliant. If you are not sure, invoke the -E+ option and find out. Below is sample output from one of our enclosures when we unplugged one of the power supplies and ran the program on a Windows XP machine.

smartmon-ux -I+ -E+ \\.\SCSI3:

Discovered CNSi JSS122 S/N " " on \\.\SCSI3: (processor) [SAF-TE] [Adapter/ID.LUN=0/0.6]

Inquiry Text Page Data - ANSI defined fields

Device Type: processor

Peripheral Qualifier: Connected to this LUN

Removable Device: NO

ANSI Version: 3 (SPC ANSI X3.301:1997)

ISO/IEC Version: 0

ECMA Version: 0

Vendor Identification: CNSi

Product Identification: JSS122

Firmware Revision: L421

Async event reporting: NO

Supports 16-bit wide addresses: NO

Supports 32-bit wide addresses: NO

Supports CONTINUE_TASK & TARGET XFR: NO

Terminate task supported: NO

Response data format: 2

Relative addressing supported: NO

Supports request/ACK data transfer: NO

32-bit parallel supported: NO

Normal ACA Supported: NO

Enclosure services available: NO

Multi-ported device: NO

Medium-changer attached: NO

16-bit parallel supported: YES

Synchronous commands supported: YES

Linked commands supported: NO

Command queuing supported: YES

Inquiry Page Hex Dump:

0000: 03 00 03 02 9B 00 00 32 43 4E 53 69 20 20 20 20 .......2CNSi

0010: 4A 53 53 31 32 32 20 20 20 20 20 20 20 20 20 20 JSS122

0020: 4C 34 32 31 30 20 20 20 20 20 20 20 53 41 46 2D L4210 SAF-

0030: 54 45 31 2E 30 30 00 00 0C 00 00 00 00 00 00 00 TE1.00..........

0040: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................

0050: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................

0060: 43 68 61 70 74 65 63 20 42 72 69 64 67 65 20 4C Chaptec Bridge L

0070: 34 32 31 20 20 20 20 20 00 00 00 00 00 00 00 00 421 ........

0080: 00 00 00 53 44 52 20 20 20 20 20 47 45 4D 32 30 ...SDR GEM20

0090: 30 20 20 20 20 20 20 20 20 20 20 32 20 20 20 0 2

Inquiry EVPD Page #00h

0000: 7F 00 03 02 9B 00 ......

SAF-TE Enclosure dump:

Cooling/Fan #0: Operational

Cooling/Fan #1: Operational

Cooling/Fan #2: Not Installed (Reserved for future use)

Power Supply #0 : Operational (Turned on)

Power Supply #1 : Malfunctioning (Commanded on)

Power Supply #2 : Not Installed (Reserved slot)

Device in slot #0: Empty slot

Device in slot #1: Empty slot

Device in slot #2: Activated (SCSI ID is 02h)

Device in slot #3: Activated (SCSI ID is 03h)

Device in slot #4: Empty slot

Device in slot #5: Activated (SCSI ID is 05h)

Door Lock #0: Unlocked (or no controllable lock installed

Alarm Speaker #0: Off (or not installed)

Temperature Sensor #0: 34C / 94F

The text in RED printed as a result of the -E+ option. The rest of the text printed because the -I+ option was also selected.

•

If you invoke the -E option, the program will run in the background and poll your SES compliant enclosure(s) at the same time it polls disk drives. If a problem is found, it generates an alert as specified by the command-line options. If you invoke the program with the -E+ option, all of the current enclosure information will display and the program will terminate.

•	There are additional informational fields that this program can report, providing your enclosure manufacturer reports that information to the SAF-TE electronics in their engine.

•	If your SAF-TE enclosure supports the optional SAF-TE power-on minutes or SAF-TE power-on cycles data, we report that as well starting in revision 1.27.

•	Version 1.28 added SAF-TE reporting capability for additional slot and array status reporting.

Below is the output that one might see in a log file or email alert before and after unplugging a power cable.

smartmon-ux -E -F 10 \\.\SCSI3:

*******************************************************************

* This is an evaluation license. The software will expire on *

* Sun Sep 15 23:11:53 2002 (11 days). *

*******************************************************************

Discovered CNSi JSS122 S/N " " on \\.\SCSI3: (processor) [Adapter/ID.LUN=0/0.0]

Discovered CNSi JSS122 S/N " " on \\.\SCSI3: (processor) [SAF-TE] [Adapter/ID.LUN=0/0.6]

Program will poll every 10 seconds.

\\.\SCSI3: polled at Wed Sep 04 23:11:53 2002 Status:OK

\\.\SCSI3: polled at Wed Sep 04 23:12:03 2002 Status:OK

\\.\SCSI3: polled at Wed Sep 04 23:12:13 2002 Status:Critical - Power Supply #1 Malfunctioning (Commanded on) CNSi JSS122

\\.\SCSI3: polled at Wed Sep 04 23:12:23 2002 Status:Critical - Power Supply #1 Malfunctioning (Commanded on) CNSi JSS122

\\.\SCSI3: polled at Wed Sep 04 23:12:33 2002 Status:OK

SES (SCSI ENCLOSURE SERVICES)

SCSI Enclosure Services, referred as SES in this document, is a command set that is used to manage and sense the state of the power supplies, cooling devices, displays, indicators, individual drives, and other non-SCSI elements installed in a fibre channel enclosure. If you have a SES-compliant enclosure, this software can decode and report this information. SMARTMon-ux supports the following SES-related viewing parameters:

-E Polls SES status for the selected device at the next polling interval. If smartmon-ux is running in the foreground, the status will appear on the screen. If the software is running in the background, SMARTMon-ux will continue to run in the background, and the results will be saved to the default logging location specified by the defaults and/or other run-time parameters.

-E+ Displays full alphanumeric SES dump. If you have an enclosure where we report vendor-unique data, you will see that also. Once everything is polled and reported, the program will terminate.

-EH Displays hex dump of all SES configuration & status pages. You would ordinarily use this command to view vendor-unique data that we do not decode with the -E+ option. Once everything is polled and reported, the program will terminate.

-EF Instructs the software to "discover" the SES information by a brute-force method, rather than invoking a SES command which will report what enclosure data is available. The -EF option was added reluctantly because we discovered an enclosure that was not ANSI compliant which rejected the query operation. If your enclosure does not report any SES information, but you are sure it has that capability, you should try adding the -EF to one of the above commands.

Unless you have a very inexpensive enclosure, your fibre-channel enclosure is probably SES-compliant. If you are not sure, run smartmon-ux with the -E+ option and find out. Below is sample output from one of our enclosures when we unplugged one of the power supplies.

smartmon-ux -E+ /dev/sdc

Discovered SEAGATE ST336753FC S/N "3HX00LE3" on /dev/sdc [SES] (Not Enabling SMART)(35003 MB)

XYRATEX RS1600-FC2-FFX2 WWN=20-00-00-50-CC-00-7B-8E:

Configuration switches numbered from 1-12 as viewed from rear, top to bottom

Vendor-specific features (Notes) [SWITCH SETTING]

SoftSelect Mode (Disabled) [SW11-OFF]

Drive Speed (2 Gbit FC Mode)

Loop Config (1 x 16 loop) [SW1-ON]

Hub Mode (Enclosure in hub mode) [SW3-ON]

Reserved (reserved) [SW4-OFF]

SES Report (REPORT bit set on single)

Power Redundancy Indication (Enclosure indicates redundancy)

Ops Panel Muted Mode (Enclosure in REMIND mode)

Drive Addressing Mode: 0 (1 x 16 JBOD)

Unit Select Switch: 1

Model is: Goshawk - Mylex FFX2 RAID 2Gbit dual port controller

Master LRC Firmware level: 35

SFP Host 0 Present (LoopA): YES

SFP Host 0 Good (A): NO

SFP Host 1 Present (A): YES

SFP Host 1 Good (A): NO

SFP Expansion Present (A): NO

SFP Expansion Good (A): NO

SFP Host 0 Present (LoopB): YES

SFP Host 0 Good (B): NO

SFP Host 1 Present (B): NO

SFP Host 1 Good (B): NO

SFP Expansion Present (B): YES

SFP Expansion Good (B): NO

Device #0 OK SelID=04h [Row=1 Col=1]

Device #1 Not Installed SelID=05h [Row=1 Col=2]

Device #2 OK SelID=06h [Row=1 Col=3]

Device #3 Not Installed SelID=07h [Row=1 Col=4]

Device #4 Not Installed SelID=08h [Row=2 Col=1]

Device #5 Not Installed SelID=09h [Row=2 Col=2]

Device #6 Not Installed SelID=0ah [Row=2 Col=3]

Device #7 Not Installed SelID=0bh [Row=2 Col=4]

Device #8 Not Installed SelID=0ch [Row=3 Col=1]

Device #9 Not Installed SelID=0dh [Row=3 Col=2]

Device #10 Not Installed SelID=0eh [Row=3 Col=3]

Device #11 Not Installed SelID=0fh [Row=3 Col=4]

Device #12 OK SelID=10h [Row=4 Col=1]

Device #13 Not Installed SelID=11h [Row=4 Col=2]

Device #14 OK SelID=12h [Row=4 Col=3]

Device #15 OK SelID=13h [Row=4 Col=4]

Power Supply #0 Critical DC Undervoltage AC failure DC failure [LED ON]

Power Supply #1 OK

Cooling Element #0 OK fan at speed 4

Cooling Element #1 OK fan at speed 4

Temperature Sensor #0 OK 104F/40C

Audible Alarm #0 OK ENABLED sounding CRITICAL

SESElectronics Processor #0 OK [ACTIVE]

SESElectronics Processor #1 OK [PASSIVE]

Threshold Information Warning Range Critical Range

Temperature Sensor #0: 30 - 74 20 - 78

Module Locations - Front View

Col-1 Col-2 Col-3 Col-4

+--------------------------------------+

|Dev #00 | Dev #01 | Dev #02 | Dev #03 | Row-1

|Dev #04 | Dev #05 | Dev #06 | Dev #07 | Row-2

|Dev #08 | Dev #09 | Dev #10 | Dev #11 | Row-3

|Dev #12 | Dev #13 | Dev #14 | Dev #15 | Row-4

+--------------------------------------+

Module Locations - Rear View

+--------------------------------------+

| PSU / | 2nd | 1st |OPS | PSU / |

| First | 'B' | 'A' | | Second |

| #0 | #1 | #0 | | #1 | <--SES ID#

+--------------------------------------+

Legend for Below: SN=Serial#, (optional)SC=Status Code

LRC-A: SN=PMT317000005619

LRC-B: SN=PMT317000005396

Power Supply#1: SN=IMS4204300008BB

Power Supply#2: SN=IMS4204300007F7

•	The text in RED represents the typical output that you would have regardless of your enclosure manufacturer. This is the result of decoding only the ANSI-defined information. The BLUE text represents additional information that might appear if you had an enclosure manufactured by Xyratex.

•

If you invoke smartmon-ux with the -E option, the program will run in the background and poll your SES compliant enclosure(s) at the same time it polls disk drives. If a problem is found, it generates an alert as specified by the command-line options. If you invoke the program with the -E+ option, all of the current enclosure information will display and the program will terminate.

•	There are dozens of additional informational fields that this program can report, providing your enclosure manufacturer reports that information to the SES electronics in their engine. Our software reports all SES elements defined in the specification.

Here is the output from a HP A6214 enclosure for comparison. This enclosure implements SES differently, as it exposes a SES-specific Fibre Channel ID. The Xyratex enclosure implemented SES services via a pass-through disk drive. Both methods are defined by the ANSI specification, and both are supported by our software.

Discovered HP A6214A S/N "R16RH1394676" on /dev/rscsi/c4t15d0 [SES] (Enclosure Services)

HP A6214A WWN=50-06-0B-00-00-0C-62-8A:

Device #0 OK Slot=00h

Device #1 OK Slot=01h

Device #2 OK Slot=02h

Device #3 Not Available Slot=03h

Device #4 OK Slot=04h

Device #5 OK Slot=05h

Device #6 OK Slot=06h

Device #7 OK Slot=07h

Device #8 OK Slot=08h

Device #9 OK Slot=09h

Device #10 OK Slot=0ah

Device #11 OK Slot=0bh

Device #12 OK Slot=0ch

Device #13 OK Slot=0dh

Device #14 OK Slot=0eh

Power Supply #0 OK

Power Supply #1 OK

Cooling Element #0 OK fan at speed 4

Cooling Element #1 OK fan at speed 4

Temperature Sensor #0 OK 93F/34C

Temperature Sensor #1 OK 95F/35C

Audible Alarm #0 OK ENABLED

SESElectronics Processor #0 OK [ACTIVE]

SESElectronics Processor #1 OK [PASSIVE]

SCSIPort #0 OK This device did NOT participate in transmission of SES info [Link DOWN]

SCSIPort #1 OK This device did NOT participate in transmission of SES info [Link UP]

SCSIPort #2 OK This device did NOT participate in transmission of SES info [Link DOWN]

SCSIPort #3 OK This device did NOT participate in transmission of SES info [Link DOWN]

VoltageSensor #0 OK Input voltage 33.2 VAC RMS

VoltageSensor #1 OK Input voltage 51.2 VAC RMS

VoltageSensor #2 OK Input voltage 121.6 VAC RMS

VoltageSensor #3 OK Input voltage 33.2 VAC RMS

VoltageSensor #4 OK Input voltage 51.6 VAC RMS

VoltageSensor #5 OK Input voltage 122.4 VAC RMS

VendorSpecific Device (80) Status: 01 00 00 00

VendorSpecific Device (81) Status: 01 00 01 00

Note that this devices contains some vendor-specific information and supports a few more sensors (primarily voltage).

Other SES Information

In addition to the information you see above, this software reports and decodes SES Pages 5 (SES Threshold Page), SES Page 6 (SES Array Status Page), SES Page 3 (SES Help Text), SES Page 7 (SES Descriptor Text), SES Page A (SES Array) Not all enclosures report all of this information. See the Vendor-unique enclosure information screen for some sample dumps.

Page url: http://www.santools.com/santool/index.html?enclosure.htm