MEGASASCTL(8) User Commands MEGASASCTL(8)NAMEmegasasctl - a reporting tool for LSI MegaRAID SAS (Serial-Attached-
SCSI) adapters and its attached disks.
DESCRIPTIONmegasasctl can report diagnostics on megaraid adapters and attached
disks.
It permits dumping of controller log pages for inspection of error,
temperature, and self-test conditions, initiates self-test diagnostics,
and documents adapter and logical drive configuration.
Target devices may be adapters, (e.g. a0), channels (e.g. a0c0), or
individual disks (e.g. a0c0t0).
If no target is specified, reports configuration and drive state on all
adapters.
If a target matches a collection of disks, operations are applied to
all matching devices.
REQUIREMENTSmegasasctl requires the device file /dev/megaraid_sas_ioctl_node to be
present on the system. the system.
On Mandriva systems, this device node will be created dynamically if
needed.
SYNOPSISmegasasctl [-vest] [-H] [-l log-page-nr] [-T long|short] [target ...]
OPTIONS-v Increase program verbosity.
-e Dump read (0x03), write (0x02), and verify (0x05) error log
pages.
-s Dump self-test (0x10) log page.
-t Dump temperature (0x0d) log page.
-l <page>
Dump the specified log page.
Log page 0 documents the log pages the device supports.
-p Do not report physical disks.
Reports only adapters and logical drives.
Useful for concisely documenting adapter configuration.
-T short|long
Initiate the background short or long self-test procedure.
The test may take up to an hour to complete, but does not
inhibit access to the device.
The test may be monitored using the -s option.
The background long self test is a useful tool for diagnosing
problems with individual disks.
But be cautious with program usage. "megactl -T long" with no
targets will initiate a background long self test on every drive
on every adapter.
This may not be what you want.
-H Perform an adapter health check.
Inspects state of all logical and physical drives and battery
backup unit and reports problem conditions.
If all is well, generates no output. Useful in a cron job.
By default, the health check option inspects log pages 0x02,
0x03, and 0x05 for uncorrected read, write, and verify errors,
0x0d for excess temperature conditions, and 0x10 for failed self
tests.
If, however, any of the log page options is specified, only the
designated log pages are inspected.
-B When performing health check, do not treat battery problems as
failures.
-V Show version.
SEE ALSO
Homepage: http://sourceforge.net/projects/megactl
/usr/share/doc/megactl/README.Mandriva to enable periodic health check.
megactl(8): Same tool, for SCSI adapters.
AUTHOR
This manual page was written by Adam Cécile <acecile@mandriva.com> for
the Mandriva system (but may be used by others).
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 2 or any
later version published by the Free Software Foundation
0.4.1 September 2007 MEGASASCTL(8)
