Topics で読み物として読む

この HLD は実装詳細を含みます。機能の概念・設定・運用を読み物として読みたい場合は Topics 09 章: Telemetry / SNMP / ログを参照。

裏取りステータス: Code-verified

sonic-yang-models/yang-models/sonic-kdump.yang L57-71 で remote / ssh_string / ssh_path の leaf を確認。sonic-utilities/scripts/sonic-kdump-config L261/283-294/346-357/429-444 で同フィールドの読み書きと kdump-tools への反映、sonic-utilities/show/kdump.py L88-95 で show kdump config 拡張、sonic-host-services/scripts/hostcfgd L1166-1270 でハンドラ、sonic-buildimage/build_debian.sh L426-433 で network_setup.sh / hook の initramfs 配置を確認 (verified at: 2026-05-09)。

kdump リモート転送（SSH）¶

なぜリモート転送が必要なのか¶

SONiC のカーネルクラッシュダンプは従来 ローカル /var/crash/ にしか保存できなかった。スイッチ側ストレージが小さい / 圧迫されると core を取り逃す。本機能は SSH 経由でリモートサーバへ core dump を転送 し、専用サーバへ集約するためのもの¹。

どう動くのか¶

kdump は kernel panic 後の secondary kernel (crash kernel) で動作する。通常運用のネットワーク設定はその上で使えないため、専用の network 初期化スクリプトを crash kernel に同梱する¹。

sequenceDiagram
    participant K as Production kernel
    participant CK as Crash kernel
    participant NW as network_setup.sh
    participant SSH as Remote server
    K-->>CK: panic → kexec
    CK->>NW: initramfs hook
    NW->>NW: NIC up + DHCP
    CK->>SSH: ssh -i ssh_path ssh_string<br/>core を stream
    CK->>CK: reboot

認証は SSH 公開鍵のみ。ssh-keygen で鍵対を作り ssh-copy-id でリモートに登録するパスワードレス前提¹。

何が追加・変更されるのか¶

ファイル	内容
`build_debian.sh`	`network_setup.sh` / hook を image に同梱
`files/scripts/network_setup.sh`	crash kernel で NIC up + DHCP
`files/scripts/network_setup.hook`	initramfs hook
`hostcfgd` の KDUMP handler	新 attribute を kdump-tools 設定に反映
`sonic-kdump.yang`	`remote` / `ssh_string` / `ssh_path` leaf 追加

CONFIG_DB / CLI¶

KDUMP|config に既存 enabled / memory / num_dumps に加え以下を追加¹:

remote     : "true" | "false"
ssh_string : "username@serverip"
ssh_path   : "/path/to/ssh_private_key"

Command	用途
`config kdump remote enable` / `disable`	on/off
`config kdump remote add ssh_string <user@host>`	接続先
`config kdump remote add ssh_path <path>`	秘密鍵
`config kdump remove ssh_string` / `ssh_path`	削除
`show kdump config`	設定確認

設定例:

ssh-keygen
ssh-copy-id dumper@10.0.0.50
sudo config kdump remote add ssh_string dumper@10.0.0.50
sudo config kdump remote add ssh_path /home/admin/.ssh/id_rsa
sudo config kdump remote enable
show kdump config

制限事項¶

kdump 関連の設定変更は 常に cold reboot が必要¹
crash kernel 内で DHCP 取得が前提。静的 IP 環境は network_setup.sh の改造必須
パスワード認証は 範囲外（鍵のみ）
鍵 rotate の自動更新は範囲外（ssh_path を手動更新）
SAI API 変更なし¹

干渉する機能¶

hostcfgd（CONFIG_DB → kdump-tools 反映）/ kdump-tools (Debian) / kexec / initramfs network_setup / 既存 KDUMP.enabled / memory / num_dumps。

トラブルシューティング¶

core が届かない → 再起動後の /var/crash/、kdump-tools status、crash kernel の syslog
認証エラー → ssh -i <ssh_path> <ssh_string> を手動で疎通、リモート ~/.ssh/authorized_keys 確認
show kdump config 反映されない → cold reboot 実施有無

コマンド例¶

kdump の remote SSH 設定と動作を確認する。

show kdump status
show kdump remote
config kdump remote enable
cat /etc/default/kdump-tools