NAME

       megasasctl - diagnostics on megaraid adapters and attached disks.

SYNOPSIS

       megasasctl [-vest] [-H] [-l log-page-nr] [-T long|short] [target ...]

       Reports  diagnostics on megaraid adapters and attached disks. 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), enclosures
       (e.g. a0e0), or individual disks (e.g. a0e0s0). 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. Options are:

       -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 test
              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.

       -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.

       -B     When performing health check, do not treat battery problems as failures.

       -V     Show version.

       N.B. The background long self test is a useful tool for diagnosing problems with individual disks. But be
       cautious  with  program usage.  "megasasctl -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.

       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.

       This program requires the device file /dev/megaraid_sas_ioctl_node to be present on the system.  If  your
       system  does  not  have  this  device file, you may create it either by executing LSI's "MegaCli" program
       once,   or   by   locating    the    megadev_sas_ioctl    entry    in    /proc/devices    and    creating
       /dev/megaraid_sas_ioctl_node as a character device with suitable permissions with a matching major device
       number and a minor number of 0.

                                                  03 March 2024                                    megasasctl(1)