コンテンツにスキップ

STATE_DB LAG_TABLE (PortChannel 状態)

概要

PortChannel (LAG) のランタイム状態を STATE_DB に保持するテーブル1。sonic-swss の teamsyncd が Linux カーネルの netlink NEWLINK イベントを受信したときに主フィールドを書き込み、tlm_teamd が teamdctl の JSON dump を定期的に解析して補助フィールドを追記する。このテーブルは観測専用（書き込みは teamsyncd / tlm_teamd のみ）であり、intfmgrd・vlanmgr・nbrmgrd・stpmgrd が LAG の準備完了チェックに参照する。

CONFIG_DB の PORTCHANNEL テーブルとは別テーブルであり、こちらは設定ではなく実行時状態を格納する。

key 構造

LAG_TABLE|<lag_name>
  • <lag_name>: LAG インタフェース名。形式は PortChannel<0-9999>（例: PortChannel0001）
  • テーブル名定数: STATE_LAG_TABLE_NAME = "LAG_TABLE" (sonic-swss-common/common/schema.h:422)

フィールド

teamsyncd 書き込みフィールド

TeamSync::addLag() (teamsync.cpp:L146-176) が Linux netlink から取得した実測値で書き込む。

フィールド 型 初期値 説明
admin_status enum string カーネル実測値 管理状態。"up" (IFF_UP) または "down"
oper_status enum string カーネル実測値 運用状態。"up" (IFF_LOWER_UP) または "down"
mtu uint string カーネル実測値 MTU 値 (文字列)。カーネルの rtnl_link_get_mtu() から取得
state enum string "ok" LAG の初期化状態。常に "ok" を書き込む。エラー時はエントリ削除

tlm_teamd 追記フィールド

ValuesStore::m_lag_paths (values_store.h:L48-56) が teamdctl の JSON dump を解析して追記する。

フィールド (JSON パス) 型 説明
setup.kernel_team_mode_name string teamd が使用する runner モード名（例: "lacp"）
setup.pid integer string teamd プロセスの PID
runner.active boolean string LAG がアクティブ（ポート集約中）かどうか
runner.fallback boolean string LACP fallback が有効か (PORTCHANNEL.fallback を反映)
runner.fast_rate boolean string LACP fast rate が有効か (PORTCHANNEL.fast_rate を反映)
team_device.ifinfo.dev_addr string LAG の MAC アドレス
team_device.ifinfo.ifindex integer string LAG の ifindex

STATE_DB に書かれないフィールド

CONFIG_DB PORTCHANNEL の min_links・lacp_key・mode・tpid・description は STATE_DB LAG_TABLE には書き込まれない。これらは teammgrd が teamd の設定ファイル生成に使用するのみ。

state フィールドの状態遷移

stateDiagram-v2
    [*] --> ok : RTM_NEWLINK (TeamSync::addLag)
    ok --> [*] : RTM_DELLINK (TeamSync::removeLag)
state 値 意味
"ok" LAG が teamsyncd に認識されており、teamd 初期化成功
(エントリなし) LAG が削除または teamd 初期化に失敗した状態

エラー状態（"error" 等）は存在しない。失敗時は SWSS_LOG_ERROR を出力してエントリを書き込まない。

書き込みタイミング

  1. LAG 追加時 (teamsync.cpp:L146-225): RTM_NEWLINK イベントで LAG タイプ (team) を検出すると addLag() を呼び出し、m_stateLagTable.set(lagName, fvVector) で全フィールドを書き込む。state = "ok" を含む。
  2. LAG 更新時 (同上): admin_state / oper_state / mtu が変化したときも addLag() を呼び出してフィールドを更新する。
  3. LAG 削除時 (teamsync.cpp:L228-259): RTM_DELLINK イベントで removeLag() を呼び出し、m_stateLagTable.del(lagName) でエントリを削除する。
  4. Warm restart (teamsync.cpp:L84-98): warm restart 時は直接書き込まず m_stateLagTablePreserved に一時保存し、タイムアウト後に applyState() で一括書き込む。
  5. tlm_teamd 定期更新 (tlm_teamd/main.cpp): teamdctl で LAG の JSON dump を取得し、ValuesStore::update() で tlm_teamd フィールドを STATE_DB に反映する。

購読者

  • intfmgrd (cfgmgr/intfmgr.cpp:L38,L51): LAG インタフェース設定前に isLagStateOk() でエントリ存在確認
  • vlanmgrd (cfgmgr/vlanmgr.cpp:L497): LAG を VLAN メンバに追加する前に LAG state を確認
  • nbrmgrd (cfgmgr/nbrmgr.cpp:L47): 隣接エントリ処理前に LAG state を確認
  • stpmgrd (cfgmgr/stpmgr.cpp:L1296): STP ポート処理前に LAG state を確認
  • tlm_teamd (tlm_teamd/main.cpp:L98): SubscriberStateTable で変化を監視し teamdctl dump を同期

関連 CONFIG_DB / CLI

  • 設定元: PORTCHANNEL (CONFIG_DB)
  • メンバ管理: PORTCHANNEL_MEMBER (CONFIG_DB)
  • 確認コマンド: show interfaces portchannel、teamdctl <lag_name> state

フィールド暗黙デフォルト (Phase A — コード由来)

STATE_DB LAG_TABLE に対応する YANG schema は存在しない。すべてのフィールドとデフォルト値は teamsync.cpp および values_store.h のコードレベルで定義される。

フィールド STATE_DB 初期値 コード由来 備考
admin_status カーネル IFF_UP フラグから実測 rtnl_link_get_flags(link) & IFF_UP — teamsync.cpp:L115,L151 固定デフォルトなし。カーネル実測値を "up" / "down" に変換
oper_status カーネル IFF_LOWER_UP フラグから実測 rtnl_link_get_flags(link) & IFF_LOWER_UP — teamsync.cpp:L116,L152 固定デフォルトなし。LAG メンバが集約されると "up" になる
mtu カーネル実測 MTU 値の文字列 rtnl_link_get_mtu(link) — teamsync.cpp:L140,L153 カーネル側初期値は portmgr.h の DEFAULT_MTU_STR = "9100" だが STATE_DB は実測値を反映
state "ok" FieldValueTuple s("state", "ok") — teamsync.cpp:L175 常に "ok" のみ。teamd 初期化失敗時はエントリ自体を書かない
setup.kernel_team_mode_name "lacp" (LACP モード時) teamdctl JSON setup.kernel_team_mode_name — values_store.h:L49 teamd が使用する runner モード。CONFIG_DB 設定次第
setup.pid teamd の実プロセス PID teamdctl JSON setup.pid — values_store.h:L50 固定値なし。teamd spawn ごとに変化
runner.active "false" → ポート集約後 "true" teamdctl JSON runner.active — values_store.h:L51 LACP ネゴシエーション完了後に "true" へ遷移
runner.fallback "false" (未設定時) teamdctl JSON runner.fallback — values_store.h:L52 CONFIG_DB PORTCHANNEL.fallback = true のときのみ "true"
runner.fast_rate "false" (未設定時) teamdctl JSON runner.fast_rate — values_store.h:L53 CONFIG_DB PORTCHANNEL.fast_rate = true のときのみ "true"
team_device.ifinfo.dev_addr LAG 作成時の MAC アドレス teamdctl JSON team_device.ifinfo.dev_addr — values_store.h:L54 固定値なし。システム MAC またはユーザー指定値
team_device.ifinfo.ifindex LAG 作成時の ifindex teamdctl JSON team_device.ifinfo.ifindex — values_store.h:L55 固定値なし。カーネルが割り当てた整数値

補足

  • admin_status / oper_status / mtu はカーネルの netlink 実測値であり、コードレベルの固定デフォルトは存在しない。システム起動直後の LAG の典型的な初期値は admin_status = "down"、oper_status = "down"、mtu = "9100"（portmgr.h の DEFAULT_MTU_STR がカーネル側に設定されるため）。
  • state = "ok" は teamd 初期化成功を示す唯一の値であり、エラー状態は STATE_DB に書かれない。teamdctl 接続失敗時は SWSS_LOG_ERROR を記録し STATE_DB への書き込みをスキップする (teamsync.cpp:L208-213)。
  • tlm_teamd フィールド（setup.*、runner.*、team_device.*）は teamdctl の JSON dump に完全に依存する。tlm_teamd が dump 取得に失敗しても LAG_TABLE エントリは teamsync.cpp 書き込み分が残留する（values_store.cpp:L284-291 で LAG_TABLE のエントリは削除しない設計）。
  • YANG schema が存在しないため、フィールドの型・範囲はすべてコードレベルで実施される。

引用元

確認コマンド

sonic-db-cli STATE_DB keys 'LAG_TABLE|*'
sonic-db-cli STATE_DB hgetall 'LAG_TABLE|PortChannel0001'
show interfaces portchannel
teamdctl PortChannel0001 state

  1. sonic-swss/teamsyncd/teamsync.cpp (L26-30 コンストラクタ, L101-143 onMsg, L146-226 addLag, L228-259 removeLag). https://github.com/sonic-net/sonic-swss/blob/4305596156d70e9797e8a881b3d19b46de0bce0d/teamsyncd/teamsync.cpp sonic-swss/tlm_teamd/values_store.h (L48-56 m_lag_paths). https://github.com/sonic-net/sonic-swss/blob/4305596156d70e9797e8a881b3d19b46de0bce0d/tlm_teamd/values_store.h ↩