layout-3 layout-6 layout-1 layout-top
NVIDIA Docs Hubchevron_right NVIDIA Networkingchevron_right Networking Softwarechevron_right Switch Softwarechevron_right Cumulus Linuxchevron_right

NVUE Command Reference

layout-top layout-6 layout-1

DHCP Relay

The nv unset commands remove the configuration you set with the equivalent nv set commands. This guide only describes an nv unset command if it differs from the nv set command.

nv set service dhcp-relay <vrf-id> agent enable

Enables DHCP Agent Information Option 82, which allows a DHCP relay to insert circuit or relay specific information into a request that the switch forwards to a DHCP server. You can specify on or off.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set service dhcp-relay default agent enable on

nv set service dhcp-relay <vrf-id> agent remote-id <remote-id>

Sets the remote ID DHCP Agent Information Option 82, which includes information that identifies the relay agent, such as the MAC address. By default, this is the system MAC address of the device on which DHCP relay is running.

Cumulus Linux 5.14 no longer provides this command.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<remote-id> The remote ID, which includes information that identifies the relay agent, such as the MAC address.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set service dhcp-relay default agent remote-id 44:38:39:BE:EF:AA

nv set service dhcp-relay <vrf-id> agent use-pif-circuit-id enable

Enables Circuit ID DHCP Agent Information Option 82, which includes information about the circuit on which the request comes in, such as the SVI or physical port. By default, this is the printable name of the interface that receives the client request. You can specify on or off.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set service dhcp-relay default agent use-pif-circuit-id enable on

nv set service dhcp-relay <vrf-id> downstream-interface <downstream-interface-id> server-group-name

Configures the server group associated with the DHCP relay host facing (downstream) interface.

In Cumulus Linux 5.13 and earlier, DHCP relay does not use server groups.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<downstream-interface-id> The downstream interface name.

Version History

Introduced in Cumulus Linux 5.14.0

Example

cumulus@switch:~$ nv set service dhcp-relay default downstream-interface vlan10 server-group-name type1-server-group

nv set service dhcp-relay <vrf-id> gateway-interface <interface-id>

Configures the gateway IPv4 address on an interface.

In Cumulus Linux 5.4 and earlier, this command is nv set service dhcp-relay <vrf-id> giaddress-interface <interface-id>

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The gateway interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay default gateway-interface lo

nv set service dhcp-relay <vrf-id> gateway-interface <interface-id> address

Configures the IPv4 address on the gateway interface.

In Cumulus Linux 5.4 and earlier, this command is nv set service dhcp-relay <vrf-id> giaddress-interface <interface-id> address <ipv4-address>.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The gateway IP address.
<ipv4-address> The IPv4 address on the gateway interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay default gateway-address-interface address lo 10.10.10.1

nv set service dhcp-relay <vrf-id> interface <interface-id>

Configures the interfaces on which to configure DHCP relay.

Cumulus Linux 5.14 no longer provides this command.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The interface you want to configure.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay default interface swp51

nv set service dhcp-relay <vrf-id> server <server-id>

Configures the DHCP server.

Cumulus Linux 5.14 no longer provides the nv show service dhcp-relay <vrf> server command. You must configure server groups with the nv set service dhcp-relay <vrf-id> server-group <server-group-id\> command.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<server-id> The IPv4 address of the DHCP server.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay default server 172.16.1.102

nv set service dhcp-relay <vrf-id> server-group <server-group-id>

Configures the server group for DHCP relay.

Cumulus Linux uses server groups to receive different DHCP requests on separate interfaces from different end hosts and to relay the requests to specific DHCP servers in a VRF. Server groups provide load balancing and HA, ensuring more resilient DHCP service delivery in case of server failure or maintenance and prevents broadcasting requests to all servers.

  • Server groups do not support IPv6.
  • A server group must contain at least one server and one upstream interface.
  • You must associate a downstream interface with the server group.

In Cumulus Linux 5.13 and earlier, DHCP relay does not use server groups, but instead, forwards all DHCP client requests to every DHCP server within the same VRF. Cumulus Linux 5.14 and later no longer provides the nv show service dhcp-relay <vrf> server commands.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.

Version History

Introduced in Cumulus Linux 5.14.0

Example

cumulus@switch:~$ nv set service dhcp-relay default server-group type1-server-group

nv set service dhcp-relay <vrf-id> server-group <server-group-id> server

Configures the DHCP servers in the server group. A server group must contain at least one DHCP server for a specific VRF.

In Cumulus Linux 5.13 and earlier, DHCP relay does not use server groups, but instead, forwards all DHCP client requests to every DHCP server within the same VRF. Cumulus Linux 5.14 and later no longer provides the nv show service dhcp-relay <vrf> server commands.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.

Version History

Introduced in Cumulus Linux 5.14.0

Example

cumulus@switch:~$

nv set service dhcp-relay <vrf-id> server-group <server-group-id> upstream-interface

Configures the DHCP relay server facing (upstream) interface for the server group. You can specify multiple interfaces.

In Cumulus Linux 5.13 and earlier, DHCP relay does not use server groups, but instead, forwards all DHCP client requests to every DHCP server within the same VRF. Cumulus Linux 5.14 and later no longer provides the nv show service dhcp-relay <vrf> server commands.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<server-group-id> The name of the server group.

Version History

Introduced in Cumulus Linux 5.14.0

Example

cumulus@switch:~$ nv set service dhcp-relay default server-group type1-server-group upstream-interface swp51-52

nv set service dhcp-relay <vrf-id> source-ip

Configures the source IP address to use on the relayed packet. You can specify gateway to use the gateway IP address as the source IP address or auto, where the source IP address of the relayed packet is taken from a layer 3 interface on the switch using normal routing methods. The default setting is auto.

  • This option impacts all relayed IPv4 packets globally.
  • In Cumulus Linux 5.5 and earlier, you specify giaddress instead of gateway.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay default source-ip gateway

nv set service dhcp-relay6 <vrf-id> interface downstream <interface-id>

Configures the DHCP relay downstream interface.

In Cumulus Linux 5.14 and earlier, you must associate the downstream interface with a server group using the nv set service dhcp-relay <vrf> downstream-interface <interface> server-group-name command.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The DHCP relay interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay6 default interface downstream swp1

Configures the IPv6 address on DHCP relay downstream interface.

In Cumulus Linux 5.4 and earlier, the command is nv set service dhcp-relay6 <vrf-id> interface downstream <interface-id> address <ipv6>.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The DHCP relay downstream interface.
<ipv6> The IPv6 address.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay6 default interface downstream swp1 address 2001:db8::1

nv set service dhcp-relay6 <vrf-id> interface upstream <interface-id>

Configures the upstream interface for DHCP relay for IPv6.

Cumulus Linux 5.14 no longer provides the nv show service dhcp-relay <vrf-id> interface upstream <interface-id> command. You must configure server groups with the nv set service dhcp-relay <vrf-id> server-group <server-group-id> upstream-interface <interface-id> command.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The DHCP relay upstream interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay6 default interface upstream swp51

nv set service dhcp-relay6 <vrf-id> interface upstream <interface-id> server-address <ipv6>

Configures the IPv6 address on the DHCP relay upstream interface.

  • In Cumulus Linux 5.4 and earlier, the command is nv set service dhcp-relay6 <vrf-id> interface upstream <interface-id> address <ipv6>.
  • Cumulus Linux 5.14 no longer provides this command.

Command Syntax

Syntax Description
<vrf-id> The VRF you want to configure.
<interface-id> The DHCP relay interface.
<ipv6> The IPv6 address.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set service dhcp-relay6 default interface upstream swp51 server-address 2001:db8:0002::0a00:0002

    Copyright © 2025  NVIDIA Corporation