コンテンツにスキップ

MGMT_PORT テーブル

概要

帯域外管理 (out-of-band) ポート (eth0, eth1, ...) の物理プロパティを保持する1。hostcfgd が読み出して Linux 側の /etc/network/interfaces を更新する。

データフロー (自動生成)

flowchart LR
  CDB[("CONFIG_DB<br/>MGMT_PORT")]
  DM["mgmt-framework"]
  CDB --> DM

凡例

CONFIG_DB から SAI までの典型経路を docs/reference/config-db-orch-map.md から機械生成したミニ図。詳細・例外は本ページ本文と対応表を参照。

key 構造

MGMT_PORT|<name>

<name> は正規表現 eth([1-3][0-9]{3}|[1-9][0-9]{2}|[1-9][0-9]|[0-9]) に合致する管理 IF 名（例: eth0）。

フィールド一覧

フィールド 型 必須 デフォルト 説明
name (key) string eth\d+ ✅ - 管理 IF 名
speed uint16 (10/100/1000) - - 速度 [Mbps]
autoneg string on/off - - 自動ネゴシエーション
alias string - - 別名
description string - - 説明
mtu uint16 (1500..9216) - 1500 MTU
admin_status admin_status - up 管理状態

購読者

  • hostcfgd: /etc/network/interfaces への展開、ifconfig / ethtool 系操作
  • sonic-host-services

関連 CONFIG_DB / YANG / CLI

  • 関連 CONFIG_DB: MGMT_INTERFACE（IP 設定）、MGMT_VRF_CONFIG（mgmt VRF）
  • 関連 CLI: config interface speed/mtu eth0 ...
  • 関連 YANG: sonic-mgmt_port

関連リファレンス

引用元

運用ヒント

典型値

  • key 形式: MGMT_PORT|eth0。
  • admin_status: up、alias: eth0、description: 任意の説明。

よくある誤設定

  • MGMT_PORT を down にすると SSH 経由で復旧不能になり物理 console が必要になる。

確認コマンド

sonic-db-cli CONFIG_DB hgetall 'MGMT_PORT|eth0'
show management_interface address

例外条件・特殊挙動

  • speed が 10/100/1000 以外 → YANG が拒否: range "10|100|1000" で管理ポートの速度を制約。Mbps 単位で指定し、それ以外の値は YANG バリデーションで拒否される。
  • autoneg が "on"/"off" 以外 → YANG が拒否: pattern "on|off" による制約。
  • MTU が 1500-9216 の範囲外 → YANG が拒否 (デフォルト 1500): range "1500..9216" / default 1500。フィールド省略時は 1500 バイトとして扱われる。
  • admin_status のデフォルト = "up": default up。省略時は管理ポートが有効状態として扱われる。
  • インターフェース名の制約: pattern 'eth([1-3][0-9]{3}|[1-9][0-9]{2}|[1-9][0-9]|[0-9])'。eth0 系のみ許可され、不正名は YANG バリデーションで拒否される。

値依存挙動マトリクス

フィールド 値 挙動
admin_status up (default) eth0 を管理状態 UP に設定
admin_status down eth0 を管理状態 DOWN に設定。OOB 管理が切断される
speed 10/100/1000 ethtool で該当速度を強制設定
speed 未設定 ethtool 速度設定なし (autoneg 任せ)
autoneg on ethtool でオートネゴシエーション有効化
autoneg off ethtool でオートネゴシエーション無効化。speed 指定を推奨
mtu 1500 (default) eth0 MTU を 1500 に設定
mtu 1501..9216 eth0 MTU を指定値に設定 (Jumbo frame)

enum: admin_status = up/down。

  1. YANG 定義: sonic-mgmt_port.yang. https://github.com/sonic-net/sonic-buildimage/blob/9ea932ec2e18f35e58268ec2e4456b1d4afd65cd/src/sonic-yang-models/yang-models/sonic-mgmt_port.yang ↩