MUX_CABLE_TABLE / HW_MUX_CABLE_TABLE (STATE_DB)
概要
Dual-ToR 構成における mux cable の実行時状態は STATE_DB の 2 つのテーブルに分散して保存される。
| テーブル |
書き込み元 |
内容 |
MUX_CABLE_TABLE |
orchagent MuxStateOrch / MuxOrch |
ソフトウェア視点の MUX 状態・neighbor_mode |
HW_MUX_CABLE_TABLE |
ycabled (sonic-ycabled) |
ハードウェア (Y-Cable / gRPC) 視点の forwarding state |
HW_MUX_CABLE_TABLE_PEER |
ycabled |
ピア ToR の hardware forwarding state |
CONFIG_DB.MUX_CABLE が設定テーブルであるのに対し、これらは実行時状態テーブルであり、直接 CLI から書き込むものではない。
本ページは STATE_DB テーブルのフィールド・コード由来デフォルト・書き込みタイミングに焦点を当てる。CONFIG_DB の設定については MUX_CABLE / MUX_CABLE (per-port 詳細) を参照。
key 構造
MUX_CABLE_TABLE|<ifname>
HW_MUX_CABLE_TABLE|<ifname>
HW_MUX_CABLE_TABLE_PEER|<ifname>
<ifname> は server-facing port 名（Ethernet0 等）。
MUX_CABLE_TABLE フィールド (STATE_DB)
| フィールド |
型 |
書き込み元 |
説明 |
state |
string |
MuxStateOrch::updateMuxState (muxorch.cpp:2640) |
MUX ソフトウェア状態 |
neighbor_mode |
string |
MuxOrch::handleMuxCfg (muxorch.cpp:2285) |
neighbor 経路モード |
state の取りうる値
| 値 |
意味 |
書き込みタイミング |
"active" |
当該 ToR が active |
MuxCable 状態機械が ACTIVE に遷移 |
"standby" |
当該 ToR が standby |
MuxCable 状態機械が STANDBY に遷移 |
"init" |
初期化中 (warm restart) |
warm restart 開始時の初期値 |
"pending" |
状態変更待ち中 |
状態遷移中の中間状態 |
"failed" |
状態遷移失敗 |
isStateChangeFailed() が true |
"unknown" |
hw_state と mux_state が不一致 (非 failed) |
HW_MUX_CABLE_TABLE の state と内部 state が乖離 |
"error" |
hw_state と mux_state が不一致 (failed) |
isStateChangeFailed() かつ hw/mux 不一致 |
neighbor_mode の取りうる値
| 値 |
意味 |
"host-route" |
サーバ IP を /32 (/128) host route として処理 (default) |
"prefix-route" |
サーバ IP を prefix-based route として処理 |
HW_MUX_CABLE_TABLE フィールド (STATE_DB)
ycabled が gRPC 経由でハードウェア (Y-Cable / SoC) から取得した forwarding state を保存する。
| フィールド |
型 |
書き込み元 |
説明 |
state |
string |
put_init_values_for_grpc_states / update_table_mux_status_for_statedb_port_tbl |
HW forwarding state |
read_side |
string (integer) |
同上 |
どちらの ToR として読んでいるか (0 or 1) |
active_side |
string |
同上 |
active 側 ToR (state と同値で初期化) |
HW_MUX_CABLE_TABLE.state の取りうる値
| 値 |
意味 |
書き込みタイミング |
"active" |
このポートが HW で active |
gRPC QueryAdminForwardingPortState の応答が active |
"standby" |
このポートが HW で standby |
gRPC 応答が standby |
"unknown" |
gRPC 未確立またはエラー |
stub が None または gRPC 応答なし |
購読者
- linkmgrd:
handleGetMuxState() (DbInterface.cpp:393-401) で MUX_CABLE_TABLE.state を読み取り、内部ステートマシン (processGetMuxState) を更新する。handleSwssNotification() (DbInterface.cpp:1833) で購読。
- MuxStateOrch (orchagent):
HW_MUX_CABLE_TABLE (APP_DB 側) を購読し、hw_state と mux_state を比較して MUX_CABLE_TABLE.state を更新する。
- show mux status (CLI):
STATE_DB MUX_CABLE_TABLE|* と STATE_DB HW_MUX_CABLE_TABLE|* を参照して表示 (show/muxcable.py:724,747)。
関連 CONFIG_DB / YANG / CLI
関連リファレンス
引用元
関連 Topics
運用ヒント
典型的な確認コマンド
# STATE_DB の MUX_CABLE_TABLE 確認
sonic-db-cli STATE_DB hgetall 'MUX_CABLE_TABLE|Ethernet0'
# HW (Y-Cable) の forwarding state 確認
sonic-db-cli STATE_DB hgetall 'HW_MUX_CABLE_TABLE|Ethernet0'
# CLI での表示
show mux status
show mux hwmode muxdirection Ethernet0
よくある問題
state: unknown: hw_state と mux_state が一致していない状態。リンクプローバや gRPC セッションに問題がある可能性がある。show mux status で STATUS (STATE_DB) と SERVER_STATUS (HW_MUX_CABLE_TABLE) を比較する。- HW_MUX_CABLE_TABLE が
unknown のまま: ycabled の gRPC チャネルが確立されていない。soc_ipv4 が CONFIG_DB に設定されているか確認する。
state: init: warm restart 後の初期化完了前。orchagent が APP_DB から状態を取得して更新するまで待機する。
コード由来の暗黙デフォルト (Phase A)
MUX_CABLE_TABLE (STATE_DB)
| フィールド |
YANG定義 |
コード実装の初期値 / fallback |
乖離種別 |
state |
— (state-db, YANG外) |
cold boot: "standby" (muxorch.cpp:445-447); warm restart: "init" (muxorch.cpp:441) |
書込み元依存の初期値 |
state |
— |
hw_state と mux_state が不一致かつ非 failed → "unknown" (muxorch.cpp:2684) |
mismatch 検出値 |
state |
— |
hw_state と mux_state が不一致かつ failed → "error" (muxorch.cpp:2680) |
mismatch + failed 検出値 |
neighbor_mode |
— |
CONFIG_DB の neighbor_mode に基づき初回設定時のみ書き込み。動的変更は orchagent が拒否 (muxorch.cpp:2256) |
初回設定時のみ書込み |
HW_MUX_CABLE_TABLE (STATE_DB)
| フィールド |
YANG定義 |
コード実装の初期値 / fallback |
乖離種別 |
state |
— |
gRPC stub が None → "unknown" (y_cable_helper.py:604) |
gRPC 未確立時 fallback |
state |
— |
gRPC 応答あり → parse_grpc_response_forwarding_state() の返値 (active/standby/unknown) |
gRPC 依存 |
read_side |
— |
Loopback3 から判定。判定不能 → 書き込みスキップ (y_cable_helper.py:633-651) |
設定必須 |
active_side |
— |
初期化時は state と同値 (y_cable_helper.py:624-626) |
state と同値で初期化 |
注記
state = "standby" が cold boot デフォルト: MuxCable オブジェクト生成時、warm restart でない場合は stateStandby() が呼ばれ state_ = MUX_STATE_STANDBY に設定される (muxorch.cpp:445-447)。その後 orchagent が APP_DB の状態を取得して実際の状態に更新する。state = "init" は warm restart 専用の中間状態: warm restart 時は state_ = MUX_STATE_INIT で始まり、APP_DB sync 完了後に "active" または "standby" に遷移する (muxorch.cpp:437-442)。neighbor_mode は MuxPort 初回生成時のみ書き込み: handleMuxCfg() 内で state_mux_cable_table_->hset() を実行するのは新規ポート追加時のみ。既存ポートへの動的変更は "Check if neighbor_mode has changed - dynamic changes are not allowed" コメント (muxorch.cpp:2256) の通り拒否し SWSS_LOG_ERROR を出す。- HW_MUX_CABLE_TABLE の
"unknown" は gRPC 問題のシグナル: soc_ipv4 が CONFIG_DB に設定されていない場合、ycabled は gRPC チャネルを確立せず (y_cable_helper.py:672 の soc_ipv4 in dict 条件)、初期値として "unknown" が書き込まれる。show mux status の SERVER_STATUS 列が unknown の場合はこの状態を疑う。