Installazione

Metti ipmideck in funzione sul tuo rack

Tre passaggi da una macchina pulita a una dashboard attiva. Scegli Docker o pip, avvialo, poi apri la procedura guidata. Nessun file di configurazione da modificare a mano.

Dove scaricarlo

Pubblicato su PyPI e Docker Hub, con il sorgente completo su GitHub. Scegli quello che si adatta a come gestisci le cose.

PyPIpip install ipmideck

Docker Hubdevluigi06/ipmideck

Sorgentegithub.com

Passo 1

Installa e avvia

Due modi per eseguire ipmideck. Docker è un solo comando. Con pip installi il pacchetto e poi avvii il server.

docker

Avvia il container

docker

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

Gira con --network host così ipmideck raggiunge i tuoi BMC direttamente.

pip

1
Installa il pacchetto
pip
```
$pip install ipmideck
```
2
Avvia il server
cli
```
$ipmideck
```

Il pacchetto pip richiede ipmitool installato sull'host. Un semplice ipmideck si lega a 0.0.0.0:3000.

Passo 2

Apri la dashboard

http://<your-ip>:3000

your-ip è l'indirizzo della macchina su cui l'hai avviato. Trovalo con ip addr su Linux, oppure nell'elenco dispositivi del router.

Vai all'indirizzo del tuo server sulla porta 3000, poi segui la procedura guidata nell'app per aggiungere il primo BMC. config.yaml viene scritto automaticamente al primo avvio, quindi non c'è nulla da configurare a mano.

Funziona? Arriverai al login di ipmideck, poi a una breve procedura guidata per aggiungere il primo BMC.

Non lo vedi?

Non si carica nulla? Libera la porta 3000, oppure sposta ipmideck su un'altra porta: premi il tasto b nella console interattiva, o imposta IPMIDECK_SERVER_PORT.

Il BMC non compare nella procedura guidata? Deve essere raggiungibile sulla UDP 623. In Docker, avvia con --network host.

Hardware supportato

ipmideck parla lo standard IPMI 2.0, quindi la maggior parte dei BMC dei server risponde. Il supporto è suddiviso in livelli in base a quanto a fondo ogni vendor è stato testato.

Dell PowerEdge / iDRACSupportato / testato

IPMI 2.0. Pienamente supportato e testato.

SupermicroSperimentale

IPMI 2.0. Funziona, non ancora testato a fondo.

HPE

HPE iLOSperimentale

IPMI 2.0. Sperimentale, non ancora testato a fondo.

Lenovo XCCSperimentale

IPMI 2.0. Sperimentale, non ancora testato a fondo.

IBM

IBM IMMSperimentale

IPMI 2.0. Sperimentale, non ancora testato a fondo.

Vedi su GitHub

Configurazione

avanzato

Non ti serve per iniziare. ipmideck scrive data/config.yaml con valori predefiniti sensati al primo avvio. È qui per quando vuoi sapere dove si trova e come modificarlo.

dove si trova config.yaml

Docker: /data/config.yaml. L'immagine imposta IPMIDECK_DATA_DIR=/data, quindi rendi persistente quel percorso con un volume.
pip / sorgente: Una cartella dati accanto all'installazione (su Linux, /data). Spostala con IPMIDECK_DATA_DIR.

Mostra il config.yaml predefinito

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

Ogni impostazione può essere sovrascritta a runtime con una variabile d'ambiente con prefisso IPMIDECK_, il modo comodo per configurare ipmideck in Docker.

IPMIDECK_SERVER_PORT: Porta HTTP su cui la dashboard si lega (predefinita 3000).
IPMIDECK_AUTH_ENABLED: Abilita o disabilita il login integrato (predefinito true).
IPMIDECK_IPMI_POLL_INTERVAL: Secondi tra un polling dei sensori BMC e l'altro (predefinito 30).
IPMIDECK_DATA_RETENTION_DAYS: Giorni di cronologia dei sensori da conservare prima della pulizia (predefinito 365).