Manual LSI / Broadcom MegaRAID — MegaCli y StorCLI

Documentación consolidada de comandos y procedimientos para controladoras RAID LSI/Broadcom/Dell PERC (MegaRAID SAS), cubriendo las dos herramientas de línea de comandos: MegaCli (legacy) y StorCLI (actual, recomendada por Broadcom para controladoras SAS-3 en adelante, como la PERC H730P).

Basado en problemas reales ya resueltos en producción (Dell PowerEdge, IBM x3650 M4, controladoras LSI 1068E, 2108, 3108).

Índice

1. Compatibilidad y Requisitos

2. Descarga e Instalación

3. Identificación de la Controladora

4. MegaCli — Comandos de Consulta

5. MegaCli — Gestión de Discos Físicos

6. MegaCli — Creación de RAID

7. MegaCli — Hot Spare, Rebuild y Configuraciones Extranjeras

8. MegaCli — Patrol Read y Consistency Check

9. MegaCli — BBU (Battery Backup Unit)

10. Escenario Real: Sin Backplane (No Backplane Scenario)

11. Escenario Real: Conversión IBM x3650 M4 — JBOD a RAID

12. StorCLI — Cheat Sheet Completo

13. StorCLI — Creación de Volúmenes (Sintaxis Correcta y Flags de Caché)

14. StorCLI — CacheCade / SSD Caching

15. Troubleshooting / Problemas Conocidos

16. Tabla de Referencia Rápida de Estado

17. Buenas Prácticas Operacionales

1. Compatibilidad y Requisitos

# Oracle Linux 8.9 / RHEL 8.x
dnf install ncurses-compat-libs -y

Nota: MegaCli fue descontinuado por Broadcom en favor de StorCLI. En controladoras nuevas (3108 en adelante), prefiera StorCLI siempre que sea posible — la sintaxis es más consistente y el soporte para CacheCade, SED (Self-Encrypting Drives) y telemetría es más completo.

2. Descarga e Instalación

MegaCli

# Pacote com vários binários (todas as versões/plataformas)
wget https://docs.broadcom.com/docs-and-downloads/raid-controllers/raid-controllers-common-files/8-07-14_MegaCLI.zip

# RPM direto (mirror próprio)
wget https://nextcloud.wedson.com.br/s/5FL5CFe2PqDG9ax/download/MegaCli-8.07.14-1.noarch.rpm --no-check-certificate

# Instalação
rpm -Uvh MegaCli-8.07.14-1.noarch.rpm

StorCLI

wget https://downloads.hpe.com/pub/softlib2/software1/pubsw-linux/p1544409578/v233762/storcli-007.2613.0000.0000-1.noarch.rpm
rpm -Uvh storcli-007.2613.0000.0000-1.noarch.rpm

La ruta oficial de instalación de StorCLI en Linux varía según la fuente: puede instalarse en /opt/MegaRAID/storcli/storcli64 (Dell/MegaRAID) o en /opt/lsi/storcli/storcli (paquete Broadcom genérico). Siempre confirme con find / -iname "storcli*" 2>/dev/null después de la instalación.

Alias permanentes

vim ~/.bash_profile

Agregar:

alias megacli='/opt/MegaRAID/MegaCli/MegaCli64'
alias storcli='/opt/MegaRAID/storcli/storcli64'

Recargar:

source ~/.bash_profile

En sesiones no interactivas (scripts/cron), use la ruta completa en lugar de depender del alias — los alias no se expanden por defecto en shells no interactivos.

3. Identificación de la Controladora

# Via lspci, filtrando por fabricante/classe
lspci -v | grep -E "RAID|SAS|SCSI|LSI|MegaRAID|PERC"

Ejemplo de salida (controladora antigua):

05:00.0 SCSI storage controller: Broadcom / LSI SAS1068E PCI-Express Fusion-MPT SAS (rev 08)
	Subsystem: Dell SAS 6/iR Adapter RAID Controller

# Via class code 0104 (RAID bus controller) — mais preciso para identificar o chip exato
lspci -d::0104 -m

Ejemplo de salida (controladora moderna):

03:00.0 "RAID bus controller" "Broadcom / LSI" "MegaRAID SAS-3 3108 [Invader]" -r02 "Dell" "PERC H730P Adapter"

Corrección: el filtro correcto de clase PCI para controladoras RAID es 0104, no 104. Use lspci -d::0104 -m (con los dos puntos antes) para filtrar solo dispositivos de la clase "RAID bus controller", reduciendo ruido en servidores con múltiples controladoras SCSI/SAS.

4. MegaCli — Comandos de Consulta

# Informações completas da controladora
megacli -AdpAllInfo -aall

# Todos os volumes lógicos (Virtual Drives)
megacli -LDInfo -Lall -aall

# Todos os discos físicos
megacli -PDList -aall

# Tipo de disco (SAS/SATA/SSD)
megacli -PDList -aall | grep -i "PD Type:"

# Dados de identificação (modelo, fabricante, firmware, serial)
megacli -PDList -aall | grep -i "Inquiry Data:"

# Tamanho bruto do disco
megacli -PDList -aall | grep -i "Raw Size:"

# Tamanho "coerced"/forçado (capacidade utilizável após normalização)
megacli -PDList -aall | grep -i "Coerced Size:"

# Velocidade do dispositivo (negociada)
megacli -PDList -aall | grep -i "Device Speed:"

# Velocidade do link (capacidade da controladora/porta)
megacli -PDList -aall | grep -i "Link Speed:"

# Temperatura do disco
megacli -PDList -aall | grep -i "Drive Temperature"

# Enclosure ID dos discos
megacli -PDList -aall | grep -i "Enclosure Device ID:"

# Enclosure + Slot
megacli -PDList -aall | grep -E "Enclosure Device ID:|Slot Number:"

# Enclosure + Slot + Modelo do disco
megacli -PDList -aall | grep -E "Enclosure Device ID:|Slot Number:|Inquiry Data:"

# Informações do(s) enclosure(s)
megacli -EncInfo -aALL

# Status de firmware de todos os discos (visão geral rápida de saúde do array)
megacli -PDList -aAll | grep "Firmware state"

Corrección: en el documento original aparecía "Non Coerced Size" — el atributo correcto devuelto por MegaCli es Coerced Size: (tamaño después de normalización/coerción para fines de emparejamiento de discos en el array). También existe Non Coerced Size: en algunas versiones, que es el tamaño real sin ajuste — ambos pueden ser útiles según el diagnóstico, pero es importante no confundir uno con el otro al planificar la sustitución de disco.

5. MegaCli — Gestión de Discos Físicos

# Ejetar disco do SO Linux (antes de remoção fisica seguro / hot-remove)
echo 1 | sudo tee /sys/block/sdb/device/delete

# Criar disco JBOD (apresentar disco bruto sem RAID)
megacli -PDMakeJBOD -PhysDrv[32:9] -a0

# Marcar disco(s) como "Unconfigured Good" — necessário antes de criar array em discos JBOD/Foreign
megacli -PDMakeGood -PhysDrv[62:0] -a0
megacli -PDMakeGood -PhysDrv[62:1] -force -a0   # -force ignora avisos de dados existentes — USE COM CUIDADO

# Marcar disco como offline
megacli -PDOffline -PhysDrv[32:5] -a0

# Marcar disco como online (após reconexão, se aplicável)
megacli -PDOnline -PhysDrv[32:5] -a0

# Localizar fisicamente o disco (acende o LED da baía)
megacli -PdLocate -start -physdrv[32:5] -a0
megacli -PdLocate -stop  -physdrv[32:5] -a0

# Apagar dados de segurança / preparar disco para reuso completo (SECURE ERASE — IRREVERSÍVEL)
megacli -PDInstantSecureErase -PhysDrv[32:5] -a0

⚠️ -PDInstantSecureErase borra todos los datos del disco de forma irreversible. Úselo solo en descomisionamiento o eliminación segura, nunca en discos en producción.

6. MegaCli — Creación de RAID

Antes de cualquier creación de array, siempre confirme Enclosure ID y Slot Number con:

megacli -PDList -aall | grep -E "Enclosure Device ID:|Slot Number:"

RAID 0

# E = Enclosure, S = Slot
megacli -CfgLdAdd -r0 [E:S] -a0

# Exemplo
megacli -CfgLdAdd -r0 [69:2,69:3] -a0

RAID 1

megacli -CfgLdAdd -r1 [E:S] -a0

# Exemplo
megacli -CfgLdAdd -r1 [69:2,69:3] -a0

RAID 5

# Necessário no mínimo 3 discos
megacli -CfgLdAdd -r5 [E:S,E:S,E:S] WB ADRA -a0

# Exemplo
megacli -CfgLdAdd -r5 [32:0,32:1,32:2] WB ADRA -a0

RAID 10

# Pares de E:S — striping sobre mirrors
megacli -CfgLdAdd -r10 [E:S,E:S,E:S,E:S] WB ADRA -a0

# Exemplo (4 discos: 2 pares espelhados em stripe)
megacli -CfgLdAdd -r10 [69:0,69:1,69:2,69:3] WB ADRA -a0

Nota sobre WB y ADRA: WB = WriteBack (caché de escritura habilitado — mejor rendimiento, requiere BBU/supercapacitor saludable para ser seguro). ADRA no es un parámetro oficial documentado de MegaCli — el término correcto para read-ahead automático es ADRA solo en algunos builds; el parámetro predeterminado y ampliamente documentado es RA (Read Ahead) o NORA (No Read Ahead). Si el comando ADRA es rechazado por su versión de MegaCli, sustitúyalo por RA:

megacli -CfgLdAdd -r5 [32:0,32:1,32:2] WB RA -a0

Disco "pass-through" (Non-RAID / presentar disco sin RAID)

megacli -CfgLdAdd -r0[<Adapter>:<DiskID>] Direct -a0

# Exemplo
megacli -CfgLdAdd -r0[32:6] Direct -a0

Flujo completo para presentar un disco "puro" al SO:

# 1. Identificar o disco
megacli -PDList -aALL

# 2. Criar virtual drive pass-through (RAID0 single-disk, Direct I/O)
megacli -CfgLdAdd -r0[32:6] Direct -a0

# 3. Confirmar criação
megacli -LDInfo -Lall -aALL

# 4. Particionar e formatar no Linux
fdisk /dev/sdX        # ou parted
mkfs.ext4 /dev/sdX1   # ou xfs, conforme necessidade

Renombrar Virtual Drive (VD)

# 1. Confirmar o número lógico do VD antes de renomear
megacli -LDInfo -Lall -aall

# 2. Renomear
megacli -LDSetProp -Name 'backup' -L1 -a0

Eliminar Virtual Drive

megacli -CfgLdDel -L0 -a0   # apaga VD/Logical Drive 0
megacli -CfgLdDel -L1 -a0   # apaga VD/Logical Drive 1

⚠️ CfgLdDel borra todos los datos del volumen lógico. Siempre tenga un backup confirmado antes.

7. MegaCli — Hot Spare, Rebuild y Configuraciones Extranjeras

Hot Spare

# Hot spare dedicado a um array específico
megacli -PDHSP -Set -Dedicated -Array0 -PhysDrv[32:8] -a0

# Hot spare global (serve qualquer array da controladora)
megacli -PDHSP -Set -PhysDrv[32:8] -a0

# Remover hot spare
megacli -PDHSP -Rmv -PhysDrv[32:8] -a0

Monitorear Rebuild

# Visão geral de status de firmware (identifica qual disco está em "Rebuild")
megacli -PDList -aAll | grep "Firmware state"

# Progresso detalhado de rebuild de um disco específico
megacli -PDRbld -ShowProg -PhysDrv [32:5] -aAll

Ejemplo de salida:

Rebuild Progress on Device at Enclosure 32, Slot 5 Completed 62% in 234 Minutes.
Exit Code: 0x00

Consejo operativo: ejecute el comando de progreso en bucle (watch -n 60 "megacli -PDRbld -ShowProg -PhysDrv [32:5] -aAll") para seguimiento sin tener que repetir manualmente.

Configuraciones Extranjeras (Foreign Configuration)

Ocurre cuando se detectan discos con configuración RAID previa (de otra controladora o tras reinserción).

# Listar configurações estrangeiras detectadas
megacli -CfgForeign -Scan -aAll

# Importar a configuração estrangeira (mantém os dados e o array original)
megacli -CfgForeign -Import -aAll

# Limpar (descartar) configurações estrangeiras — APAGA o metadado RAID do disco
megacli -CfgForeign -Clear -aAll

⚠️ -Clear no borra los datos en sí, pero elimina el metadato RAID — sin él, la controladora ya no reconoce el array antiguo. Use Import cuando desee recuperar datos; use Clear solo cuando esté seguro de que va a reconfigurar el disco desde cero.

8. MegaCli — Patrol Read y Consistency Check

Comandos no presentes en el documento original, pero esenciales para el mantenimiento preventivo de la salud de los discos.

# Ver configuração atual do Patrol Read
megacli -AdpPR -Info -aALL

# Habilitar Patrol Read automático
megacli -AdpPR -EnblAuto -aALL

# Iniciar Patrol Read manualmente
megacli -AdpPR -Start -aALL

# Parar Patrol Read em andamento
megacli -AdpPR -Stop -aALL

# Consistency Check — verificar paridade do array (RAID 5/6/10)
megacli -LDCC -Start -LAll -aALL
megacli -LDCC -ShowProg -LAll -aALL
megacli -LDCC -Stop -LAll -aALL

# Agendar Consistency Check automático
megacli -AdpCcSched -SetConfig -enable -aALL

Patrol Read verifica proactivamente errores de medios en todos los discos (incluso los no utilizados en arrays). Consistency Check verifica si los datos de paridad calculados coinciden con los datos reales — esencial para RAID 5/6/10 antes de que una falla real de disco exponga inconsistencia. Se recomienda programar ambos mensualmente en horarios de baja carga.

9. MegaCli — BBU (Battery Backup Unit)

Crítico para entornos con caché WriteBack habilitado — sin BBU saludable, el controlador normalmente revierte automáticamente a WriteThrough (más lento, pero seguro contra pérdida de energía).

# Status completo da BBU
megacli -AdpBbuCmd -GetBbuStatus -aALL

# Informações de capacidade/design
megacli -AdpBbuCmd -GetBbuCapacityInfo -aALL

# Iniciar ciclo de aprendizado (recalibração) da bateria
megacli -AdpBbuCmd -BbuLearn -aALL

El ciclo de Learn descarga y recarga completamente la batería para recalibrar la estimación de carga — durante ese proceso el controlador normalmente deshabilita temporalmente el WriteBack. Planifíquelo para ventanas de mantenimiento, ya que el rendimiento de escritura puede caer durante el ciclo.

10. Escenario Real: Sin Backplane (No Backplane Scenario)

En discos conectados directamente (sin backplane/enclosure — común en SSDs SATA conectados directamente a la controladora), el Enclosure Device ID aparece como N/A. En esos casos, omita el enclosure en la sintaxis [E:S], usando solo [:S].

megacli -PDList -aall | grep -E "Enclosure Device ID:|Slot Number:|Inquiry Data:"

Ejemplo de salida real (srvoracle-stb):

Enclosure Device ID: 32
Slot Number: 3
Inquiry Data: B9KWJTNF    Hitachi HUA722020ALA331    JKAOA3FD

Enclosure Device ID: N/A
Slot Number: 0
Inquiry Data: YS202010011025AA    SSD 1TB    FW210415

# Progresso de rebuild quando não há enclosure (note o espaço antes dos dois-pontos)
megacli -PDRbld -ShowProg -PhysDrv [:2] -aALL

Salida:

Rebuild Progress on Device at Enclosure N/A, Slot 2 Completed 75% in 1072 Minutes.
Exit Code: 0x00

Atención al tiempo de rebuild en este caso real: 1074 minutos (~17,9 horas) detenido en 75% indica posible degradación severa de rendimiento (discos antiguos Hitachi 2TB SATA, posiblemente con sectores reasignados) o alta carga de I/O concurrente durante el rebuild. Cuando el rebuild se bloquea en un porcentaje por mucho tiempo sin progreso visible entre comprobaciones, verifique:

• Errores de medio en el disco (megacli -PDList -aall | grep -i "Media Error")

• Carga de I/O de la aplicación durante el rebuild (el rebuild compite por IOPS con producción)

• Tasa de rebuild configurada en la controladora (megacli -AdpSetProp RebuildRate -aALL)

11. Escenario Real: Conversión IBM x3650 M4 — JBOD a RAID

Procedimiento documentado para convertir discos JBOD en discos elegibles para array RAID, y luego crear dos arrays RAID 10 a partir de 8 discos.

# Passo 1: Converter cada disco JBOD para "Unconfigured Good" (necessário antes de qualquer array)
megacli -PDMakeGood -PhysDrv[62:0] -force -a0
megacli -PDMakeGood -PhysDrv[62:1] -force -a0
megacli -PDMakeGood -PhysDrv[62:2] -force -a0
megacli -PDMakeGood -PhysDrv[62:3] -force -a0
megacli -PDMakeGood -PhysDrv[62:4] -force -a0
megacli -PDMakeGood -PhysDrv[62:5] -force -a0
megacli -PDMakeGood -PhysDrv[62:6] -force -a0
megacli -PDMakeGood -PhysDrv[62:7] -force -a0

# Passo 2: Criar dois arrays RAID 10 via CfgSpanAdd
# (cada par é um mirror, e os mirrors são combinados em stripe)
megacli -CfgSpanAdd -r10 -Array0[62:0,62:1] -Array1[62:2,62:3] WT RA Direct -a0
megacli -CfgSpanAdd -r10 -Array0[62:4,62:5] -Array1[62:6,62:7] WT RA Direct -a0

⚠️ -force en PDMakeGood ignora avisos de existencia de configuración o datos previos en el disco — confirme que no hay datos relevantes antes de usarlo. Este procedimiento es destructivo para cualquier contenido anterior de los discos JBOD.

Note que aquí se utilizó WT (WriteThrough) en lugar de WB — elección deliberada de seguridad en entorno sin BBU confirmada, ya que WriteThrough escribe directamente en disco sin depender de caché volátil.

12. StorCLI — Cheat Sheet Completo

En StorCLI, la ruta del binario en Linux es típicamente /opt/MegaRAID/storcli/storcli64 (Dell) o /opt/lsi/storcli/storcli (Broadcom genérico) — confirme cuál existe en su sistema. Los ejemplos a continuación usan storcli64, pero la sintaxis es idéntica para storcli.

General

storcli64 -v                  # Versão da ferramenta
storcli64 show                # Lista controladoras disponíveis
storcli64 show all            # Detalhes de todas as controladoras
storcli64 /c0 show            # Status resumido da controladora 0
storcli64 /c0 show all        # Detalhes completos da controladora 0
storcli64 /c0 show events     # Log de eventos
storcli64 /c0 show termlog    # Log de terminal (eventos recentes)
storcli64 /c0 show alarms     # Status de alarme físico (buzzer)
storcli64 /c0 show help       # Ajuda contextual de comandos

Virtual Drives (Volumes RAID)

storcli64 /c0/vall show           # Todos os VDs da controladora 0
storcli64 /c0/v0 show             # Detalhes do VD 0
storcli64 /c0/v0 show all         # Detalhes completos (inclui propriedades de cache)
storcli64 /c0/v0 delete           # Remove o VD 0 (sem force = falha se houver dados/MBR)
storcli64 /c0/v0 delete force     # Remove o VD 0 mesmo com dados existentes — IRREVERSÍVEL
storcli64 /c0/v0 set wb           # Habilita WriteBack no VD 0
storcli64 /c0/v0 set wt           # Habilita WriteThrough no VD 0
storcli64 /c0/v0 set rdcache=ra   # Habilita Read Ahead
storcli64 /c0/v0 set rdcache=nora # Desabilita Read Ahead
storcli64 /c0/v0 set name=backup  # Renomeia o VD 0
storcli64 /c0/v0 start init       # Inicializa (zera) o VD — apaga dados
storcli64 /c0/v0 show init        # Mostra progresso de inicialização
storcli64 /c0/v0 start cc         # Inicia Consistency Check no VD 0
storcli64 /c0/v0 show cc          # Mostra progresso de Consistency Check
storcli64 /c0/v0 show bgi         # Mostra progresso de Background Initialization
storcli64 /c0/v0 show migrate     # Mostra progresso de migração de RAID level/expansão

Physical Drives

storcli64 /c0/pall show              # Todos os discos físicos
storcli64 /c0/eall/sall show all     # Detalhes completos via enclosure/slot
storcli64 /c0/e32/s5 show            # Detalhes do disco no enclosure 32, slot 5
storcli64 /c0/e32/s5 set good        # Marca disco como Unconfigured Good
storcli64 /c0/e32/s5 set offline     # Marca disco como offline
storcli64 /c0/e32/s5 set missing     # Marca disco como missing
storcli64 /c0/e32/s5 start locate    # Acende LED de localização
storcli64 /c0/e32/s5 stop locate     # Apaga LED de localização
storcli64 /c0/e32/s5 show all        # SMART, temperatura, contadores de erro de mídia

Hot Spares

storcli64 /c0/e32/s3 add hotsparedrive             # Hot spare global
storcli64 /c0/e32/s3 add hotsparedrive dgs=0       # Hot spare dedicado ao Drive Group 0
storcli64 /c0/e32/s3 delete hotsparedrive          # Remove hot spare

Foreign Configuration

storcli64 /c0/fall show       # Lista configurações estrangeiras
storcli64 /c0/fall import     # Importa todas
storcli64 /c0/fall delete     # Descarta todas (apaga metadado, não os dados)

Battery Backup Unit (BBU)

storcli64 /c0/bbu show all      # Status completo da bateria
storcli64 /c0/bbu show events   # Eventos relacionados à BBU
storcli64 /c0/bbu start learn   # Ciclo de aprendizado/recalibração

Caché Global de la Controladora

storcli64 /c0 show preservedcache         # Verifica se há cache preservado (write-pending órfão)
storcli64 /c0 delete preservedcache       # Descarta cache preservado órfão — risco de perda de dados não comitados
storcli64 /c0 set cacheflushint=10        # Intervalo de flush de cache em segundos
storcli64 /c0 show cacheflushint          # Mostra intervalo configurado

Consistency Check Programado (Global)

storcli64 /c0 set cc=conc delay=168 starttime=2026/07/01 00
storcli64 /c0 show cc

Firmware

storcli64 /c0 download file=firmware.rom   # Atualiza firmware da controladora
storcli64 /c0/fwbackup file=backup.rom     # Backup do firmware atual
storcli64 /c0/fwpkg show                   # Informações do pacote de firmware

Configuración Detallada

storcli64 /c0/cfgdsply        # Exibe configuração detalhada
storcli64 /c0/cfgdsply full   # Exibe configuração RAID completa (todos os DGs/VDs/PDs)

13. StorCLI — Creación de Volúmenes (Sintaxis Correcta y Flags de Caché)

Corrección importante en relación al documento original: la sintaxis storcli64 /c0 add vd r0 drives=0:0,0:1 funciona en algunas versiones más antiguas, pero la sintaxis oficial y recomendada por Broadcom, válida en todas las versiones actuales, es:

storcli64 /cX add vd type=raidN drives=<EID>:<Slot> [flags de caché] [name=NOMBRE]

Sintaxis general

storcli64 /c0 add vd type=raid[0|1|5|6|10|50|60] \
  drives=<EID>:<Slot>[,<EID>:<Slot>...] \
  [WT|WB|AWB] [ra|nora] [direct|cached] [pdcache=on|off|default] \
  [name=<NOME>] [Strip=<8|16|32|64|128|256|512|1024>]

Ejemplos prácticos

# RAID 0, dois discos, WriteBack + Read Ahead, I/O direto
storcli64 /c0 add vd type=raid0 drives=69:2,69:3 wb ra direct

# RAID 1
storcli64 /c0 add vd type=raid1 drives=69:2,69:3 wb ra direct

# RAID 5, três discos, com nome customizado
storcli64 /c0 add vd type=raid5 drives=32:0,32:1,32:2 wb ra direct name=dados01

# RAID 10, quatro discos
storcli64 /c0 add vd type=raid10 drives=69:0,69:1,69:2,69:3 wb ra direct

# RAID 10 com 12 discos e 2 discos por array (sintaxe de range)
storcli64 /c0 add vd type=raid10 drives=7:0-11 pdperarray=2 wt cached

# Disco "pass-through" (apresentar disco bruto ao SO) com pdcache desabilitado
# — recomendado para SSDs sem capacitor de energia em uso single-disk
storcli64 /c0 add vd type=raid0 drives=6:2 direct wb ra pdcache=off

Sobre pdcache=off en discos individuales: cuando un disco SATA no posee capacitor de energía (power-loss protection) propio, su caché de escritura interno puede perder datos no confirmados ante una caída de energía, incluso con la BBU de la controladora saludable — porque la BBU protege el caché de la controladora, no el caché interno del disco. Por eso, en implementaciones más conservadoras, es común deshabilitar pdcache por disco.

Eliminar Virtual Drive

storcli64 /c0/v0 delete          # falha se houver MBR/dados
storcli64 /c0/v0 delete force    # força remoção mesmo com dados — IRREVERSÍVEL
storcli64 /c0/vall delete        # remove todos os VDs da controladora — EXTREMAMENTE DESTRUTIVO

14. StorCLI — CacheCade / SSD Caching

CacheCade usa un SSD (o pool de SSDs) como capa de caché de lectura/escritura acelerando discos mecánicos. Útil en servidores con discos SATA/SAS convencionales y al menos un SSD disponible.

# 1. Criar a VD de CacheCade (RAID0 sobre o SSD dedicado a cache)
storcli64 /c0 add vd cachecade r0 drives=252:0 WB

# 2. Verificar o VD ID criado para o CacheCade
storcli64 /c0/vall show

# 3. Associar/habilitar o caching no VD de dados que vai se beneficiar do cache
storcli64 /c0/v0 set ssdcaching=on

# 4. Confirmar (coluna "Cac" deve indicar "ON")
storcli64 /c0/vall show

# Remover associação de CacheCade de um VD específico
storcli64 /c0/v0 del cachecade

# Remover o CacheCade por completo
storcli64 /c0/v1 del cachecade

⚠️ Atención al usar RAID0 single-disk para CacheCade en modo WriteBack: sin redundancia, la falla del SSD de caché puede llevar a la pérdida de los datos de escritura aún no confirmados al disco mecánico de origen. Use RAID0 + WB solo si el servidor es tolerante a ese riesgo (ej.: proxy caché, datos no críticos) o, idealmente, use 2+ SSDs en RAID1 para el CacheCade cuando el caso de uso exija confiabilidad.

Lectura de la columna Cache en show: NRWBD = No Read Ahead + WriteBack + Direct I/O. RAWBD = Read Ahead + WriteBack + Direct.

15. Troubleshooting / Problemas Conocidos

"controller has data in cache for offline or missing virtual disks"

Ocurre cuando un disco fue removido sin el procedimiento correcto y la controladora aún mantiene datos de escritura no confirmados (preserved cache) referentes a un VD ahora ausente/offline. Esto bloquea la creación de nuevos VDs, incluso en discos diferentes.

# Verificar se há cache preservado
storcli64 /c0 show preservedcache

# Descartar o cache preservado (PERDE os dados de escrita não confirmados do VD ausente)
storcli64 /c0 delete preservedcache

En reinicio, este estado también puede aparecer como un mensaje de POST que bloquea el arranque hasta ser resuelto en la BIOS de la controladora (Ctrl+R / tecla de acceso al BIOS RAID) o vía StorCLI antes del próximo arranque.

Rebuild extremadamente lento o detenido en un porcentaje

Verificar:

megacli -AdpSetProp RebuildRate -aALL          # taxa de rebuild configurada (0-100%)
megacli -PDList -aall | grep -i "Media Error"  # erros de mídia no disco em rebuild

Causas comunes: disco de origen con sectores defectuosos, alta carga de I/O concurrente de la aplicación compitiendo con el rebuild, tasa de rebuild configurada demasiado baja para priorizar producción.

Disco aparece como "UBAD" (Unconfigured Bad)

Ocurre cuando un disco anteriormente en uso es removido de forma incorrecta y reconectado — la controladora lo marca como potencialmente inconsistente por seguridad.

# Forçar volta a Unconfigured Good (somente se tiver certeza de que o disco está saudável)
megacli -PDMakeGood -PhysDrv[E:S] -force -a0
# ou em StorCLI
storcli64 /c0/eE/sS set good force

Zumbido/alarma físico de la controladora

megacli -AdpSetProp AlarmDsbl -aALL    # desabilita o alarme sonoro
megacli -AdpSetProp AlarmEnbl -aALL    # reabilita
# StorCLI equivalente
storcli64 /c0 set alarm=off
storcli64 /c0 set alarm=on

16. Tabla de Referencia Rápida de Estado

Firmware State (discos físicos)

VD State / Access (StorCLI)

Cache (columna "Cache" en StorCLI)

17. Buenas Prácticas Operacionales

• Siempre confirmar Enclosure ID y Slot Number antes de cualquier comando destructivo (-PDList/show all) — números equivocados pueden destruir el array incorrecto.

• Backup confirmado antes de cualquier CfgLdDel, delete force, PDMakeGood -force o PDInstantSecureErase.

• Nunca usar WB/AWB sin confirmar que la BBU está saludable (AdpBbuCmd -GetBbuStatus / /c0/bbu show all) — de lo contrario, la pérdida de energía puede corromper datos en tránsito.

• Monitorear Patrol Read y Consistency Check periódicamente; es la única forma de detectar errores de paridad/medios silenciosos antes de que afecten a producción.

• Documentar el mapeo Enclosure:Slot → disco físico → función del VD por servidor — esencial para diagnósticos remotos y traspaso entre equipos.

• Preferir StorCLI a MegaCli en controladoras SAS-3 (3108) o más nuevas — es la herramienta oficialmente mantenida por Broadcom.

• En scripts de automatización, siempre usar la ruta completa del binario en lugar de depender de alias, y capturar el Exit Code devuelto para validar el éxito.

Fuentes y Referencias

• Broadcom — StorCLI Reference Manual (53419-00, Rev. F)

• Dell — Knowledge Base: configuración de VDs con StorCLI y tratamiento de "preserved cache"

• Documentación interna Nyverra — procedimientos de campo (IBM x3650 M4, srvoracle-stb, srvoracle-prod)

• Thomas-Krenn Wiki — StorCLI commands

• Comunidad (gist pjobson) — instalación MegaCli en Linux Mint 22

Documento de referencia interna — Nyverra Tecnologia Ltda. Última revisión: 23/06/2026.