#!/bin/bash
#
# Calomel.org
#     https://calomel.org/megacli_lsi_commands.html
#     LSI MegaRaid CLI
#     lsi.sh @ Version 0.05
#
# description: MegaCLI script to configure and monitor LSI raid cards.

# Full path to the MegaRaid CLI binary
MegaCli=”/usr/local/sbin/MegaCli64″

# The identifying number of the enclosure. Default for our systems is “8”. Use
# “MegaCli64 -PDlist -a0 | grep “Enclosure Device”” to see what your number
# is and set this variable.
ENCLOSURE=”8″

if [ $# -eq 0 ]
   then
    echo “”
    echo ”            OBPG  .:.  lsi.sh $arg1 $arg2″
    echo “—————————————————–“
    echo “status        = Status of Virtual drives (volumes)”
    echo “drives        = Status of hard drives”
    echo “ident \$slot   = Blink light on drive (need slot number)”
    echo “good \$slot    = Simply makes the slot \”Unconfigured(good)\” (need slot number)”
    echo “replace \$slot = Replace \”Unconfigured(bad)\” drive (need slot number)”
    echo “progress      = Status of drive rebuild”
    echo “errors        = Show drive errors which are non-zero”
    echo “bat           = Battery health and capacity”
    echo “batrelearn    = Force BBU re-learn cycle”
    echo “logs          = Print card logs”
    echo “checkNemail   = Check volume(s) and send email on raid errors”
    echo “allinfo       = Print out all settings and information about the card”
    echo “settime       = Set the raid card’s time to the current system time”
    echo “setdefaults   = Set preferred default settings for new raid setup”
    echo “”
   exit
 fi

# General status of all RAID virtual disks or volumes and if PATROL disk check
# is running.
if [ $1 = “status” ]
   then
      $MegaCli -LDInfo -Lall -aALL -NoLog
      echo “###############################################”
      $MegaCli -AdpPR -Info -aALL -NoLog
      echo “###############################################”
      $MegaCli -LDCC -ShowProg -LALL -aALL -NoLog
   exit
fi

# Shows the state of all drives and if they are online, unconfigured or missing.
if [ $1 = “drives” ]
   then
      $MegaCli -PDlist -aALL -NoLog | egrep ‘Slot|state’ | awk ‘/Slot/{if (x)print x;x=””;}{x=(!x)?$0:x” -“$0;}END{print x;}’ | sed ‘s/Firmware state://g’
   exit
fi

# Use to blink the light on the slot in question. Hit enter again to turn the blinking light off.
if [ $1 = “ident” ]
   then
      $MegaCli  -PdLocate -start -physdrv[$ENCLOSURE:$2] -a0 -NoLog
      logger “hostname – identifying enclosure $ENCLOSURE, drive $2 “
      read -p “Press [Enter] key to turn off light…”
      $MegaCli  -PdLocate -stop -physdrv[$ENCLOSURE:$2] -a0 -NoLog
   exit
fi

# When a new drive is inserted it might have old RAID headers on it. This
# method simply removes old RAID configs from the drive in the slot and make
# the drive “good.” Basically, Unconfigured(bad) to Unconfigured(good). We use
# this method on our FreeBSD ZFS machines before the drive is added back into
# the zfs pool.
if [ $1 = “good” ]
   then
      # set Unconfigured(bad) to Unconfigured(good)
      $MegaCli -PDMakeGood -PhysDrv[$ENCLOSURE:$2] -a0 -NoLog
      # clear ‘Foreign’ flag or invalid raid header on replacement drive
      $MegaCli -CfgForeign -Clear -aALL -NoLog
   exit
fi

# Use to diagnose bad drives. When no errors are shown only the slot numbers
# will print out. If a drive(s) has an error you will see the number of errors
# under the slot number. At this point you can decided to replace the flaky
# drive. Bad drives might not fail right away and will slow down your raid with
# read/write retries or corrupt data.
if [ $1 = “errors” ]
   then
      echo “Slot Number: 0”; $MegaCli -PDlist -aALL -NoLog | egrep -i ‘error|fail|slot’ | egrep -v ‘0’
   exit
fi

# status of the battery and the amount of charge. Without a working Battery
# Backup Unit (BBU) most of the LSI read/write caching will be disabled
# automatically. You want caching for speed so make sure the battery is ok.
if [ $1 = “bat” ]
   then
      $MegaCli -AdpBbuCmd -aAll -NoLog
   exit
fi

# Force a Battery Backup Unit (BBU) re-learn cycle. This will discharge the
# lithium BBU unit and recharge it. This check might take a few hours and you
# will want to always run this in off hours. LSI suggests a battery relearn
# monthly or so. We actually run it every three(3) months by way of a cron job.
# Understand if your “Current Cache Policy” is set to “No Write Cache if Bad
# BBU” then write-cache will be disabled during this check. This means writes
# to the raid will be VERY slow at about 1/10th normal speed. NOTE: if the
# battery is new (new bats should charge for a few hours before they register)
# or if the BBU comes up and says it has no charge try powering off the machine
# and restart it. This will force the LSI card to re-evaluate the BBU. Silly
# but it works.
if [ $1 = “batrelearn” ]
   then
      $MegaCli -AdpBbuCmd -BbuLearn -aALL -NoLog
   exit
fi

# Use to replace a drive. You need the slot number and may want to use the
# “drives” method to show which drive in a slot is “Unconfigured(bad)”. Once
# the new drive is in the slot and spun up this method will bring the drive
# online, clear any foreign raid headers from the replacement drive and set the
# drive as a hot spare. We will also tell the card to start rebuilding if it
# does not start automatically. The raid should start rebuilding right away
# either way. NOTE: if you pass a slot number which is already part of the raid
# by mistake the LSI raid card is smart enough to just error out and _NOT_
# destroy the raid drive, thankfully.
if [ $1 = “replace” ]
   then
      logger “hostname – REPLACE enclosure $ENCLOSURE, drive $2 “
      # set Unconfigured(bad) to Unconfigured(good)
      $MegaCli -PDMakeGood -PhysDrv[$ENCLOSURE:$2] -a0 -NoLog
      # clear ‘Foreign’ flag or invalid raid header on replacement drive
      $MegaCli -CfgForeign -Clear -aALL -NoLog
      # set drive as hot spare
      $MegaCli -PDHSP -Set -PhysDrv [$ENCLOSURE:$2] -a0 -NoLog
      # show rebuild progress on replacement drive just to make sure it starts
      $MegaCli -PDRbld -ShowProg -PhysDrv [$ENCLOSURE:$2] -a0 -NoLog
   exit
fi

# Print all the logs from the LSI raid card. You can grep on the output.
if [ $1 = “logs” ]
   then
      $MegaCli -FwTermLog -Dsply -aALL -NoLog
   exit
fi

# Use to query the RAID card and find the drive which is rebuilding. The script
# will then query the rebuilding drive to see what percentage it is rebuilt and
# how much time it has taken so far. You can then guess-ti-mate the
# completion time.
if [ $1 = “progress” ]
   then
      DRIVE=$MegaCli -PDlist -aALL -NoLog | egrep 'Slot|state' | awk '/Slot/{if (x)print x;x="";}{x=(!x)?$0:x" -"$0;}END{print x;}' | sed 's/Firmware state://g' | egrep build | awk '{print $3}'
      $MegaCli -PDRbld -ShowProg -PhysDrv [$ENCLOSURE:$DRIVE] -a0 -NoLog
   exit
fi

# Use to check the status of the raid. If the raid is degraded or faulty the
# script will send email to the address in the $EMAIL variable. We normally add
# this method to a cron job to be run every few hours so we are notified of any
# issues.
if [ $1 = “checkNemail” ]
   then
      EMAIL=”raidadmin@localhost“

      # Check if raid is in good condition
      STATUS=$MegaCli -LDInfo -Lall -aALL -NoLog | egrep -i 'fail|degrad|error'

      # On bad raid status send email with basic drive information
      if [ “$STATUS” ]; then
         $MegaCli -PDlist -aALL -NoLog | egrep ‘Slot|state’ | awk ‘/Slot/{if (x)print x;x=””;}{x=(!x)?$0:x” -“$0;}END{print x;}’ | sed ‘s/Firmware state://g’ | mail -s hostname‘ – RAID Notification’ $EMAIL
      fi
fi

# Use to print all information about the LSI raid card. Check default options,
# firmware version (FW Package Build), battery back-up unit presence, installed
# cache memory and the capabilities of the adapter. Pipe to grep to find the
# term you need.
if [ $1 = “allinfo” ]
   then
      $MegaCli -AdpAllInfo -aAll -NoLog
   exit
fi

# Update the LSI card’s time with the current operating system time. You may
# want to setup a cron job to call this method once a day or whenever you
# think the raid card’s time might drift too much.
if [ $1 = “settime” ]
   then
      $MegaCli -AdpGetTime -aALL -NoLog
      $MegaCli -AdpSetTime date +%Y%m%d date +%H:%M:%S -aALL -NoLog
      $MegaCli -AdpGetTime -aALL -NoLog
   exit
fi

# These are the defaults we like to use on the hundreds of raids we manage. You
# will want to go through each option here and make sure you want to use them
# too. These options are for speed optimization, build rate tweaks and PATROL
# options. When setting up a new machine we simply execute the “setdefaults”
# method and the raid is configured. You can use this on live raids too.
if [ $1 = “setdefaults” ]
   then
      # Read Cache enabled specifies that all reads are buffered in cache memory.
       $MegaCli -LDSetProp -Cached -LAll -aAll -NoLog
      # Adaptive Read-Ahead if the controller receives several requests to sequential sectors
       $MegaCli -LDSetProp ADRA -LALL -aALL -NoLog
      # Hard Disk cache policy enabled allowing the drive to use internal caching too
       $MegaCli -LDSetProp EnDskCache -LAll -aAll -NoLog
      # Write-Back cache enabled
       $MegaCli -LDSetProp WB -LALL -aALL -NoLog
      # Continue booting with data stuck in cache. Set Boot with Pinned Cache Enabled.
       $MegaCli -AdpSetProp -BootWithPinnedCache -1 -aALL -NoLog
      # PATROL run every 672 hours or monthly (RAID6 77TB @60% rebuild takes 21 hours)
       $MegaCli -AdpPR -SetDelay 672 -aALL -NoLog
      # Check Consistency every 672 hours or monthly
       $MegaCli -AdpCcSched -SetDelay 672 -aALL -NoLog
      # Enable autobuild when a new Unconfigured(good) drive is inserted or set to hot spare
       $MegaCli -AdpAutoRbld -Enbl -a0 -NoLog
      # RAID rebuild rate to 60% (build quick before another failure)
       $MegaCli -AdpSetProp \{RebuildRate -60\} -aALL -NoLog
      # RAID check consistency rate to 60% (fast parity checks)
       $MegaCli -AdpSetProp \{CCRate -60\} -aALL -NoLog
      # Sound alarm disabled (server room too loud anyways)
       $MegaCli -AdpSetProp AlarmDsbl -aALL -NoLog
      # Use write-back cache mode even if BBU is bad. Make sure your machine is on UPS too.
       $MegaCli -LDSetProp CachedBadBBU -LAll -aAll -NoLog
      # Disable auto learn BBU check which can severely affect raid speeds
       OUTBBU=$(mktemp /tmp/output.XXXXXXXXXX)
       echo “autoLearnMode=1” > $OUTBBU
       $MegaCli -AdpBbuCmd -SetBbuProperties -f $OUTBBU -a0 -NoLog
       rm -rf $OUTBBU
   exit
fi

### EOF ###

[root@nas ~]# /shell/lsi_sas_monitoring.sh drives                           
Slot Number: 0 – Online, Spun Up
Slot Number: 1 – Online, Spun Up
Slot Number: 2 – Online, Spun Up
Slot Number: 3 – Unconfigured(bad)
Slot Number: 4 – Online, Spun Up
Slot Number: 5 – Online, Spun Up
Slot Number: 6 – Online, Spun Up
Slot Number: 7 – Online, Spun Up
Slot Number: 8 – Online, Spun Up
Slot Number: 9 – Online, Spun Up
Slot Number: 10 – Online, Spun Up
Slot Number: 11 – Online, Spun Up
Slot Number: 12 – Online, Spun Up