Installatie

Krijg ipmideck draaiend op je rack

Drie stappen van een verse machine naar een live dashboard. Kies Docker of pip, start het, en open dan de wizard. Geen configuratiebestanden om met de hand te bewerken.

Waar je het krijgt

Gepubliceerd op PyPI en Docker Hub, met de volledige broncode op GitHub. Kies wat past bij hoe jij dingen draait.

PyPIpip install ipmideck

Docker Hubdevluigi06/ipmideck

Broncodegithub.com

Stap 1

Installeer en start

Twee manieren om ipmideck te draaien. Docker is één commando. Met pip installeer je het pakket en start je daarna de server.

docker

Start de container

docker

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

Draait met --network host zodat ipmideck je BMC's rechtstreeks bereikt.

pip

1
Installeer het pakket
pip
```
$pip install ipmideck
```
2
Start de server
cli
```
$ipmideck
```

Het pip-pakket heeft ipmitool op de host nodig. Een kale ipmideck bindt aan 0.0.0.0:3000.

Stap 2

Open het dashboard

http://<your-ip>:3000

your-ip is het adres van de machine waarop je het hebt gestart. Vind het met ip addr op Linux, of in de apparatenlijst van je router.

Ga naar het adres van je server op poort 3000 en volg dan de wizard in de app om je eerste BMC toe te voegen. config.yaml wordt bij de eerste start automatisch geschreven, dus er valt niets met de hand te configureren.

Werkt het? Je belandt op de ipmideck-login en daarna op een korte wizard om je eerste BMC toe te voegen.

Zie je het niet?

Laadt er niets? Maak poort 3000 vrij, of verplaats ipmideck naar een andere poort: druk op de toets b in de interactieve console, of stel IPMIDECK_SERVER_PORT in.

BMC ontbreekt in de wizard? Hij moet bereikbaar zijn op UDP 623. In Docker start je met --network host.

Ondersteunde hardware

ipmideck spreekt het gangbare IPMI 2.0, dus de meeste server-BMC's reageren. De ondersteuning is in niveaus, afhankelijk van hoe grondig elke fabrikant is getest.

Dell PowerEdge / iDRACOndersteund / getest

IPMI 2.0. Volledig ondersteund en getest.

SupermicroExperimenteel

IPMI 2.0. Werkt, nog niet uitputtend getest.

HPE

HPE iLOExperimenteel

IPMI 2.0. Experimenteel, nog niet uitputtend getest.

Lenovo XCCExperimenteel

IPMI 2.0. Experimenteel, nog niet uitputtend getest.

IBM

IBM IMMExperimenteel

IPMI 2.0. Experimenteel, nog niet uitputtend getest.

Bekijk op GitHub

Configuratie

geavanceerd

Voor de start heb je dit niet nodig. ipmideck schrijft bij de eerste start data/config.yaml met verstandige standaardwaarden. Het staat hier voor als je wilt weten waar het leeft en hoe je het verandert.

waar config.yaml leeft

Docker: /data/config.yaml. Het image stelt IPMIDECK_DATA_DIR=/data in, dus maak dat pad blijvend met een volume.
pip / broncode: Een datamap naast de installatie (op Linux, /data). Verplaats het met IPMIDECK_DATA_DIR.

Toon de standaard config.yaml

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

Elke instelling kun je tijdens runtime overschrijven met een omgevingsvariabele met het voorvoegsel IPMIDECK_, de makkelijke manier om ipmideck in Docker te configureren.

IPMIDECK_SERVER_PORT: HTTP-poort waaraan het dashboard bindt (standaard 3000).
IPMIDECK_AUTH_ENABLED: Schakel de ingebouwde login in of uit (standaard true).
IPMIDECK_IPMI_POLL_INTERVAL: Seconden tussen het pollen van de BMC-sensoren (standaard 30).
IPMIDECK_DATA_RETENTION_DAYS: Dagen sensorgeschiedenis om te bewaren voor de opschoning (standaard 365).