DHCP Relay


nv show service dhcp-relay

Shows the IPv4 DHCP relay configuration on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay
           source-ip  Summary
---------  ---------  -----------------------
+ default  auto       gateway-interface: lo
  default             interface:        swp51
  default             interface:        swp52
  default             interface:        vlan10
  default             server:    172.16.1.102

nv show service dhcp-relay <vrf-id>

Shows the IPv4 DHCP relay configuration in the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay default
                     operational    applied      
-------------------  -------------  -------------
source-ip            auto           auto         
[gateway-interface]  swp2           swp2         
[interface]          peerlink.4094  peerlink.4094
[interface]          swp51          swp51        
[interface]          swp52          swp52        
[interface]          vlan10         vlan10       
[server]             172.16.1.102   172.16.1.102

nv show service dhcp-relay <vrf-id> agent

Shows DHCP Agent Information Option 82 configuration settings.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show service dhcp-relay default agent
                    applied          
------------------  -----------------
[remote-id]         44:38:39:BE:EF:AA
use-pif-circuit-id                   
  enable            on               
enable              on  

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

Shows the remote IDs configured for DHCP Agent Information Option 82.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv show service dhcp-relay default agent remote-id
                    applied          
------------------  -----------------
[remote-id]         44:38:39:BE:EF:AA
use-pif-circuit-id                   
  enable            on               
enable              on

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

Shows information about the specified remote ID configured for DHCP Agent Information Option 82.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<remote-id>The remote name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

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

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

Shows if circuit ID is ON for DHCP Agent Information Option 82.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.7.0

Example

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

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

Shows the IPv4 DHCP relay gateway IP address interface configuration.

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

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<interface-id>The DHCP relay gateway address interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay default gateway-interface swp2
         operational  applied 
-------  -----------  --------
address  10.0.0.4     10.0.0.4

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

Shows IPv4 DHCP relay configuration information for the interface that handles DHCP relay traffic.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<interface-id>The DHCP relay interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay default interface swp1

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

Shows configuration information for the specified IPv4 DHCP server participating in DHCP relay.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<server-id>The DHCP server.

Version History

Introduced in Cumulus Linux 5.0.0

Example

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

nv show service dhcp-relay6

Shows IPv6 DHVP relay configuration information on the switch.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay6
         Summary                            
-------  -----------------------------------
default  interface.downstream: peerlink.4094
         interface.downstream:        vlan10
         interface.upstream:           swp51

nv show service dhcp-relay6 <vrf-id>

Shows IPv6 DHVP relay configuration information in the specified VRF on the switch.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay6 default
                operational    applied      
--------------  -------------  -------------
interface                                   
  [downstream]  peerlink.4094  peerlink.4094
  [downstream]  vlan10         vlan10       
  [upstream]    swp51          swp51        
  [upstream]    swp52          swp52 

nv show service dhcp-relay6 <vrf-id> interface

Shows the IPv6 DHCP relay interface configuration in the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay6 default interface
              operational    applied      
------------  -------------  -------------
[downstream]  peerlink.4094  peerlink.4094
[downstream]  vlan10         vlan10       
[upstream]    swp51          swp51        
[upstream]    swp52          swp52

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

Shows the downstream IPv6 DHCP relay interface configuration.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<interface-id>The DHCP relay interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay6 default interface downstream vlan10

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

Shows the upstream IPv6 DHCP relay interface configuration.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<interface-id>The DHCP relay interface.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show service dhcp-relay6 default interface upstream swp51
                operational      applied        
--------------  ---------------  ---------------
server-address  2001:db8:100::2  2001:db8:100::2