User manual

SANtools® S.M.A.R.T. Disk Monitor (SMARTMon-UX)36
SANTOOLS® is registered in US Patent and Trademark Office No 3,107,854 All rights reserved.
Byte/Bit
7
6
5
4
3
2
1
0
0
Common Control (This is automatically set to zero)
1 (ww field)
Reserved
2 (xx field)
Active
Do Not
Remove
Reserved
Request
Insert
Request
Remove
Request
Identify
Reserved
3 (yy field)
Reserved
Request
Fault
Device Off
Enable
Bypass A
Enable
Bypass B
Reserved
To enable the request fault light, we must set bit 5 in byte #3 (i.e., 20 hex), so the wwxxyy sequence must be
000020.
As we are controlling the device element, we must send a 01 to indicate a disk device. For our example, we'll select
the third device in the enclosure (corresponding to element # 2).
Put it all together, and you would send out -EP20102000020.
If we were to send out -EP20102000200, this will turn off the fault light, but turn on the identify light (assuming one
exists). Note that the fault light goes off because byte 3 (the yy field) has all zeros in it. The SES enclosure will stay
in whatever state you put it in, until either the enclosure decides to override that state or power is reset to the
enclosure. Everything is volatile. (There may be some exceptions for vendor-unique SES elements).
If you wanted to instruct the device to both request fault and force the bypass "A" path, and turn on the identify LED,
then send -EP20102000228.
1.13 Enclosure Services Configurator (SES)
As of release 1.20, the administrator has the ability to control selected characteristics of a SES-compliant enclosure.
Not all of the functions outlined in this chapter are supported by all enclosures. If you have any doubt whether or not a
particular firmware revision of your SES enclosure supports a particular function, please contact your storage vendor.
SMARTMon-ux sends SES commands according to the ANSI specification, but the specification does not require a
SES enclosure to support all of the functions which can be controlled by this software.
The following functions may be used together or in combination with other options with one or more enclosures on the
same command line. In all of these commands, the letter "n" indicates the SES device number for the particular
component. Per the ANSI SES specification, all devices start at unit zero. If you had a 16-disk enclosure, your disks
would be numbered from 0 to 15.
Visual fault indicators are the LEDs (Light Emitting Diodes). Manufacturers are free to use multiple LEDs, multi-color
LEDs, or single LEDs with different flashing frequencies to differentiate the indicators. Typically a manufacturer will
assign a yellow LED for the fault indicator, and one or two LEDs for identification. This software sends the commands
to control all possible LEDs defined by the ANSI SES specification. If you are unable to control individual LEDs with
this software, then please contact us. We will work with the manufacturer to determine whether or not they utilize
vendor-specific commands to control the control LEDs.
Some SES-compatible enclosures associate devices in the individual slots as array devices. The LSI SAS Shea
enclosure is one example. The -EPL family of commands were added in release 1.36 to support them. You will not
hurt anything by trying to control the various visual fault LEDs and send an unsupported command. The enclosure will
just ignore it. However, you should not attempt to use this software to turn off fans or power supplies on a production
system unless you know what you are doing, as some SES enclosures will freely let you turn off all of the fans and/or
power supplies.
Note also that all commands are case sensitive. In most cases, the capital letter instructs program to turn on
a feature, while the lower-case letter in the option instructs the feature to be turned off.