설치

랙에서 ipmideck를 가동하세요

갓 설치한 머신에서 실시간 대시보드까지 세 단계. Docker나 pip을 골라 실행한 다음 마법사를 여세요. 손으로 편집할 설정 파일은 없습니다.

받는 곳

PyPI와 Docker Hub에 게시되어 있으며, 전체 소스는 GitHub에 있습니다. 운영 방식에 맞는 것을 고르세요.

PyPIpip install ipmideck

Docker Hubdevluigi06/ipmideck

소스github.com

1단계

설치하고 실행하기

ipmideck를 실행하는 두 가지 방법. Docker는 명령어 하나입니다. pip은 패키지를 설치한 다음 서버를 실행합니다.

docker

컨테이너 실행

docker

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

ipmideck가 BMC에 직접 닿을 수 있도록 --network host로 실행됩니다.

pip

1
패키지 설치
pip
```
$pip install ipmideck
```
2
서버 실행
cli
```
$ipmideck
```

pip 패키지는 호스트에 ipmitool이 설치되어 있어야 합니다. 기본 ipmideck는 0.0.0.0:3000에 바인딩됩니다.

2단계

대시보드 열기

http://<your-ip>:3000

your-ip는 실행한 머신의 주소입니다. Linux에서는 ip addr로, 또는 라우터의 장치 목록에서 찾을 수 있습니다.

포트 3000으로 서버 주소에 접속한 다음, 앱 내 설치 마법사를 따라 첫 BMC를 추가하세요. config.yaml은 첫 실행 시 자동으로 작성되므로 손으로 설정할 것이 없습니다.

되나요? ipmideck 로그인에 도달한 뒤, 첫 BMC를 추가하는 짧은 마법사가 나옵니다.

보이지 않나요?

아무것도 로드되지 않나요? 포트 3000을 비우거나 ipmideck를 다른 포트로 옮기세요. 대화형 콘솔에서 b 키를 누르거나 IPMIDECK_SERVER_PORT를 설정합니다.

마법사에 BMC가 안 보이나요? UDP 623으로 닿을 수 있어야 합니다. Docker에서는 --network host로 실행하세요.

지원 하드웨어

ipmideck는 표준 IPMI 2.0을 말하므로 대부분의 서버 BMC가 응답합니다. 지원은 각 벤더를 얼마나 철저히 테스트했는지에 따라 단계로 나뉩니다.

Dell PowerEdge / iDRAC지원 / 테스트됨

IPMI 2.0. 완전 지원 및 테스트됨.

Supermicro실험적

IPMI 2.0. 동작하지만 아직 철저히 테스트되지 않음.

HPE

HPE iLO실험적

IPMI 2.0. 실험적, 아직 철저히 테스트되지 않음.

Lenovo XCC실험적

IPMI 2.0. 실험적, 아직 철저히 테스트되지 않음.

IBM

IBM IMM실험적

IPMI 2.0. 실험적, 아직 철저히 테스트되지 않음.

GitHub에서 보기

설정

고급

시작하는 데는 필요하지 않습니다. ipmideck는 첫 실행 시 합리적인 기본값으로 data/config.yaml을 작성합니다. 어디에 있고 어떻게 바꾸는지 알고 싶을 때를 위해 여기에 둡니다.

config.yaml 위치

Docker: /data/config.yaml. 이미지가 IPMIDECK_DATA_DIR=/data를 설정하므로 그 경로를 볼륨으로 영속화하세요.
pip / 소스: 설치 위치 옆의 데이터 디렉터리(Linux에서는 /data). IPMIDECK_DATA_DIR로 옮길 수 있습니다.

기본 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

모든 설정은 IPMIDECK_ 접두사 환경 변수로 런타임에 덮어쓸 수 있습니다. Docker에서 ipmideck를 설정하는 간편한 방법입니다.

IPMIDECK_SERVER_PORT: 대시보드가 바인딩하는 HTTP 포트(기본 3000).
IPMIDECK_AUTH_ENABLED: 내장 로그인을 켜거나 끕니다(기본 true).
IPMIDECK_IPMI_POLL_INTERVAL: BMC 센서 폴링 간격(초)(기본 30).
IPMIDECK_DATA_RETENTION_DAYS: 정리 전에 보관할 센서 기록 일수(기본 365).