Topics で読み物として読む
この HLD は実装詳細を含みます。機能の概念・設定・運用を読み物として読みたい場合は Topics 12 章: Multi-ASIC / VoQ / Chassis を参照。
裏取りステータス: Code-verified
sonic-buildimage src/sonic-py-common/sonic_py_common/device_info.py L43 CHASSIS_DB_CONF_FILENAME = "chassisdb.conf"、L261/L265 で chassis_db_conf_path 候補列挙、L622 is_chassis_config_absent()、L630-635 is_voq_chassis() で switch_type ∈ {voq, fabric} かつ not is_chassis_config_absent() の判定（chassisdb.conf 存在チェックで single-ASIC VoQ を区別）を確認。L668 is_chassis() で voq+disagg 除外 / packet / virtual を OR 結合。bgpcfgd 側は src/sonic-bgpcfgd/bgpcfgd/managers_device_global.py L241 と bgpcfgd/main.py L112 で device_info.is_chassis() 分岐、テストデータ tests/data/sonic-cfggen/bgpd.main.conf.j2/voq_chassis.json L7 で chassisdb_conf_present フラグを確認（verified at: 2026-05-09）。
単一 ASIC VoQ 固定システム（chassisdb.conf による is_voq_chassis 分岐）¶
概要¶
VoQ（Virtual Output Queue）アーキテクチャはこれまで マルチ ASIC のシャーシシステム でのみ前提とされ、Chassis DB（chassisdb.conf の有無で識別される）を経由した system port 共有・iBGP メッシュ・midplane などの仕組みに強く依存していた1。
本 HLD は VoQ 機能を 単一 ASIC の固定システム にも持ち込む構成（single-ASIC VoQ）の差分を定義する。switch type voq をシャーシ／非シャーシで 共用 し、Chassis DB の存在で動作を分岐する設計思想を取る1。
主要原則1:
- Chassis DB に依存しない VoQ 動作 が単一 ASIC では必須
- iBGP メッシュ、line card 拡張、midplane など シャーシ固有設定は生成しない
system_portsは依然として必要（ローカルポートに対してのみ）。fabric_portsも統計取得のため残すinbandポートは作らない
動作仕様¶
振り分けキー: chassisdb.conf の存在¶
シャーシ／単一 ASIC を判定するための単一の signal は chassisdb.conf の存在。sonic-py-common/device_info.is_voq_chassis() を このファイルの存在チェックに改修 する1。
platform.env に既存の disaggregated_chassis フラグもあるが、本機能では Chassis DB を使わないため使用しない1。
flowchart TD
S[起動] --> Q{chassisdb.conf 存在?}
Q -->|Yes| C[Chassis VoQ 経路<br>ChassisDbMgr 起動<br>iBGP mesh 生成<br>midplane / line card 等]
Q -->|No| SA[Single-ASIC VoQ 経路<br>Chassis DB 接続なし<br>iBGP 生成なし<br>system_ports / fabric_ports は残す]Orchagent¶
- VoQ 機能（
system_port作成等）は両モードで実行する - Chassis DB への接続は
is_voq_chassis()が True のときのみ - 単一 ASIC モードでは inband ポートを探さない ように修正1
fabric_portsの有効化と統計収集は単一 ASIC でも継続
Bgpconfd¶
ChassisDbMgrはシャーシ系でのみ起動。is_voq_chassis()の判定でスキップする1。- iBGP メッシュ用の自動生成設定（
BGP_VOQ_CHASSIS_NEIGHBOR等）は生成不要
sonic-utilities¶
| 機能 | Chassis VoQ | Single-ASIC VoQ |
|---|---|---|
| Line card 拡張サポート | ✅ | ❌ |
| internal/external BGP 区別 | ✅ | ❌（local のみ） |
| Fabric port status を Chassis DB から取得 | ✅ | ❌（ローカル取得） |
| Multi-ASIC チェック | True | 必ず False |
is_voq_chassis() を CLI 各コマンドで参照し、Chassis 専用ロジックをスキップする1。
sonic-host-services / caclmgrd¶
caclmgrd の midplane トラフィック 関連 ACL 生成は Chassis VoQ でのみ動作させる1。
CLI¶
show chassis 系コマンドは is_chassis() / is_voq_chassis() のいずれかが True のときだけ表示する1。単一 ASIC VoQ でも is_voq_chassis() を返したいかどうかが微妙な点だが、HLD 表記では「Chassis 系の出力は本機能では出さない」前提に読める。
Config 生成¶
minigraph→config 変換側で、シャーシ系の自動生成（iBGP peer、internal peers、midplane）は chassis フラグが立っているときだけ 行う。単一 ASIC VoQ ではスキップ1。
📋 検証エビデンス: sonic-net/SONiC/doc/voq/single_asic_voq.md#L119-L147 (sha: 49bab5b5ff0e924f1ea52b3d9db0dfa4191a7c06)
出典:
sonic-net/SONiC/doc/voq/single_asic_voq.md#L119-L147 (sha: 49bab5b5ff0e924f1ea52b3d9db0dfa4191a7c06)
抜粋:
This method reuses the voq switch type for non chassis systems as well.
... API is_voq_chassis will check for the presence of the chassisdb.conf file.
... Orchagent will handle VOQ functionality the same way i.e. creation of system ports.
But connect to Chassis DB only if chassis DB is supported in the sonic system.
判断根拠: chassisdb.conf による分岐方式と、Orchagent の chassis-DB 接続条件の根拠。
設定¶
関連する CONFIG_DB / YANG¶
該当なし。判定は /etc/sonic/chassisdb.conf の有無 で行う。
関連する CLI¶
| CLI | 単一 ASIC VoQ での挙動 |
|---|---|
show chassis 系 |
表示しない（または最小限） |
show interface / show fabric-ports 系 |
local データのみ |
show ip bgp summary |
internal/external 区別なし |
制限事項¶
disaggregated_chassisフラグは使わない: 既存フラグが似た用途を匂わせるが、HLD は本機能で 使用しない と明記している1。is_voq_chassis()のセマンティクス変化: 既存呼び出し元が「VoQ シャーシかどうか」と「VoQ 全般か」のどちらを意図していたかでバグになりうる。改修先はchassisdb.confの有無のみを見る1。- inband ポート不在: シャーシで前提だった inband 経路を使う他コードパスは単一 ASIC VoQ で例外的に扱う必要がある1。
- HLD は 2025-08 の比較的新しい改訂: 改修は進行中の可能性が高く、master との差分の方向は「未実装かもしれない」が中心1。
干渉する機能¶
BGP_VOQ_CHASSIS_NEIGHBOR: 単一 ASIC VoQ では生成されない。CONFIG_DB 上に空のまま。- fabric port 統計: 単一 ASIC VoQ でも
fabric_portsは残す方針1。fabricstat系コマンドの挙動が両モードで微妙に違いうる。 - mirror orch: HLD Rev 1.3 で「neighbors and mirror orch の詳細を追加」と言及されているが、本ファイルの本文側には mirror orch の具体差分は明記されていない（追加更新で記載される想定）1。
トラブルシューティング¶
- 単一 ASIC VoQ 機種なのに Chassis 系挙動になる:
/etc/sonic/chassisdb.confの存在を確認。誤って配備されていないか。 - iBGP 設定が生成されてしまう:
is_voq_chassis()が True を返している可能性。改修版の判定ロジックが効いているかを確認。 fabric_portsが表示されない: 単一 ASIC VoQ でも残す前提のため、orchagent の fabric ポート列挙経路を確認。
コマンド例¶
multi-ASIC / VoQ chassis の各 namespace 状態を確認する。
# multi-ASIC / VoQ chassis
show chassis modules status
show platform summary
sudo ip netns list
for ns in $(sudo ip netns list | awk '{print $1}'); do
echo "== $ns =="
sudo ip netns exec "$ns" show interfaces status | head
done