Navigation
Supported Platforms
Related Documentation
dhcp-relay
Syntax
dhcp-relay {active-server-group server-group-name;authentication {password password-string;username-include {circuit-type;delimiter delimiter-character;domain-name domain-name-string;interface-name;logical-system-name;mac-address;option-60;option-82 <circuit-id> <remote-id>;routing-instance-name;user-prefix user-prefix-string;}}dhcpv6 {active-server-group server-group-name;authentication {password password-string;username-include {circuit-type;client-id;delimiter delimiter-character;domain-name domain-name-string;interface-name;logical-system-name;relay-agent-interface-id;relay-agent-remote-id;relay-agent-subscriber-id;routing-instance-name;user-prefix user-prefix-string;}}dynamic-profile profile-name {aggregate-clients (merge | replace);use-primary primary-profile-name;}group group-name {active-server-group server-group-name;authentication {...}dynamic-profile profile-name {...}interface interface-name {exclude; liveness-detection {failure-action (clear-binding | clear-binding-if-interface-up | log-only);method {bfd {version (0 | 1 | automatic);minimum-interval milliseconds;minimum-receive-interval milliseconds;multiplier number;no-adaptation;transmit-interval {minimum-interval milliseconds;threshold milliseconds;}detection-time {threshold milliseconds;}session-mode(automatic | multihop | singlehop);holddown-interval milliseconds;}}}overrides {...}relay-option {...}service-profile dynamic-profile-name;trace;upto upto-interface-name;}service-profile dynamic-profile-name;}overrides {...}relay-agent-interface-id {...}relay-option {...}service-profile dynamic-profile-name;liveness-detection {failure-action (clear-binding | clear-binding-if-interface-up | log-only);method {bfd {version (0 | 1 | automatic);minimum-interval milliseconds;minimum-receive-interval milliseconds;multiplier number;no-adaptation;transmit-interval {minimum-interval milliseconds;threshold milliseconds;}detection-time {threshold milliseconds;}session-mode(automatic | multihop | singlehop);holddown-interval milliseconds;}}}overrides {allow-snooped-clients;interface-client-limit number;no-allow-snooped-clients;no-bind-on-request;send-release-on-delete;}relay-agent-interface-id {prefix prefix;use-interface-description (logical | device):}server-group {server-group-name {server-ip-address;}}duplicate-clients-on-interface;dynamic-profile profile-name {aggregate-clients (merge | replace);use-primary primary-profile-name;}forward-snooped-clients (all-interfaces | configured-interfaces | non-configured-interfaces);group group-name {active-server-group server-group-name;authentication {...}dynamic-profile profile-name {...}interface interface-name {exclude; liveness-detection {failure-action (clear-binding | clear-binding-if-interface-up | log-only);method {bfd {version (0 | 1 | automatic);minimum-interval milliseconds;minimum-receive-interval milliseconds;multiplier number;no-adaptation;transmit-interval {minimum-interval milliseconds;threshold milliseconds;}detection-time {threshold milliseconds;}session-mode(automatic | multihop | singlehop);holddown-interval milliseconds;}}}overrides {...}service-profile dynamic-profile-name;trace;upto upto-interface-name;}overrides {...}relay-option {...}relay-option-82 {...}service-profile dynamic-profile-name;}liveness-detection {failure-action (clear-binding | clear-binding-if-interface-up | log-only);method {bfd {version (0 | 1 | automatic);minimum-interval milliseconds;minimum-receive-interval milliseconds;multiplier number;no-adaptation;transmit-interval {minimum-interval milliseconds;threshold milliseconds;}detection-time {threshold milliseconds;}session-mode(automatic | multihop | singlehop);holddown-interval milliseconds;}}}overrides {allow-snooped-clients;always-write-giaddr;always-write-option-82;client-discover-match <option60-and-option82>;disable-relay;interface-client-limit number;layer2-unicast-replies;no-allow-snooped-clients;no-arp;no-bind-on-request;proxy-mode;replace-ip-source-with; send-release-on-delete;trust-option-82;}relay-option {option-number option-number;default-action {drop;forward-only; relay-server-group group-name;}equals (ascii ascii-string | hexadecimal hexadecimal-string) {drop;forward-only; relay-server-group relay-server-group;}starts-with (ascii ascii-string | hexadecimal hexadecimal-string) {drop;forward-only; local-server-group local-server-group;relay-server-group relay-server-group;}}relay-option-82 {circuit-id {prefix prefix;use-interface-description (logical | device);}}server-group {server-group-name {server-ip-address;}}service-profile dynamic-profile-name;}
Hierarchy Level
[edit forwarding-options],[edit logical-systems logical-system-name forwarding-options],[edit logical-systems logical-system-name routing-instances routing-instance-name forwarding-options],[edit routing-instances routing-instance-name forwarding-options]
Release Information
Statement introduced in Junos OS Release 8.3.
Description
Configure extended Dynamic Host Configuration Protocol (DHCP) relay and DHCPv6 relay options on the router and enable the router to function as a DHCP relay agent. A DHCP relay agent forwards DHCP request and reply packets between a DHCP client and a DHCP server.
DHCP relay supports the attachment of dynamic profiles and also interacts with the local AAA Service Framework to use back-end authentication servers, such as RADIUS, to provide subscriber authentication. You can attach dynamic profiles and configure authentication support on a global basis or for a specific group of interfaces.
The extended DHCP and DHCPv6 relay agent options configured with the dhcp-relay and dhcpv6 statements are incompatible with the DHCP/BOOTP relay agent options configured with the bootp statement. As a result, the extended DHCP or DHCPv6 relay agent and the DHCP/BOOTP relay agent cannot both be enabled on the router at the same time.
The remaining statements are explained separately.
Required Privilege Level
interface—To view this statement in the configuration.
interface-control—To add this statement to the configuration.
