> ## 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 自身の Web UI から
  アカウントをリセットします。

## コマンドがタイムアウトする

古いハードウェアは応答が遅い場合があります。ipmideck は `ipmi.command_timeout` で設定された
コマンドごとのタイムアウトを適用します (デフォルト 30 秒)。遅い BMC でタイムアウトが見られる場合は、
`config.yaml` でその値を増やします。大きなリポジトリでのセンサーと SEL の読み取りが最も遅くなりがちです。

## センサーが欠落しているかゼロを読む

* BMC が実際にそれらのセンサーを公開していることを確認します (`sdr elist` のサポートはベンダーに
  よって異なります)。
* 一部のセンサーはサーバーの電源が入っている間のみ値が入ります。
* ポーリング間隔 (`ipmi.poll_interval`、デフォルト 30 秒 / `IPMIDECK_IPMI_POLL_INTERVAL`) を確認します。
  非常に長い間隔は最初の読み取りを遅らせます。

## ファンが予期せず BMC 制御に戻る

FanPilot は次の 2 つのケースで、意図的にファンを BMC 自身の熱管理に返します。

* **安全オーバーライド**: 重要温度以上で、ファンは 100% になります。
* **回復**: 異常シャットダウン、サーバーオフライン、または古いセンサーの検出の後、ipmideck は BMC の
  自動モードを復元し、ハードウェアが管理されないままになることがないようにします。

これは意図されたフェイルセーフの動作であり、バグではありません。[セキュリティ](/ja/security) を参照して
ください。

## ダッシュボードが読み込まれない

* コンテナーまたはプロセスが実行中で、設定されたポートでリッスンしていることを確認します
  (`server.port` / `IPMIDECK_SERVER_PORT`、デフォルト 3000)。
* `server.https: true` を設定していない限り、`https` ではなく `http://<your-ip>:3000` を開きます。
* アプリケーションのログを確認します。より詳細を得るには `logging.level` を `debug` に上げます。
