> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ipmideck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

> ipmideck가 BMC와 통신할 때의 연결, 인증, IPMI 오류.

## ipmideck가 BMC에 도달할 수 없음

ipmideck는 UDP 포트 623 (IPMI/RMCP+)을 통해 BMC와 통신합니다. 서버가 오프라인으로
표시되면:

* Docker에서 컨테이너를 `--network host`로 시작했는지 확인하세요. 그것이 없으면 컨테이너는
  LAN의 BMC에 도달할 수 없습니다.
* BMC IP가 호스트에서 도달 가능한지 확인하세요 (`ping <bmc-ip>`).
* BMC에서 IPMI over LAN이 활성화되어 있고 UDP 623이 방화벽이나 VLAN 경계에 의해
  차단되지 않았는지 확인하세요.

<Note>
  ipmideck는 암호화된 세션을 위해 항상 `lanplus` (IPMI 2.0)를 사용합니다. IPMI 1.5 전용에
  갇힌 BMC, 또는 RMCP+ 암호 모음이 비활성화된 BMC는 연결을 거부할 수 있습니다.
</Note>

## 인증 / 권한 오류

명령이 인증 또는 권한 오류로 실패하면:

* 서버에 입력한 BMC 사용자 이름과 비밀번호를 다시 확인하세요.
* BMC 계정에는 전원 및 팬 제어를 위해 최소한 Operator 권한이 필요합니다. 구성 변경에는
  Administrator가 필요합니다.
* 일부 BMC는 반복된 로그인 실패 후 계정을 잠급니다. 기다리거나 BMC 자체의 웹 UI에서
  계정을 재설정하세요.

## 명령이 시간 초과됨

오래된 하드웨어는 응답이 느릴 수 있습니다. ipmideck는 `ipmi.command_timeout`으로 설정된
명령별 시간 초과를 적용합니다 (기본값 30초). 느린 BMC에서 시간 초과가 보이면, `config.yaml`에서
그 값을 늘리세요. 큰 리포지토리에서의 센서 및 SEL 읽기가 가장 느려질 가능성이 높습니다.

## 센서가 누락되거나 0을 읽음

* BMC가 실제로 그 센서를 노출하는지 확인하세요 (`sdr elist` 지원은 공급업체마다 다릅니다).
* 일부 센서는 서버가 켜져 있는 동안에만 채워집니다.
* 폴링 간격 (`ipmi.poll_interval`, 기본값 30초 / `IPMIDECK_IPMI_POLL_INTERVAL`)을 확인하세요.
  매우 긴 간격은 첫 판독을 지연시킵니다.

## 팬이 예기치 않게 BMC 제어로 돌아감

FanPilot는 두 경우에 의도적으로 팬을 BMC 자체의 열 관리로 반환합니다.

* **안전 재정의**: 임계 온도 이상에서 팬이 100%로 갑니다.
* **복구**: 비정상 종료, 서버 오프라인, 또는 오래된 센서 감지 후, ipmideck는 BMC의
  자동 모드를 복원하여 하드웨어가 결코 관리되지 않은 채 남지 않도록 합니다.

이는 의도된 안전장치 동작이지 버그가 아닙니다. [보안](/ko/security)을 참조하세요.

## 대시보드가 로드되지 않음

* 컨테이너 또는 프로세스가 실행 중이며 구성된 포트에서 수신 대기 중인지 확인하세요
  (`server.port` / `IPMIDECK_SERVER_PORT`, 기본값 3000).
* `server.https: true`를 설정하지 않았다면, `https`가 아니라 `http://<your-ip>:3000`을 엽니다.
* 애플리케이션 로그를 확인하세요. 더 자세한 내용을 위해 `logging.level`을 `debug`로 올립니다.