Instalación

Pon ipmideck en marcha en tu rack

Tres pasos de una máquina recién instalada a un panel en vivo. Elige Docker o pip, arráncalo y luego abre el asistente. Sin archivos de configuración que editar a mano.

Dónde conseguirlo

Publicado en PyPI y Docker Hub, con el código fuente completo en GitHub. Elige lo que encaje con tu forma de trabajar.

PyPIpip install ipmideck

Docker Hubdevluigi06/ipmideck

Fuentegithub.com

Paso 1

Instala y arranca

Dos formas de ejecutar ipmideck. Docker es un solo comando. Con pip instalas el paquete y luego arrancas el servidor.

docker

Arrancar el contenedor

docker

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

Se ejecuta con --network host para que ipmideck llegue a tus BMC directamente.

pip

1
Instalar el paquete
pip
```
$pip install ipmideck
```
2
Arrancar el servidor
cli
```
$ipmideck
```

El paquete pip necesita ipmitool instalado en el host. Un ipmideck pelado se enlaza a 0.0.0.0:3000.

Paso 2

Abre el panel

http://<your-ip>:3000

your-ip es la dirección de la máquina donde lo arrancaste. Encuéntrala con ip addr en Linux, o en la lista de dispositivos de tu router.

Ve a la dirección de tu servidor en el puerto 3000 y luego sigue el asistente dentro de la app para añadir tu primer BMC. config.yaml se escribe solo en el primer arranque, así que no hay nada que configurar a mano.

¿Funciona? Llegarás al login de ipmideck y luego a un breve asistente para añadir tu primer BMC.

¿No lo ves?

¿No carga nada? Libera el puerto 3000, o mueve ipmideck a otro puerto: pulsa la tecla b en la consola interactiva, o define IPMIDECK_SERVER_PORT.

¿El BMC no aparece en el asistente? Tiene que estar accesible en UDP 623. En Docker, arranca con --network host.

Hardware compatible

ipmideck habla el habitual IPMI 2.0, así que la mayoría de los BMC de servidor responden. La compatibilidad va por niveles según lo a fondo que se haya probado cada fabricante.

Dell PowerEdge / iDRACCompatible / probado

IPMI 2.0. Totalmente compatible y probado.

SupermicroExperimental

IPMI 2.0. Funciona, aún no probado a fondo.

HPE

HPE iLOExperimental

IPMI 2.0. Experimental, aún no probado a fondo.

Lenovo XCCExperimental

IPMI 2.0. Experimental, aún no probado a fondo.

IBM

IBM IMMExperimental

IPMI 2.0. Experimental, aún no probado a fondo.

Ver en GitHub

Configuración

avanzado

No lo necesitas para empezar. ipmideck escribe data/config.yaml con valores por defecto sensatos en el primer arranque. Está aquí por si quieres saber dónde vive y cómo cambiarlo.

dónde vive config.yaml

Docker: /data/config.yaml. La imagen define IPMIDECK_DATA_DIR=/data, así que persiste esa ruta con un volumen.
pip / fuente: Un directorio de datos junto a la instalación (en Linux, /data). Cámbialo de sitio con IPMIDECK_DATA_DIR.

Mostrar el config.yaml por defecto

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

Cada ajuste puede sobrescribirse en tiempo de ejecución con una variable de entorno con prefijo IPMIDECK_, la forma fácil de configurar ipmideck en Docker.

IPMIDECK_SERVER_PORT: Puerto HTTP al que se enlaza el panel (por defecto 3000).
IPMIDECK_AUTH_ENABLED: Activa o desactiva el login integrado (por defecto true).
IPMIDECK_IPMI_POLL_INTERVAL: Segundos entre sondeos de sensores del BMC (por defecto 30).
IPMIDECK_DATA_RETENTION_DAYS: Días de histórico de sensores que conservar antes de la limpieza (por defecto 365).