Skip to content

[doc][dhcp6relay] Add dynamic configuration (no container restart) design#2402

Open
AnantKishorSharma wants to merge 1 commit into
sonic-net:masterfrom
AnantKishorSharma:dhcp6relay-dynamic-config
Open

[doc][dhcp6relay] Add dynamic configuration (no container restart) design#2402
AnantKishorSharma wants to merge 1 commit into
sonic-net:masterfrom
AnantKishorSharma:dhcp6relay-dynamic-config

Conversation

@AnantKishorSharma

@AnantKishorSharma AnantKishorSharma commented Jun 23, 2026

Copy link
Copy Markdown

Why I did it

Document the design for the SONiC-native DHCPv6 relay agent applying relay configuration changes at runtime, without a dhcp_relay container restart.

How I did it

Adds a "Dynamic Configuration (no container restart)" section to the DHCPv6 relay HLD:

  • the Config Manager and the CONFIG_DB / STATE_DB tables it subscribes to,
  • how changes are applied at runtime (add / update / remove reconciliation on the libevent main thread, woken via a self-pipe),
  • backward compatibility,
  • and runtime-reconfiguration test cases.

How to verify it

Documentation only.


Related PRs:

Repo PR title State
sonic-dhcp-relay dhcp6relay: Apply relay config changes at runtime without container restart state
sonic-buildimage docker-dhcp-relay: Start dhcp6relay unconditionally; apply IPv6 relay config at runtime state
sonic-mgmt dhcp_relay: Add dhcp6relay runtime reconfiguration tests state

@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>
@AnantKishorSharma
AnantKishorSharma force-pushed the dhcp6relay-dynamic-config branch from cada117 to 5ae199a Compare July 13, 2026 13:48
@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