getHardwareStatus

Get the status of the hardware.

Note: This function requires an API license.

Obtains the single status of the hardware of all servers that are linked together (by their management address). The status consists of three levels: ok, warning and error. If the status is warning or error than an additional description tag is send explaining the situation in user readable language.

This function requires the System Status plugin to be enabled. For more information about configuring the System status plugin, click here. If System Status plugin is not running, an errorcode = “0” will be given.

Request

command=getHardwareStatus

Response

<result errorcode="0">
  <hardwarestatus>
    <status>[Ok|Warning|Error]</status>
    <description>[string]</description>
  </hardwarestatus>
 </result>
node value remarks
/result
@errorcode [number] See error codes below
/result/hardwarestatus
status [Ok|Warning|Error] The status level.
description [string] Optional description of the status level.
error code description remarks
0 Ok Ok, no error
-54 System Status plugin not active The System Status plugin is not enabled or Sense PluginManager is not running

Results

If ok, the following will be returned:

<hardwarestatus>
  <status>Ok</status>
</hardwarestatus>

If failover is active, the following will be returned:

<hardwarestatus>
  <status>Error</status>
  <description>failover server is active</description>
</hardwarestatus>

In case of a Raid failure, the following will be returned:

<hardwarestatus>
  <status>Error</status>
 <description>[raid-status]</description>
</hardwarestatus>

[Raid-status] is a textual representation of the raid status. It is different for AMCC and LSI raid systems.

AMCC status

AMCC error [raid-status] messages have the following form:

AMCC: Server <ip of server>, RAID unit <id of unit>: <status of unit>
AMCC: Server <ip of server>, RAID drive <id of unit>: <status of drive>

Where status of a unit can be:

  • OK
  • Verifying
  • Initializing
  • Degraded
  • Rebuilding
  • Recovering
  • Migrating
  • Inoperable
  • Unknown

And where status of drive can be

  • OK
  • Offline
  • Offline JBOD
  • Uncoverted DCB
  • Unsupported DCB
  • DCB Data check
  • DCB Orphan
  • DCB Read failure
  • DCB Read timeout
  • Unsupported
  • Unknown

Note that not every status generates an error!
These values are taken from the official AMCC specifications

LSI status

LSI error [raid-status] messages have the following form:

LSI: Server <ip of server>, RAID unit <id of unit>: <status of unit>
LSI: <status of raid>

Where status of raid can be:

  • degraded
  • unconfigured-good
  • unconfigured-bad
  • hot-spare
  • offline
  • failed
  • rebuild
  • online
  • system
  • UNCONFIGURED-SHIELDED
  • HOTSPARE-SHIELDED
  • CONFIGURED-SHIELDED
  • rebuilding
  • no connection
  • invalid response

These values are taken from the official LSI MIB specifications

Example

A degraded AMCC unit will generate the following response:

<hardwarestatus>
   <status>Error</status>
   <description>AMCC: Server 10.0.0.10, RAID unit 2: Degraded</description>
</hardwarestatus>

Only the last unit or drive that has a failure is reported in the XML response. If an error occurs the systems raid configuration software should be consulted for more information a repair.

See also

Changelog

  • Sense 2.5.12 – Added error code -54
  • 2.4.2 – added