StorCLI - Complete Cheat Sheet

StorCLI is the official and modern tool for managing Broadcom/LSI RAID controllers (also called MegaRAID). This guide covers essential commands, syntax and use cases

Download

Get StorCLI 007.2705.0000.0000

Official download (Broadcom):

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

Official documentation:

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

Note: Requires a Broadcom Support account (free). If you can't access, ask your vendor (Dell, HPE, etc.)

Installation

Linux (Red Hat/CentOS/Oracle Linux)

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

# Descompactar 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 instalação
/opt/MegaRAID/storcli/storcli64 -v

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

# Adicionar ao .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

Basic Syntax

General pattern:

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

Components:

Component Description Example /c{n} Controller (0 = first) /c0 /e{n} Enclosure ID /e252 /s{n} Disk slot in enclosure /s0 /v{n} Virtual Drive (array) /v0 all All items /c0/e252/s all json JSON output /c0 show json

Syntax examples:

storcli64 /c0 show                           # Info do controlador 0
storcli64 /c0/v0 show                        # Info do VD (virtual drive) 0
storcli64 /c0/e252/s0 show                   # Info do disco no slot 0
storcli64 /c0/e252/s all show                # Todos os discos no enclosure 252
storcli64 /c0/v all show                     # Todos os arrays

Controller Commands

General Information

# Info completa do controlador
storcli64 /c0 show

# Info resumida
storcli64 /c0 show summary

# Status detalhado
storcli64 /c0 show all

# Versão firmware e status
storcli64 /c0/bbu show

# Saída em JSON (melhor para parsing)
storcli64 /c0 show json

Controller Settings

# Ver políticas ativas
storcli64 /c0 show ctrlproperty

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

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

# Cache flush interval (segundos)
storcli64 /c0 set ctrlproperty cacheflushinterval=4

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

BBU (Battery Backup Unit)

# Status da bateria
storcli64 /c0/bbu show

# Info detalhada
storcli64 /c0/bbu show all

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

# Ver tempo remanescente
storcli64 /c0/bbu show preservecache

Virtual Drives (RAID Arrays)

List all arrays

# Listar VDs
storcli64 /c0/v all show

# Detalhado
storcli64 /c0/v all show all

# Em JSON
storcli64 /c0/v all show json

# Resumido
storcli64 /c0/v all show summary

Specific array info

# VD 0
storcli64 /c0/v0 show

# Info completa
storcli64 /c0/v0 show all

# Propriedades de cache
storcli64 /c0/v0 show cachecade

# Performance metrics
storcli64 /c0/v0 show performance

Create Virtual Drive (RAID Array)

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

# RAID1 (mirror) - 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 (com 2 de paridade)
storcli64 /c0/v add type=raid6 drives=252:0,252:1,252:2,252:3,252:4

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

# Com nome customizado
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 name=DataArray

# Com stripe size (default 256KB)
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 stripesize=64

Delete Virtual Drive

# Deletar VD 0 (requer confirmação)
storcli64 /c0/v0 del

# Forçar delete sem confirmação
storcli64 /c0/v0 del force

Modify array properties

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

# Read Ahead
storcli64 /c0/v0 set rdpolicy=ra            # Read Ahead
storcli64 /c0/v0 set rdpolicy=nora          # No Read Ahead

# Disk Cache Policy
storcli64 /c0/v0 set pdcache=enable         # Cache do disco
storcli64 /c0/v0 set pdcache=disable        # Sem cache do disco

# Access Policy
storcli64 /c0/v0 set accesspolicy=rw        # Read-Write
storcli64 /c0/v0 set accesspolicy=ro        # Read-Only

Array operations

# Iniciar verificação de consistência
storcli64 /c0/v0 start cc

# Parar verificação
storcli64 /c0/v0 stop cc

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

# Pausar operação em background
storcli64 /c0/v0 pause cc

# Resumir operação
storcli64 /c0/v0 resume cc

Physical Drives (Disks)

List all disks

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

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

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

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

Specific disk info

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

# Detalhado
storcli64 /c0/e252/s0 show all

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

Disk states

State Description Onln Online - working normally Offln Offline - failure detected DHS Dedicated Hot Spare - dedicated spare GHS Global Hot Spare - global spare UGood Unconfigured Good - new/unconfigured disk UBad Unconfigured Bad - failed disk Rbld Rebuild - rebuilding Copyback CopyBack - copying back to new disk

Disk operations

# Forçar online um disco
storcli64 /c0/e252/s0 set online

# Forçar offline (cuidado!)
storcli64 /c0/e252/s0 set offline

# Iniciar rebuild forçado
storcli64 /c0/e252/s0 start rebuild

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

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

# Parar localização
storcli64 /c0/e252/s0 stop locate

# Forçar como bom (emergência)
storcli64 /c0/e252/s0 set good force

# Limpar erro SMART
storcli64 /c0/e252/s0 clear smarterror

Firmware & Properties

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

# Atualizar firmware (arquivo .fw)
storcli64 /c0/e252/s0 download fwfile=disk_fw.fw

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

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

Hot Spares

List Hot Spares

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

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

Create Dedicated Hot Spare (DHS)

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

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

Create Global Hot Spare (GHS)

# Designar disco como GHS (cobre todos os arrays)
storcli64 /c0/e252/s6 set hotsparedrive global

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

Hot Spare Properties

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

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

# Restaurar hot spare após inserção de disco novo
storcli64 /c0 set ctrlproperty restoredriveoninsert=on

Enclosures

List enclosures

# Resumido
storcli64 /c0/e all show

# Detalhado
storcli64 /c0/e all show all

# Info específica
storcli64 /c0/e252 show

# Discos no enclosure 252
storcli64 /c0/e252/s all show

Detailed enclosure info

# Todos os sensores
storcli64 /c0/e252 show all

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

# Temperatura (se há sensores)
storcli64 /c0/e252 show | grep -i temp

# Status de power supplies
storcli64 /c0/e252 show | grep -i "power"

Monitoring & Health

General system status

# Dashboard completo
storcli64 /c0 show

# Health check
storcli64 /c0 show health

# Alertas ativos
storcli64 /c0 show alerts

# Eventos do log
storcli64 /c0 show events

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

Monitor rebuilds and operations

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

# Progresso detalhado
storcli64 /c0/v all show progress detail

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

# Progresso de Patrol Read
storcli64 /c0 show patrolprogress

Performance metrics

# Performance do array
storcli64 /c0/v0 show performance

# IOPS, latência, throughput
storcli64 /c0 show performance

# Cache hit rate
storcli64 /c0 show cachestats

Scheduled tasks

# Ver tarefas agendadas
storcli64 /c0 show ctrlproperty | grep -i "patrol\|cc"

# Consistency Check
storcli64 /c0 show consistencycheckprogress

# Patrol Read status
storcli64 /c0 show patrolprogress

# Iniciar Patrol Read manualmente
storcli64 /c0 start patrolread

# Parar Patrol Read
storcli64 /c0 stop patrolread

Troubleshooting

Failed disk

# Scenario: Disco 252:0 falhou

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

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

# 3. Se há hot spare, rebuild começa automaticamente
storcli64 /c0/v0 show progress

# 4. Se sem hot spare, criar VD temporário com outro disco
# e depois re-agregar o disco novo quando chegar

# 5. Disco novo chegou: trocar disco falho
# Localize com LED
storcli64 /c0/e252/s0 start locate

# 6. Após trocar, disco é reconhecido automaticamente
storcli64 /c0/e252/s all show

# 7. Se era DHS, automaticamente volta para DHS
# Se era array, inicia rebuild automático

Degraded array

# Detectar degradação
storcli64 /c0/v all show | grep -i "dgrd\|pdgd"

# Ver qual disco faltou
storcli64 /c0/v0 show all

# Reconstruir manualmente se necessário
storcli64 /c0/e252/s0 start rebuild

# Monitorar progresso
storcli64 /c0/v0 show progress

Disk not showing up

# Verificar física (LED localized)
storcli64 /c0/e252/s0 show

# Se estado é UGood (Unconfigured Good)
# 1. Checar se precisa ser inicializado
storcli64 /c0/e252/s all show | grep -i "ugood"

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

# 3. Forçar online se offline
storcli64 /c0/e252/s0 set online

Rebuild error

# Ver erro
storcli64 /c0/v0 show progress

# Se travado, parar e reiniciar
storcli64 /c0/e252/s0 stop rebuild
storcli64 /c0/e252/s0 start rebuild

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

# Se problema persistir, forçar disco bom
storcli64 /c0/e252/s0 set good force

Cache not working

# Verificar se BBU está ok
storcli64 /c0/bbu show

# Se BBU falhar, cache muda para WriteThrough
storcli64 /c0/v0 show | grep -i "cache"

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

# Re-habilitar cache após BBU repair
storcli64 /c0/v0 set iopolicy=cached

Slow performance

# Check rebuild/CC em execução
storcli64 /c0/v all show progress

# Reduzir taxa de rebuild se muito lento
storcli64 /c0 set ctrlproperty rebuildrate=20

# Aumentar se há I/O livre
storcli64 /c0 set ctrlproperty rebuildrate=60

# Ver cache statistics
storcli64 /c0 show cachestats

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

Real Use Cases

Scenario 1: Replace failed disk with hot spare

# Problema: Disco 252:0 falhou em RAID10

# Step 1: Verificar status
storcli64 /c0/v all show
# Output: VD 0/239 RAID10 Dgrd (degradado)

storcli64 /c0/e252/s all show
# Output: 252:0 Offln (falhou)
#         252:6 DHS    (hot spare disponível)

# Step 2: Hot spare ativa automaticamente, inicia rebuild
storcli64 /c0/v0 show progress
# Rebuild em progresso: 45%

# Step 3: Monitorar até 100%
# (pode levar horas em discos grandes)

# Step 4: Disco novo chegou
# Trocar disco físico no slot 252:0

# Step 5: Verificar se foi reconhecido
storcli64 /c0/e252/s0 show
# Output: UGood (novo disco não configurado)

# Step 6: Disco volta como DHS automaticamente
storcli64 /c0/e252/s all show
# 252:0 agora DHS novamente

Scenario 2: Expand RAID by adding disk

# Problema: RAID5 com 4 discos, quer adicionar 5º

# Cuidado: StorCLI atual não suporta expand direto
# Solução: Delete VD e recrie com todos os discos

# Step 1: Fazer backup
# ... (backup externo necessário)

# Step 2: Delete VD
storcli64 /c0/v0 del force

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

# Step 4: Criar novo RAID5 com 5 discos
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3,252:4

# Step 5: Initialize VD
storcli64 /c0/v0 start init full

Scenario 3: Convert RAID0 to RAID1 (mirror)

# Problema: RAID0 com 2 discos, quer redundância

# Step 1: Backup obrigatório (RAID0 = sem redundância)
# ... (cópia para storage externo)

# Step 2: Delete RAID0
storcli64 /c0/v0 del force

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

# Step 4: Initialize
storcli64 /c0/v0 start init full

# Step 5: Monitorar
storcli64 /c0/v0 show progress

Scenario 4: Proactive monitoring

# Cron job: verificar saúde a cada hora

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

# Verificar estado dos 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]

Scenario 5: Disk migration (pure rebuild)

# Problema: Trocar todos os 6 discos de RAID5 por discos novos

# Step 1: Backup crítico (VD será deletado)
# ... (cópia completa para storage externo)

# Step 2: Delete VD
storcli64 /c0/v0 del force

# Step 3: Todos os 6 discos antigos ficam UGood
storcli64 /c0/e252/s all show

# Step 4: Trocar discos físicos 1 a 1 (eles saem UGood, novos entram UGood)

# Step 5: Criar novo RAID5 com discos novos
storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3,252:4

# Step 6: Restaurar dados do backup

Tips & Best Practices

✅ Recommendations

• Always backup before destructive operations (delete VD, init)

• Monitor temperature — rebuild/init generates heat

• BBU is essential — without battery, cache is WriteThrough (slow)

• Dedicated hot spare — faster than global

• RAID6 or RAID10 — for critical data

• Patrol Read enabled — detects errors before failure

• Periodic logs — track degradation

• Updated firmware — bug/performance fixes

❌ Caution

• del force deletes data immediately

• set good force can corrupt data

• Slow rebuild on large disks — let it run

• Multiple simultaneous rebuilds degrade I/O

• WriteBack cache without BBU = risk of data loss

• Do not change controller/enclosure without planning

Quick Reference

Task Command Check status storcli64 /c0 show Check arrays storcli64 /c0/v all show Check disks storcli64 /c0/e252/s all show Create RAID5 storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 Create 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 Progress storcli64 /c0/v0 show progress Locate storcli64 /c0/e252/s0 start locate BBU status storcli64 /c0/bbu show Cache mode storcli64 /c0/v0 set iopolicy=cached Performance storcli64 /c0 show performance Events storcli64 /c0 show events

Version & Info

• StorCLI Version: 007.2705.0000.0000 (26.07)

• Controller: Broadcom MegaRAID

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

📚 Official References

Downloads (Broadcom)

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

• Official Documentation: https://docs.broadcom.com/docs/1232743397

Related Documentation

• Broadcom MegaRAID Docs: https://docs.broadcom.com

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

• Oracle Linux RAID Tuning: https://docs.oracle.com/

Alternatives & Related Tools

• MegaCLI (legacy) — old version, use StorCLI instead

• storcli64 — CLI tool (This guide)

• StorCLI Snapdump — advanced logging

• Dell Integrated Dell Remote Access Controller (iDRAC) — via web UI

Disclaimer

This guide is provided as-is, without warranties. Always back up before destructive operations. StorCLI and MegaRAID are registered trademarks of Broadcom Inc. For official support, open a ticket with Broadcom or your vendor.