StorCLI - Cheat Sheet Completo

StorCLI é a ferramenta oficial e moderna para gerenciar controladores RAID Broadcom/LSI (também chamados de MegaRAID). Este guia cobre comandos essenciais, sintaxe e casos

Download

Obter StorCLI 007.2705.0000.0000

Download oficial (Broadcom):

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

Documentação oficial:

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

Nota: Requer conta Broadcom Support (gratuita). Se não conseguir acessar, solicite ao seu vendor (Dell, HPE, etc.)

Instalação

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

Sintaxe Básica

Padrão geral:

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

Componentes:

Componente Descrição Exemplo /c{n} Controlador (0 = primeiro) /c0 /e{n} Enclosure ID /e252 /s{n} Slot do disco no enclosure /s0 /v{n} Virtual Drive (array) /v0 all Todos os itens /c0/e252/s all json Saída em JSON /c0 show json

Exemplos de sintaxe:

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

Comandos de Controlador

Informações gerais

# 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

Configurações do controlador

# 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 (Arrays RAID)

Listar todos os 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

Info específica de um array

# 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

Criar Virtual Drive (Array RAID)

# 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

Deletar Virtual Drive

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

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

Modificar propriedades do array

# 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

Operações no array

# 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 (Discos)

Listar todos os discos

# 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

Info de um disco específico

# 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

Estados dos discos

Estado Descrição Onln Online - funcionando normalmente Offln Offline - falha detectada DHS Dedicated Hot Spare - sobressalente dedicado GHS Global Hot Spare - sobressalente global UGood Unconfigured Good - disco novo/não configurado UBad Unconfigured Bad - disco com falha Rbld Rebuild - reconstruindo Copyback CopyBack - copiando de volta para disco novo

Operações em discos

# 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 & Propriedades

# 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

Listar 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"

Criar Hot Spare Dedicado (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

Criar Hot Spare Global (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

Propriedades de Hot Spare

# 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

Listar 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

Info detalhada do enclosure

# 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

Status geral do sistema

# 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

Monitorar rebuilds e operações

# 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

Métricas de performance

# Performance do array
storcli64 /c0/v0 show performance

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

# Cache hit rate
storcli64 /c0 show cachestats

Tarefas agendadas

# 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

Disco com falha

# 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

Array degradado

# 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

Disco não aparece

# 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

Erro de rebuild

# 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 não funciona

# 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

Performance lenta

# 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"

Casos de Uso Reais

Scenario 1: Substituir disco falho com 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: Expandir RAID adicionando disco

# 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: Converter RAID0 para 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: Monitoramento proativo

# 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: Migração de discos (rebuild puro)

# 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

Dicas & Boas Práticas

✅ Recomendações

• Sempre fazer backup antes de operações destrutivas (delete VD, init)

• Monitorar temperatura — rebuild/init gera calor

• BBU é essencial — sem bateria, cache é WriteThrough (lento)

• Hot spare dedicado — mais rápido que global

• RAID6 ou RAID10 — para dados críticos

• Patrol Read habilitado — detecta erros antes de falha

• Logs periódicos — rastrear degradação

• Firmware atualizado — correções de bug/performance

❌ Cuidado

• del force deleta dados imediatamente

• set good force pode corruper dados

• Rebuild lento em discos grandes — deixe rodar

• Múltiplos rebuilds simultâneos degradam I/O

• Cache WriteBack sem BBU = risco de perda de dados

• Não mude controller/enclosure sem planejamento

Referência Rápida

Tarefa Comando Ver status storcli64 /c0 show Ver arrays storcli64 /c0/v all show Ver discos storcli64 /c0/e252/s all show Criar RAID5 storcli64 /c0/v add type=raid5 drives=252:0,252:1,252:2,252:3 Criar 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 Progresso storcli64 /c0/v0 show progress Localizar 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 Eventos storcli64 /c0 show events

Versão & Info

• StorCLI Version: 007.2705.0000.0000 (26.07)

• Controlador: Broadcom MegaRAID

• Compatível com: Dell PowerEdge R620/R630/R720/R730/R760/R760xs

📚 Referências Oficiais

Downloads (Broadcom)

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

• Documentação Oficial: https://docs.broadcom.com/docs/1232743397

Documentação Relacionada

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

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

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

Alternativas & Ferramentas Relacionadas

• MegaCLI (legado) — versão antiga, use StorCLI em vez disso

• storcli64 — ferramenta CLI (Este guia)

• StorCLI Snapdump — logging avançado

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

Disclaimer

Este guia é fornecido como-está, sem garantias. Sempre faça backup antes de operações destrutivas. StorCLI e MegaRAID são marcas registradas da Broadcom Inc. Para suporte oficial, abra ticket com a Broadcom ou seu vendor.