Skip to content

[doc][dhcp6relay] Add VRF support to the DHCPv6 relay HLD - #2424

Open
AnantKishorSharma wants to merge 2 commits into
sonic-net:masterfrom
AnantKishorSharma:dhcp6relay-vrf-hld
Open

[doc][dhcp6relay] Add VRF support to the DHCPv6 relay HLD#2424
AnantKishorSharma wants to merge 2 commits into
sonic-net:masterfrom
AnantKishorSharma:dhcp6relay-vrf-hld

Conversation

@AnantKishorSharma

@AnantKishorSharma AnantKishorSharma commented Jun 30, 2026

Copy link
Copy Markdown

Why I did it

Document VRF support for the SONiC-native DHCPv6 relay (dhcp6relay) — reaching DHCPv6 servers through a non-default VRF.

How I did it

Added a VRF Support section to the DHCPv6 relay HLD covering:

  • Option A — a relay VLAN in a non-default VRF: the per-VLAN upstream socket is bound to the VLAN's VRF (SO_BINDTODEVICE).
  • Option B — an explicit server_vrf on the DHCP_RELAY row: a shared per-VRF upstream socket is opened and relay-reply demultiplexed by link-address.
  • CONFIG_DB schema, the server_vrf YANG leaf, runtime binding via the config manager (no container restart), and backward compatibility (opt-in; default behavior unchanged).

How to verify it

Documentation only.

Stacked on #2402 — until #2402 merges this PR's diff also shows its commit; it will be rebased to a clean diff afterwards.

Relates to sonic-net/sonic-dhcp-relay#89


Related PRs:

Repo PR title State
sonic-dhcp-relay dhcp6relay: Add VRF support for upstream sockets (VLAN vrf and server_vrf) state
sonic-buildimage docker-dhcp-relay: Add server_vrf to the DHCPv6 relay YANG and config CLI state

@AnantKishorSharma

Copy link
Copy Markdown
Author

@Xichen96 @yaqiangz @jcaiMR @saiarcot895 @yxieca @kellyyeh - Please review when you have a chance.

@mssonicbld

Copy link
Copy Markdown
Collaborator

/azp run

@azure-pipelines

Copy link
Copy Markdown
No pipelines are associated with this pull request.

…sign

The SONiC-native DHCPv6 relay agent reads the DHCP_RELAY table once at
startup and requires a dhcp_relay container restart for any subsequent
relay configuration change. A container restart is disruptive because it
tears down relay state for every VLAN.

Signed-off-by: Anant Kishor Sharma <anant.kishor-sharma@hpe.com>
Document VLAN-VRF and server_vrf upstream-socket binding (SO_BINDTODEVICE), applied at runtime without a container restart. Relates to sonic-net/sonic-dhcp-relay#89.

Signed-off-by: Anant Kishor Sharma <anant.kishor-sharma@hpe.com>
@mssonicbld

Copy link
Copy Markdown
Collaborator

/azp run

@azure-pipelines

Copy link
Copy Markdown
No pipelines are associated with this pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants