Installation

Mettez ipmideck en route sur votre rack

Trois étapes d'une machine neuve à un tableau de bord en direct. Choisissez Docker ou pip, lancez-le, puis ouvrez l'assistant. Aucun fichier de configuration à éditer à la main.

Où l'obtenir

Publié sur PyPI et Docker Hub, avec le code source complet sur GitHub. Choisissez ce qui colle à votre façon de faire.

PyPIpip install ipmideck

Docker Hubdevluigi06/ipmideck

Sourcegithub.com

Étape 1

Installez et lancez

Deux façons de faire tourner ipmideck. Docker, c'est une seule commande. Avec pip, vous installez le paquet, puis vous lancez le serveur.

docker

Lancer le conteneur

docker

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

Tourne avec --network host pour qu'ipmideck atteigne vos BMC directement.

pip

1
Installer le paquet
pip
```
$pip install ipmideck
```
2
Lancer le serveur
cli
```
$ipmideck
```

Le paquet pip nécessite ipmitool installé sur l'hôte. Un ipmideck nu se lie à 0.0.0.0:3000.

Étape 2

Ouvrez le tableau de bord

http://<your-ip>:3000

your-ip est l'adresse de la machine sur laquelle vous l'avez lancé. Trouvez-la avec ip addr sous Linux, ou dans la liste des appareils de votre routeur.

Rendez-vous à l'adresse de votre serveur sur le port 3000, puis suivez l'assistant dans l'app pour ajouter votre premier BMC. config.yaml est écrit automatiquement au premier lancement, il n'y a donc rien à configurer à la main.

Ça marche ? Vous arriverez sur la connexion ipmideck, puis sur un court assistant pour ajouter votre premier BMC.

Vous ne voyez rien ?

Rien ne charge ? Libérez le port 3000, ou déplacez ipmideck sur un autre port : appuyez sur la touche b dans la console interactive, ou définissez IPMIDECK_SERVER_PORT.

BMC absent de l'assistant ? Il doit être joignable en UDP 623. En Docker, lancez avec --network host.

Matériel pris en charge

ipmideck parle l'IPMI 2.0 habituel, donc la plupart des BMC de serveur répondent. La prise en charge est par paliers, selon le sérieux des tests menés sur chaque fabricant.

Dell PowerEdge / iDRACPris en charge / testé

IPMI 2.0. Pleinement pris en charge et testé.

SupermicroExpérimental

IPMI 2.0. Fonctionne, pas encore testé à fond.

HPE

HPE iLOExpérimental

IPMI 2.0. Expérimental, pas encore testé à fond.

Lenovo XCCExpérimental

IPMI 2.0. Expérimental, pas encore testé à fond.

IBM

IBM IMMExpérimental

IPMI 2.0. Expérimental, pas encore testé à fond.

Voir sur GitHub

Configuration

avancé

Vous n'en avez pas besoin pour démarrer. ipmideck écrit data/config.yaml avec des valeurs par défaut sensées au premier lancement. C'est ici pour quand vous voulez savoir où il vit et comment le changer.

où vit config.yaml

Docker: /data/config.yaml. L'image définit IPMIDECK_DATA_DIR=/data, donc persistez ce chemin avec un volume.
pip / source: Un répertoire de données à côté de l'installation (sous Linux, /data). Déplacez-le avec IPMIDECK_DATA_DIR.

Afficher le config.yaml par défaut

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

Chaque réglage peut être surchargé à l'exécution avec une variable d'environnement préfixée IPMIDECK_, la façon simple de configurer ipmideck en Docker.

IPMIDECK_SERVER_PORT: Port HTTP auquel le tableau de bord se lie (par défaut 3000).
IPMIDECK_AUTH_ENABLED: Activez ou désactivez la connexion intégrée (par défaut true).
IPMIDECK_IPMI_POLL_INTERVAL: Secondes entre les sondages des capteurs BMC (par défaut 30).
IPMIDECK_DATA_RETENTION_DAYS: Jours d'historique des capteurs à conserver avant nettoyage (par défaut 365).