Package: cs.app.megacli
Command line tool to inspect and manipulate LSI MegaRAID adapters,
such as used in IBM ServeRAID systems and Dell PowerEdge RAID Controller (PERC).Latest release 20211031:Update to Python 3, old Python 2 code recorded in cs.app.megacli2.Various interna updates while parsing Dell PERC output.Many IBM xSeries servers come with LSI Logic MegaRAID RAID controllers,
under the name IBM ServerRAID.
These controllers are also used by Dell as Dell PowerEdge RAID Controller (PERC).These can be accessed during the machine boot process via the BIOS screens
using a conventional BIOS-like text interface or a ghastly and painful to use
GUI interface. However, either of these requires the machine OS to be down.The RAID adapters can also be accessed while the machine OS is up.
For Linux, IBM offer a set of command line tools named MegaCLI_,
which are installed in/opt/MegaRAID.
Unfortunately, their MegaCLI executable is both fiddly to invoke
and, in its reporting mode, produces a barely human readable report
which is quite hostlie to machine parsing.
I would surmise that someone was told to dump the adapter data in text form,
and did so with an ad hoc report; it is pages long and arduous to inspect by eye.The situation was sufficiently painful that I wrote this module
which runs a couple of the report modes and parses their output.Report ModeThe "report" mode then dumps a short summary report of relevant information
which can be eyeballed immediately;
RAID configuration and issues are immediately apparent.
Here is an example output
(the "+" tracing lines are on stderr
and recite the underlying MegaCLI commands used):# mcli report
+ exec py26+ -m cs.app.megacli report
+ exec /opt/MegaRAID/MegaCli/MegaCli64 -CfgDsply -aAll
+ exec /opt/MegaRAID/MegaCli/MegaCli64 -PDlist -aAll
Adapter 0 IBM ServeRAID-MR10i SAS/SATA Controller serial# Pnnnnnnnnn
  Virtual Drive 0
    2 drives, size = 278.464GB, raid = Primary-1, Secondary-0, RAID Level Qualifier-0
      physical drive enc252.devid8 [252:0]
      physical drive enc252.devid7 [252:1]
  4 drives:
    enc252.devid7 [252:1]: VD 0, DG None: 42D0628 279.396 GB, Online, Spun Up
    enc252.devid8 [252:0]: VD 0, DG None: 81Y9671 279.396 GB, Online, Spun Up
    enc252.devid2 [252:2]: VD None, DG None: 42D0628 279.396 GB, Unconfigured(good), Spun Up
    enc252.devid3 [252:3]: VD None, DG None: 42D0628 279.396 GB, Unconfigured(good), Spun UpStatus ModeThe "status" mode recites the RAID status in a series of terse one line summaries;
we use its output in our nagios monitoring.
Here is an example output (the "+" tracing lines are on stderr,
and recite the underlying MegaCLI commands used):# mcli status
+ exec py26+ -m cs.app.megacli status
+ exec /opt/MegaRAID/MegaCli/MegaCli64 -CfgDsply -aAll
+ exec /opt/MegaRAID/MegaCli/MegaCli64 -PDlist -aAll
OK A0Locate ModeThe "locate" mode prints a MegaCLI command line
which can be used to activate or deactivate the location LED on a specific drive.
Here is an example output:# mcli locate 252:4
/opt/MegaRAID/MegaCli/MegaCli64 -PdLocate -start -physdrv[252:4] -a0

# mcli locate 252:4 stop
/opt/MegaRAID/MegaCli/MegaCli64 -PdLocate -stop -physdrv[252:4] -a0New_RAID ModeThe "new_raid" mode prints a MegaCLI command line
which can be used to instruct the adapter to assemble a new RAID set.MegaCLI classThe module provides a MegaCLI class which embodies the parsed information
from the MegaCLI reporting modes.
This can be imported and used for special needs... _MegaCLI:http://www-947.ibm.com/support/entry/portal/docdisplay?lndocid=migr-5082327Release LogRelease 20211031:Update to Python 3, old Python 2 code recorded in cs.app.megacli2.Various interna updates while parsing Dell PERC output.Release 20190729:
A little more report line parsing flexibility.Release 20160310:
remove more external dependencies, mention operation with Dell PowerEdge RAID Controller (PERC)Release 20160226:
cs.app.megacli: honour $MEGACLI for MegaCLI executable path, remove some external script dependencies, note Dell PowerEdge RAID Controller (PERC) is also a MegaRAID or compatibleRelease 20160225:
changes to remove dependencies on pythons newer than 2.4 and also other modules; issue reported bydesius@gmail.comRelease 20150801.1:
Update README-megacli.rst documentation.Release 20150801:New commands "locate" and "offline".Report drive error counts.Release 20150118.5:
README: scrub adapter serial number from example, fix typo.Release 20150118.4:
example outputs in READMERelease 20150118.3:
mention MegaCLI class in READMERelease 20150118.2:
README fixRelease 20150118:
Initial PyPI release.