Instalação

Coloque o ipmideck para rodar no seu rack

Três passos de uma máquina zerada a um painel ao vivo. Escolha Docker ou pip, inicie e depois abra o assistente. Sem arquivos de configuração para editar à mão.

Onde obter

Publicado no PyPI e no Docker Hub, com o código completo no GitHub. Escolha o que combina com o seu jeito de trabalhar.

PyPIpip install ipmideck

Docker Hubdevluigi06/ipmideck

Códigogithub.com

Passo 1

Instale e inicie

Duas formas de rodar o ipmideck. Docker é um único comando. Com pip você instala o pacote e depois inicia o servidor.

docker

Iniciar o contêiner

docker

$docker run --network host devluigi06/ipmideck:latest

Roda com --network host para o ipmideck alcançar seus BMCs diretamente.

pip

1
Instalar o pacote
pip
```
$pip install ipmideck
```
2
Iniciar o servidor
cli
```
$ipmideck
```

O pacote pip precisa do ipmitool instalado no host. Um ipmideck pelado escuta em 0.0.0.0:3000.

Passo 2

Abra o painel

http://<your-ip>:3000

your-ip é o endereço da máquina onde você o iniciou. Encontre-o com ip addr no Linux, ou na lista de dispositivos do seu roteador.

Acesse o endereço do seu servidor na porta 3000 e depois siga o assistente no app para adicionar seu primeiro BMC. O config.yaml é gravado automaticamente na primeira execução, então não há nada para configurar à mão.

Funcionou? Você chega ao login do ipmideck e depois a um breve assistente para adicionar seu primeiro BMC.

Não está vendo?

Nada carrega? Libere a porta 3000, ou mova o ipmideck para outra porta: pressione a tecla b no console interativo, ou defina IPMIDECK_SERVER_PORT.

BMC sumido no assistente? Ele precisa estar acessível na UDP 623. No Docker, inicie com --network host.

Hardware compatível

O ipmideck fala o IPMI 2.0 padrão, então a maioria dos BMCs de servidor responde. O suporte é por níveis, conforme o quão a fundo cada fabricante foi testado.

Dell PowerEdge / iDRACCompatível / testado

IPMI 2.0. Totalmente compatível e testado.

SupermicroExperimental

IPMI 2.0. Funciona, ainda não testado a fundo.

HPE

HPE iLOExperimental

IPMI 2.0. Experimental, ainda não testado a fundo.

Lenovo XCCExperimental

IPMI 2.0. Experimental, ainda não testado a fundo.

IBM

IBM IMMExperimental

IPMI 2.0. Experimental, ainda não testado a fundo.

Ver no GitHub

Configuração

avançado

Você não precisa disso para começar. O ipmideck grava data/config.yaml com padrões sensatos na primeira execução. Está aqui para quando você quiser saber onde ele vive e como mudá-lo.

onde o config.yaml vive

Docker: /data/config.yaml. A imagem define IPMIDECK_DATA_DIR=/data, então persista esse caminho com um volume.
pip / código: Um diretório de dados ao lado da instalação (no Linux, /data). Realoque-o com IPMIDECK_DATA_DIR.

Mostrar o config.yaml padrão

config.yaml

# data/config.yaml — auto-generated on first run
server:
  host: "0.0.0.0"
  port: 3000
  https: false
auth:
  enabled: true
  session_expiry: "24h"
  max_login_attempts: 5
ipmi:
  poll_interval: 30
  power_poll_interval: 30
  command_timeout: 30
data:
  retention_days: 365
  cleanup_interval: "24h"
logging:
  level: "info"
modules:
  sensors:
    enabled: true
  fanpilot:
    enabled: true
  power:
    enabled: true
  sel:
    enabled: true
  fru:
    enabled: true

Todo ajuste pode ser sobrescrito em tempo de execução com uma variável de ambiente prefixada com IPMIDECK_, o jeito fácil de configurar o ipmideck no Docker.

IPMIDECK_SERVER_PORT: Porta HTTP em que o painel escuta (padrão 3000).
IPMIDECK_AUTH_ENABLED: Ative ou desative o login embutido (padrão true).
IPMIDECK_IPMI_POLL_INTERVAL: Segundos entre as leituras dos sensores do BMC (padrão 30).
IPMIDECK_DATA_RETENTION_DAYS: Dias de histórico de sensores a manter antes da limpeza (padrão 365).