コンテンツにスキップ

DHCPV4_RELAY テーブル

概要

DHCPv4 relay agent の VLAN 単位設定を保持する1。DEVICE_METADATA.has_sonic_dhcpv4_relay = true のとき sonic-dhcpv4-relay (新実装) が読み出し、relay agent を構成する。link-selection、server-id-override、VRF selection、source interface 指定をサポートする。

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

flowchart LR
  CDB[("CONFIG_DB<br/>DHCPV4_RELAY")]
  DM["sonic-dhcpv4-relay"]
  CDB --> DM

凡例

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

key 構造

DHCPV4_RELAY|<name>

<name> は Vlan<id> 形式（VLAN 名）。

フィールド一覧

フィールド 型 必須 デフォルト 説明
name (key) string Vlan<id> ✅ - VLAN 名
dhcpv4_servers leaf-list ipv4-address (min 1) ✅ - リレー先 DHCPv4 サーバ
server_vrf leafref VRF.name - - サーバ側 VRF。設定時は link_selection、server_id_override、vrf_selection が enable 必須 (must)
source_interface union (PORT / PORTCHANNEL / VLAN / LOOPBACK) - - リレーパケットの source IP を決める IF
link_selection mode-status - disable RFC 3527 Link selection sub-option
server_id_override mode-status - disable RFC 5107 server-id override
vrf_selection mode-status - disable RFC 6607 VRF selection
その他 - - - （詳細は YANG 直参照）

値依存挙動マトリクス

値 挙動
disable (デフォルト) Link Selection Sub-option なし
enable RFC 3527 Link Selection Sub-option をリレーパケットに付与（dhcp4relay.cpp:521）
DualToR 環境（is_dualTor=true） 設定値に関わらず Link Selection が自動 enable（dhcp4relay.cpp:265）

server_id_override (mode-status: enable/disable)

値 挙動
disable (デフォルト) Server-ID Override なし
enable RFC 5107 Server-ID Override sub-option を付与（dhcp4relay.cpp:530）

vrf_selection (mode-status: enable/disable)

値 挙動
disable (デフォルト) VRF Selection なし
enable RFC 6607 VRF Selection sub-option を付与（dhcp4relay.cpp:540）。server_vrf 必須（YANG must）

dhcpv4_servers (leaf-list, min 1)

値 挙動
1 件以上 dhcp4relay_mgr がサーバリストを設定
0 件 YANG min-elements 違反で reject

制約 (must)

  • server_vrf を指定するなら link_selection = enable かつ server_id_override = enable
  • vrf_selection = enable なら server_vrf 必須

購読者

  • sonic-dhcpv4-relay (新パッケージ) が DEVICE_METADATA.has_sonic_dhcpv4_relay = true のとき
  • 旧来の dhcrelay（VLAN.dhcp_servers 経由）はこのテーブルを使わない

関連 CONFIG_DB / YANG / CLI

  • 関連 CONFIG_DB: VLAN、VLAN_INTERFACE、VRF、LOOPBACK_INTERFACE、DEVICE_METADATA (has_sonic_dhcpv4_relay)
  • 関連 CLI: config dhcp_relay ipv4 add/del
  • 関連 YANG: sonic-dhcpv4-relay

関連リファレンス

引用元

関連 Topics

運用ヒント

典型値

  • key 形式: DHCP_RELAY|<vlan> (DHCPv4 relay)`。
  • dhcp_servers: relay 先 IPv4。source_interface: 任意の SVI / Loopback。

よくある誤設定

  • source_interface に IP が付いていないと relay packet の giaddr が 0 になりサーバが応答しない。

確認コマンド

sonic-db-cli CONFIG_DB keys 'DHCP_RELAY|*'
show dhcprelay_helper ipv4

例外条件・特殊挙動

consumer 条件 挙動
db_migrator DHCPV4_RELAY に dhcpv4_servers が既存 "Skipping migration for {vlan_key}: dhcpv4_servers already present in DHCPV4_RELAY" を出力してスキップ（べき等性）（db_migrator.py:928）
config vlan DHCPV4_RELAY 参照中の VLAN を削除しようとした ctx.fail("{vlan} cannot be removed as it is being used in DHCPV4_RELAY table.") でエラー終了（config/vlan.py:243）
config main DHCPV4_RELAY 参照中の VRF を削除しようとした 削除を拒否（config/main.py:1699-1706）
dhcp_relay CLI 同一サーバ IP を重複追加 既存エントリを get してマージするため重複エントリは発生しない（dhcp_relay.py:601-628）

Evidence: sonic-utilities scripts/db_migrator.py:928; config/vlan.py:242-243; config/main.py:1699-1706; sonic-buildimage dockers/docker-dhcp-relay/cli/config/plugins/dhcp_relay.py:601-628

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