StorCLI - Hoja de referencia completa

StorCLI es la herramienta oficial y moderna para gestionar controladores RAID Broadcom/LSI (también llamados MegaRAID). Esta guía cubre comandos esenciales, sintaxis y casos.

Descarga

Obtener StorCLI 007.2705.0000.0000

Descarga oficial (Broadcom):

https://docs.broadcom.com/docs-and-downloads/007.2705.0000.0000_storcli_rel.zip

Documentación oficial:

https://docs.broadcom.com/docs/1232743397

Nota: Requiere cuenta de Broadcom Support (gratuita). Si no puede acceder, solicítela a su proveedor (Dell, HPE, etc.)

Instalación

Linux (Red Hat/CentOS/Oracle Linux)

# Descargar
wget https://docs.broadcom.com/docs-and-downloads/007.2705.0000.0000_storcli_rel.zip

# Descomprimir release
unzip 007.2705.0000.0000_storcli_rel.zip
cd storcli_rel
unzip Unified_storcli_all_os.zip
cd Unified_storcli_all_os/Linux

# Instalar RPM
rpm -Uvh storcli-007.2705.0000.0000-1.noarch.rpm

# Verificar instalación
/opt/MegaRAID/storcli/storcli64 -v

# Crear alias para facilitar
alias storcli64='/opt/MegaRAID/storcli/storcli64'

# Añadir a .bashrc para persistir
echo "alias storcli64='/opt/MegaRAID/storcli/storcli64'" >> ~/.bashrc

Debian/Ubuntu

cd Unified_storcli_all_os/Ubuntu
dpkg -i storcli_007.2705.0000.0000_all.deb

Windows

cd Unified_storcli_all_os\Windows
storcli64.exe /help

Sintaxis básica

Patrón general:

storcli64 /c{controller} [/e{enclosure} [/s{slot}]] {command} {parameters}

Componentes:

Componente Descripción Ejemplo /c{n} Controlador (0 = primero) /c0 /e{n} ID de enclosure /e252 /s{n} Slot del disco en el enclosure /s0 /v{n} Virtual Drive (array) /v0 all Todos los elementos /c0/e252/s all json Salida en JSON /c0 show json

Ejemplos de sintaxis:

storcli64 /c0 show                           # Información del controlador 0
storcli64 /c0/v0 show                        # Información del VD (virtual drive) 0
storcli64 /c0/e252/s0 show                   # Información del disco en slot 0
storcli64 /c0/e252/s all show                # Todos los discos en el enclosure 252
storcli64 /c0/v all show                     # Todos los arrays

Comandos del controlador

Información general

# Información completa del controlador
storcli64 /c0 show

# Información resumida
storcli64 /c0 show summary

# Estado detallado
storcli64 /c0 show all

# Versión de firmware y estado
storcli64 /c0/bbu show

# Salida en JSON (mejor para parsing)
storcli64 /c0 show json

Configuraciones del controlador

# Ver políticas activas
storcli64 /c0 show ctrlproperty

# Definir tasa de rebuild (10-100%)
storcli64 /c0 set ctrlproperty rebuildrate=30

# Definir tasa de background init
storcli64 /c0 set ctrlproperty bgirate=30

# Intervalo de flush de caché (segundos)
storcli64 /c0 set ctrlproperty cacheflushinterval=4

# Modo de caché (WB = WriteBack, WT = WriteThrough)
storcli64 /c0 set ctrlproperty readpolicy=RA writepolicy=WB

BBU (Battery Backup Unit)

# Estado de la batería
storcli64 /c0/bbu show

# Información detallada
storcli64 /c0/bbu show all

# Ciclo de aprendizaje (Learn Cycle)
storcli64 /c0/bbu start learn

# Ver tiempo restante
storcli64 /c0/bbu show preservecache

Virtual Drives (Arrays RAID)

Listar todos los arrays

# Listar VDs
storcli64 /c0/v all show

# Detallado
storcli64 /c0/v all show all

# En JSON
storcli64 /c0/v all show json

# Resumido
storcli64 /c0/v all show summary

Información específica de un array

# VD 0
storcli64 /c0/v0 show

# Información completa
storcli64 /c0/v0 show all

# Propiedades de caché
storcli64 /c0/v0 show cachecade

# Métricas de rendimiento
storcli64 /c0/v0 show performance

Crear Virtual Drive (Array RAID)

# RAID0 con 3 discos
storcli64 /c0/v add type=raid0 drives=252:0,252:1,252:2

# RAID1 (espejo) - 2 discos
storcli64 /c0/v add type=raid1 drives=252:0,252:1

# RAID5 - 4 discos
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3

# RAID6 - 5 discos (con 2 de paridad)
storcli64 /c0/v add type=raid6 drives=252:0,252:1,252:2,252:3,252:4

# RAID10 - 6 discos (3 pares espejados)
storcli64 /c0/v add type=raid10 drives=252:0,252:1,252:2,252:3,252:4,252:5

# Con nombre personalizado
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 name=DataArray

# Con tamaño de stripe (por defecto 256KB)
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 stripesize=64

Eliminar Virtual Drive

# Eliminar VD 0 (requiere confirmación)
storcli64 /c0/v0 del

# Forzar eliminación sin confirmación
storcli64 /c0/v0 del force

Modificar propiedades del array

# Caché WriteBack/WriteThrough
storcli64 /c0/v0 set iopolicy=cached        # WriteBack
storcli64 /c0/v0 set iopolicy=direct        # WriteThrough

# Lectura anticipada
storcli64 /c0/v0 set rdpolicy=ra            # Lectura anticipada
storcli64 /c0/v0 set rdpolicy=nora          # Sin lectura anticipada

# Política de caché del disco
storcli64 /c0/v0 set pdcache=enable         # Caché del disco
storcli64 /c0/v0 set pdcache=disable        # Sin caché del disco

# Política de acceso
storcli64 /c0/v0 set accesspolicy=rw        # Lectura-escritura
storcli64 /c0/v0 set accesspolicy=ro        # Solo lectura

Operaciones en el array

# Iniciar verificación de consistencia
storcli64 /c0/v0 start cc

# Detener verificación
storcli64 /c0/v0 stop cc

# Ver progreso de rebuild/CC
storcli64 /c0/v0 show progress

# Pausar operación en segundo plano
storcli64 /c0/v0 pause cc

# Reanudar operación
storcli64 /c0/v0 resume cc

Physical Drives (Discos)

Listar todos los discos

# Lista resumida
storcli64 /c0/e252/s all show

# Detallado
storcli64 /c0/e252/s all show all

# En JSON
storcli64 /c0/e252/s all show json

# Por estado
storcli64 /c0/e252/s all show|grep -i online

Información de un disco específico

# Disco en slot 0
storcli64 /c0/e252/s0 show

# Detallado
storcli64 /c0/e252/s0 show all

# Estadísticas SMART
storcli64 /c0/e252/s0 show smartdump

Estados de los discos

Estado Descripción Onln Online - funcionando normalmente Offln Offline - fallo detectado DHS Dedicated Hot Spare - repuesto dedicado GHS Global Hot Spare - repuesto global UGood Unconfigured Good - disco nuevo/no configurado UBad Unconfigured Bad - disco con fallo Rbld Rebuild - reconstruyendo Copyback CopyBack - copiando de vuelta a disco nuevo

Operaciones en discos

# Forzar en línea un disco
storcli64 /c0/e252/s0 set online

# Forzar fuera de línea (¡cuidado!)
storcli64 /c0/e252/s0 set offline

# Iniciar rebuild forzado
storcli64 /c0/e252/s0 start rebuild

# Detener rebuild
storcli64 /c0/e252/s0 stop rebuild

# Localizar disco (LED se enciende)
storcli64 /c0/e252/s0 start locate

# Detener localización
storcli64 /c0/e252/s0 stop locate

# Forzar como bueno (emergencia)
storcli64 /c0/e252/s0 set good force

# Limpiar error SMART
storcli64 /c0/e252/s0 clear smarterror

Firmware y Propiedades

# Ver firmware del disco
storcli64 /c0/e252/s0 show all | grep -i firmware

# Actualizar firmware (archivo .fw)
storcli64 /c0/e252/s0 download fwfile=disk_fw.fw

# Ver tipo de medio (HDD, SSD, NVMe)
storcli64 /c0/e252/s all show | grep -i "Med\|Model"

# Temperatura del disco
storcli64 /c0/e252/s0 show all | grep -i temp

Hot Spares

Listar Hot Spares

# Ver todos los hot spares
storcli64 /c0/e252/s all show | grep -i "dhs\|ghs"

# Detallado
storcli64 /c0/e252/s all show all | grep -B2 -A2 "DHS\|GHS"

Crear Hot Spare Dedicado (DHS)

# Asignar disco como DHS para grupo 0
storcli64 /c0/e252/s6 set hotsparedrive dedicated dg=0

# Eliminar DHS
storcli64 /c0/e252/s6 set hotsparedrive delete

Crear Hot Spare Global (GHS)

# Asignar disco como GHS (cubre todos los arrays)
storcli64 /c0/e252/s6 set hotsparedrive global

# Eliminar GHS
storcli64 /c0/e252/s6 set hotsparedrive delete

Propiedades de Hot Spare

# Rebuild automático activado
storcli64 /c0 set ctrlproperty autorebuild=on

# Desactivar rebuild automático
storcli64 /c0 set ctrlproperty autorebuild=off

# Restaurar hot spare tras inserción de disco nuevo
storcli64 /c0 set ctrlproperty restoredriveoninsert=on

Enclosures

Listar enclosures

# Resumido
storcli64 /c0/e all show

# Detallado
storcli64 /c0/e all show all

# Información específica
storcli64 /c0/e252 show

# Discos en el enclosure 252
storcli64 /c0/e252/s all show

Información detallada del enclosure

# Todos los sensores
storcli64 /c0/e252 show all

# Fabricante y modelo
storcli64 /c0/e252 show | grep -i "vendor\|product"

# Temperatura (si hay sensores)
storcli64 /c0/e252 show | grep -i temp

# Estado de fuentes de alimentación
storcli64 /c0/e252 show | grep -i "power"

Monitoring & Health

Estado general del sistema

# Panel completo
storcli64 /c0 show

# Chequeo de salud
storcli64 /c0 show health

# Alertas activas
storcli64 /c0 show alerts

# Eventos del registro
storcli64 /c0 show events

# Registro de eventos (últimos 100)
storcli64 /c0 show events |tail -100

Monitorear rebuilds y operaciones

# Progreso de rebuild
storcli64 /c0/v all show progress

# Progreso detallado
storcli64 /c0/v all show progress detail

# Progreso de Consistency Check
storcli64 /c0/v0 show cc progress

# Progreso de Patrol Read
storcli64 /c0 show patrolprogress

Métricas de rendimiento

# Rendimiento del array
storcli64 /c0/v0 show performance

# IOPS, latencia, throughput
storcli64 /c0 show performance

# Tasa de aciertos de caché
storcli64 /c0 show cachestats

Tareas programadas

# Ver tareas programadas
storcli64 /c0 show ctrlproperty | grep -i "patrol\|cc"

# Consistency Check
storcli64 /c0 show consistencycheckprogress

# Estado de Patrol Read
storcli64 /c0 show patrolprogress

# Iniciar Patrol Read manualmente
storcli64 /c0 start patrolread

# Detener Patrol Read
storcli64 /c0 stop patrolread

Troubleshooting

Disco con fallo

# Escenario: Disco 252:0 falló

# 1. Verificar estado
storcli64 /c0/e252/s0 show

# 2. Ver array que usa el disco
storcli64 /c0/v all show | grep "252:0"

# 3. Si hay hot spare, el rebuild comienza automáticamente
storcli64 /c0/v0 show progress

# 4. Si no hay hot spare, crear VD temporal con otro disco
# y luego re-agregar el disco nuevo cuando llegue

# 5. Disco nuevo llegó: reemplazar disco fallido
# Localícelo con LED
storcli64 /c0/e252/s0 start locate

# 6. Tras reemplazar, el disco se reconoce automáticamente
storcli64 /c0/e252/s all show

# 7. Si era DHS, automáticamente vuelve a DHS
# Si era array, inicia rebuild automático

Array degradado

# Detectar degradación
storcli64 /c0/v all show | grep -i "dgrd\|pdgd"

# Ver qué disco falló
storcli64 /c0/v0 show all

# Reconstruir manualmente si es necesario
storcli64 /c0/e252/s0 start rebuild

# Monitorear progreso
storcli64 /c0/v0 show progress

El disco no aparece

# Verificar físicamente (LED localizado)
storcli64 /c0/e252/s0 show

# Si el estado es UGood (Unconfigured Good)
# 1. Comprobar si necesita ser inicializado
storcli64 /c0/e252/s all show | grep -i "ugood"

# 2. Configurar como hotspare
storcli64 /c0/e252/s0 set hotsparedrive dedicated dg=0

# 3. Forzar en línea si está offline
storcli64 /c0/e252/s0 set online

Error de rebuild

# Ver error
storcli64 /c0/v0 show progress

# Si está atascado, detener y reiniciar
storcli64 /c0/e252/s0 stop rebuild
storcli64 /c0/e252/s0 start rebuild

# Ver registro de errores
storcli64 /c0 show events | grep -i "rebuild\|error"

# Si el problema persiste, forzar disco bueno
storcli64 /c0/e252/s0 set good force

La caché no funciona

# Verificar si la BBU está bien
storcli64 /c0/bbu show

# Si la BBU falla, la caché cambia a WriteThrough
storcli64 /c0/v0 show | grep -i "cache"

# Verificar política de caché
storcli64 /c0/v0 show cachecade

# Rehabilitar caché tras reparación de BBU
storcli64 /c0/v0 set iopolicy=cached

Rendimiento lento

# Comprobar rebuild/CC en ejecución
storcli64 /c0/v all show progress

# Reducir tasa de rebuild si es muy lento
storcli64 /c0 set ctrlproperty rebuildrate=20

# Aumentar si hay I/O libre
storcli64 /c0 set ctrlproperty rebuildrate=60

# Ver estadísticas de caché
storcli64 /c0 show cachestats

# Ver temperatura (¿throttling?)
storcli64 /c0 show all | grep -i "temp"

Casos de uso reales

Escenario 1: Reemplazar disco fallido con hot spare

# Problema: Disco 252:0 falló en RAID10

# Paso 1: Verificar estado
storcli64 /c0/v all show
# Salida: VD 0/239 RAID10 Dgrd (degradado)

storcli64 /c0/e252/s all show
# Salida: 252:0 Offln (falló)
#         252:6 DHS    (hot spare disponible)

# Paso 2: El hot spare se activa automáticamente, inicia rebuild
storcli64 /c0/v0 show progress
# Rebuild en progreso: 45%

# Paso 3: Monitorear hasta 100%
# (puede llevar horas en discos grandes)

# Paso 4: Llegó disco nuevo
# Reemplazar disco físico en slot 252:0

# Paso 5: Verificar si fue reconocido
storcli64 /c0/e252/s0 show
# Salida: UGood (nuevo disco no configurado)

# Paso 6: El disco vuelve a DHS automáticamente
storcli64 /c0/e252/s all show
# 252:0 ahora DHS nuevamente

Escenario 2: Expandir RAID añadiendo disco

# Problema: RAID5 con 4 discos, se quiere añadir el 5º

# Cuidado: StorCLI actual no soporta expansión directa
# Solución: Eliminar VD y recrear con todos los discos

# Paso 1: Hacer backup
# ... (backup externo necesario)

# Paso 2: Eliminar VD
storcli64 /c0/v0 del force

# Paso 3: Verificar discos
storcli64 /c0/e252/s all show
# 252:0 a 252:4 deben estar UGood

# Paso 4: Crear nuevo RAID5 con 5 discos
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3,252:4

# Paso 5: Inicializar VD
storcli64 /c0/v0 start init full

Escenario 3: Convertir RAID0 a RAID1 (espejo)

# Problema: RAID0 con 2 discos, se desea redundancia

# Paso 1: Backup obligatorio (RAID0 = sin redundancia)
# ... (copia a almacenamiento externo)

# Paso 2: Eliminar RAID0
storcli64 /c0/v0 del force

# Paso 3: Crear RAID1
storcli64 /c0/v add type=raid1 drives=252:0,252:1

# Paso 4: Inicializar
storcli64 /c0/v0 start init full

# Paso 5: Monitorear
storcli64 /c0/v0 show progress

Escenario 4: Monitoreo proactivo

# Trabajo cron: verificar salud cada hora

#!/bin/bash
CONTROLLER=0
STORCLI="/opt/MegaRAID/storcli/storcli64"

# Verificar estado de los arrays
$STORCLI /c$CONTROLLER/v all show | \
  grep -E "Optl|Dgrd|Offln|Rbld" | \
  mail -s "RAID Status Alert" [email protected]

# Verificar temperatura
TEMP=$($STORCLI /c$CONTROLLER show all | grep "Ctrl temperature" | awk '{print $NF}')
if [ ${TEMP%C} -gt 60 ]; then
  echo "Controller hot: $TEMP" | mail -s "Temperature Alert" [email protected]
fi

# Verificar BBU
$STORCLI /c$CONTROLLER/bbu show | grep -i "optimal" || \
  echo "BBU problem detected" | mail -s "BBU Alert" [email protected]

Escenario 5: Migración de discos (rebuild puro)

# Problema: Reemplazar los 6 discos de RAID5 por discos nuevos

# Paso 1: Backup crítico (VD será eliminado)
# ... (copia completa a almacenamiento externo)

# Paso 2: Eliminar VD
storcli64 /c0/v0 del force

# Paso 3: Los 6 discos antiguos quedan UGood
storcli64 /c0/e252/s all show

# Paso 4: Reemplazar discos físicos 1 a 1 (salen UGood, los nuevos entran UGood)

# Paso 5: Crear nuevo RAID5 con discos nuevos
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3,252:4

# Paso 6: Restaurar datos del backup

Consejos y Buenas Prácticas

✅ Recomendaciones

• Siempre hacer backup antes de operaciones destructivas (delete VD, init)

• Monitorear temperatura — rebuild/init genera calor

• BBU es esencial — sin batería, la caché es WriteThrough (lento)

• Hot spare dedicado — más rápido que global

• RAID6 o RAID10 — para datos críticos

• Patrol Read habilitado — detecta errores antes del fallo

• Registros periódicos — rastrear la degradación

• Firmware actualizado — correcciones de errores/rendimiento

❌ Cuidado

• del force elimina datos inmediatamente

• set good force puede corromper datos

• Rebuild lento en discos grandes — déjelo correr

• Múltiples rebuilds simultáneos degradan I/O

• Caché WriteBack sin BBU = riesgo de pérdida de datos

• No cambie controller/enclosure sin planificación

Referencia rápida

Tarea Comando Ver estado storcli64 /c0 show Ver arrays storcli64 /c0/v all show Ver discos storcli64 /c0/e252/s all show Crear RAID5 storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 Crear RAID1 storcli64 /c0/v add type=raid1 drives=252:0,252:1 Hot spare storcli64 /c0/e252/s6 set hotsparedrive dedicated dg=0 Rebuild storcli64 /c0/e252/s0 start rebuild Progreso storcli64 /c0/v0 show progress Localizar storcli64 /c0/e252/s0 start locate Estado de BBU storcli64 /c0/bbu show Modo de caché storcli64 /c0/v0 set iopolicy=cached Rendimiento storcli64 /c0 show performance Eventos storcli64 /c0 show events

Versión e Info

• Versión de StorCLI: 007.2705.0000.0000 (26.07)

• Controlador: Broadcom MegaRAID

• Compatible con: Dell PowerEdge R620/R630/R720/R730/R760/R760xs

📚 Referencias Oficiales

Descargas (Broadcom)

• StorCLI Release Bundle: https://docs.broadcom.com/docs-and-downloads/007.2705.0000.0000\\_storcli\\_rel.zip

• Documentación Oficial: https://docs.broadcom.com/docs/1232743397

Documentación Relacionada

• Documentación de Broadcom MegaRAID: https://docs.broadcom.com

• Manuales de Dell PowerEdge: https://www.dell.com/support/manuals/

• Ajuste de RAID en Oracle Linux: https://docs.oracle.com/

Alternativas y Herramientas Relacionadas

• MegaCLI (legado) — versión antigua, use StorCLI en su lugar

• storcli64 — herramienta CLI (Esta guía)

• StorCLI Snapdump — registro avanzado

• Dell Integrated Dell Remote Access Controller (iDRAC) — vía interfaz web

Disclaimer

Esta guía se proporciona tal cual, sin garantías. Siempre haga backup antes de operaciones destructivas. StorCLI y MegaRAID son marcas registradas de Broadcom Inc. Para soporte oficial, abra un ticket con Broadcom o su proveedor.