Relay
This scenario shows how to configure service dhcp-relay. The
relay agent must be used when the DHCP server and the DHCP
clients are not connected to the same layer 2 domain.
Test DHCP Relay
Description
This example demonstrates how to configure a DHCP relay instance in DUT0 to forward DHCP requests from DUT2 to DUT1.
Scenario
Step 1: Set the following configuration in DUT0 :
set interfaces ethernet eth0 vif 100 address 10.0.0.2/24 set interfaces ethernet eth1 vif 200 address 20.0.0.2/24 set service dhcp-relay INS downstream-interface eth1.200 set service dhcp-relay INS server 10.0.0.1 set service dhcp-relay INS upstream-interface eth0.100 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 2: Set the following configuration in DUT1 :
set interfaces ethernet eth0 vif 100 address 10.0.0.1/24 set protocols static route 0.0.0.0/0 next-hop 10.0.0.2 set service dhcp-server shared-network dummy subnet 10.0.0.1/32 set service dhcp-server shared-network remote subnet 20.0.0.0/24 start 20.0.0.50 stop 20.0.0.50 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 3: Set the following configuration in DUT2 :
set interfaces ethernet eth0 vif 200 address dhcp set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 4: Ping IP address 10.0.0.1 from DUT0:
admin@DUT0$ ping 10.0.0.1 count 1 size 56 timeout 1Show output
PING 10.0.0.1 (10.0.0.1) 56(84) bytes of data. 64 bytes from 10.0.0.1: icmp_seq=1 ttl=64 time=0.238 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.238/0.238/0.238/0.000 ms
Step 5: Run command interfaces ethernet show at DUT2 and check if output contains the following tokens:
20.0.0.50Show output
--------------------------------------------------------------------- Name IP Address Admin Oper Vrf Description --------------------------------------------------------------------- eth0 fe80::dcad:beff:feef:6c20/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth1 down down
Test DHCP Relay With Giaddr
Description
This example demonstrates how to set the gateway IP address (giaddr) in the IP address. This value must be set in an IP address that the DHCP server can reach.
Scenario
Step 1: Set the following configuration in DUT0 :
set interfaces ethernet eth0 vif 100 address 10.0.0.2/24 set interfaces ethernet eth1 vif 200 address 20.0.0.2/24 set interfaces ethernet eth1 vif 200 address 20.0.0.3/24 set service dhcp-relay INS downstream-interface eth1.200 set service dhcp-relay INS server 10.0.0.1 giaddr 20.0.0.3 set service dhcp-relay INS upstream-interface eth0.100 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 2: Set the following configuration in DUT1 :
set interfaces ethernet eth0 vif 100 address 10.0.0.1/24 set protocols static route 0.0.0.0/0 next-hop 10.0.0.2 set service dhcp-server shared-network dummy subnet 10.0.0.1/32 set service dhcp-server shared-network remote subnet 20.0.0.0/24 start 20.0.0.50 stop 20.0.0.50 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 3: Set the following configuration in DUT2 :
set interfaces ethernet eth0 vif 200 address dhcp set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 4: Ping IP address 10.0.0.1 from DUT0:
admin@DUT0$ ping 10.0.0.1 count 1 size 56 timeout 1Show output
PING 10.0.0.1 (10.0.0.1) 56(84) bytes of data. 64 bytes from 10.0.0.1: icmp_seq=1 ttl=64 time=0.221 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.221/0.221/0.221/0.000 ms
Step 5: Run command interfaces ethernet show at DUT2 and check if output contains the following tokens:
20.0.0.50Show output
--------------------------------------------------------------------- Name IP Address Admin Oper Vrf Description --------------------------------------------------------------------- eth0 fe80::dcad:beff:feef:6c20/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth1 down down
Step 6: Run command system journal show | cat at DUT1 and check if output matches the following regular expressions:
DHCPACK on 20.0.0.50 to [^\)]+\) via 20.0.0.3Show output
Sep 05 11:37:13.302633 osdx systemd-journald[1555]: Runtime Journal (/run/log/journal/50a598a116a9494aab0ac4ddc8eeff40) is 936.0K, max 6.5M, 5.6M free. Sep 05 11:37:13.306625 osdx systemd-journald[1555]: Received client request to rotate journal, rotating. Sep 05 11:37:13.306687 osdx systemd-journald[1555]: Vacuuming done, freed 0B of archived journals from /run/log/journal/50a598a116a9494aab0ac4ddc8eeff40. Sep 05 11:37:13.314395 osdx OSDxCLI[1828]: User 'admin' executed a new command: 'system journal clear'. Sep 05 11:37:13.523875 osdx OSDxCLI[1828]: User 'admin' executed a new command: 'system coredump delete all'. Sep 05 11:37:15.128789 osdx OSDxCLI[1828]: User 'admin' entered the configuration menu. Sep 05 11:37:15.207143 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set interfaces eth0.100 address 10.0.0.1/24'. Sep 05 11:37:15.292913 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network dummy subnet 10.0.0.1/32'. Sep 05 11:37:15.364444 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network remote subnet 20.0.0.0/24 start 20.0.0.50 stop 20.0.0.50'. Sep 05 11:37:15.485296 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set protocols static route 0.0.0.0/0 next-hop 10.0.0.2'. Sep 05 11:37:15.567687 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'show working'. Sep 05 11:37:15.675347 osdx ubnt-cfgd[111447]: inactive Sep 05 11:37:15.703046 osdx INFO[111457]: FRR daemons did not change Sep 05 11:37:15.722547 osdx kernel: 8021q: adding VLAN 0 to HW filter on device eth0 Sep 05 11:37:15.739865 osdx (udev-worker)[111504]: Network interface NamePolicy= disabled on kernel command line. Sep 05 11:37:17.270912 osdx systemd[1]: Started dhcpd@main.service - "DHCP Server Service instance main". Sep 05 11:37:17.272679 osdx cfgd[1254]: [1828]Completed change to active configuration Sep 05 11:37:17.274087 osdx dhcpd[111578]: Wrote 0 leases to leases file. Sep 05 11:37:17.283874 osdx OSDxCLI[1828]: User 'admin' committed the configuration. Sep 05 11:37:17.555964 osdx OSDxCLI[1828]: User 'admin' left the configuration menu. Sep 05 11:37:17.615791 osdx dhcpd[111578]: Sep 05 11:37:17.615797 osdx dhcpd[111578]: No subnet declaration for eth0 (no IPv4 addresses). Sep 05 11:37:17.615800 osdx dhcpd[111578]: ** Ignoring requests on eth0. If this is not what Sep 05 11:37:17.615802 osdx dhcpd[111578]: you want, please write a subnet declaration Sep 05 11:37:17.615804 osdx dhcpd[111578]: in your dhcpd.conf file for the network segment Sep 05 11:37:17.615806 osdx dhcpd[111578]: to which interface eth0 is attached. ** Sep 05 11:37:17.615808 osdx dhcpd[111578]: Sep 05 11:37:17.638654 osdx dhcpd[111578]: Server starting service. Sep 05 11:37:18.070864 osdx dhcpd[111578]: DHCPDISCOVER from de:ad:be:ef:6c:20 via 20.0.0.3 Sep 05 11:37:19.071094 osdx dhcpd[111578]: DHCPOFFER on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.3 Sep 05 11:37:19.071739 osdx dhcpd[111578]: DHCPREQUEST for 20.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:20 (osdx) via 20.0.0.3 Sep 05 11:37:19.742901 osdx dhcpd[111578]: DHCPACK on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.3
Test DHCP Relay With GRE Tunnel
Description
This example demonstrates how to configure a DHCP relay that forwards DHCP requests to the DHCP server through a GRE tunnel (upstream).
Scenario
Step 1: Set the following configuration in DUT0 :
set interfaces ethernet eth0 vif 100 address 10.0.0.2/24 set interfaces ethernet eth1 vif 200 address 20.0.0.2/24 set interfaces tunnel tun1 address 1.0.0.2/32 set interfaces tunnel tun1 encapsulation gre set interfaces tunnel tun1 local-address 10.0.0.2 set interfaces tunnel tun1 local-interface eth0.100 set interfaces tunnel tun1 nhrp holdtime 5 set interfaces tunnel tun1 nhrp nhs 1.0.0.1 nbma 10.0.0.1 set service dhcp-relay INS downstream-interface eth1.200 set service dhcp-relay INS server 1.0.0.1 set service dhcp-relay INS upstream-interface eth0.100 set service dhcp-relay INS upstream-interface tun1 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 2: Set the following configuration in DUT1 :
set interfaces ethernet eth0 vif 100 address 10.0.0.1/24 set interfaces tunnel tun1 address 1.0.0.1/32 set interfaces tunnel tun1 encapsulation gre set interfaces tunnel tun1 local-address 10.0.0.1 set interfaces tunnel tun1 local-interface eth0.100 set interfaces tunnel tun1 nhrp set protocols static route 0.0.0.0/0 next-hop 10.0.0.2 set protocols static route 20.0.0.0/24 next-hop 1.0.0.2 set service dhcp-server shared-network dummy subnet 1.0.0.1/32 set service dhcp-server shared-network remote subnet 20.0.0.0/24 start 20.0.0.50 stop 20.0.0.50 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 3: Set the following configuration in DUT2 :
set interfaces ethernet eth0 vif 200 address dhcp set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 4: Ping IP address 10.0.0.1 from DUT0:
admin@DUT0$ ping 10.0.0.1 count 1 size 56 timeout 1Show output
PING 10.0.0.1 (10.0.0.1) 56(84) bytes of data. 64 bytes from 10.0.0.1: icmp_seq=1 ttl=64 time=0.154 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.154/0.154/0.154/0.000 ms
Step 5: Ping IP address 1.0.0.1 from DUT0:
admin@DUT0$ ping 1.0.0.1 count 1 size 56 timeout 1Show output
PING 1.0.0.1 (1.0.0.1) 56(84) bytes of data. 64 bytes from 1.0.0.1: icmp_seq=1 ttl=64 time=0.270 ms --- 1.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.270/0.270/0.270/0.000 ms
Step 6: Run command interfaces ethernet show at DUT2 and check if output contains the following tokens:
20.0.0.50Show output
--------------------------------------------------------------------- Name IP Address Admin Oper Vrf Description --------------------------------------------------------------------- eth0 fe80::dcad:beff:feef:6c20/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth1 down down
Test DHCP Relay With Multiple Instances
Description
This example demonstrates how to configure multiple DHCP relay instances.
Scenario
Step 1: Set the following configuration in DUT0 :
set interfaces ethernet eth0 vif 100 address 10.0.0.2/24 set interfaces ethernet eth1 vif 200 address 20.0.0.2/24 set interfaces ethernet eth1 vif 300 address 30.0.0.2/24 set service dhcp-relay INS downstream-interface eth1.200 set service dhcp-relay INS server 10.0.0.1 set service dhcp-relay INS upstream-interface eth0.100 set service dhcp-relay INS2 downstream-interface eth1.300 set service dhcp-relay INS2 server 10.0.0.1 set service dhcp-relay INS2 upstream-interface eth0.100 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 2: Set the following configuration in DUT1 :
set interfaces ethernet eth0 vif 100 address 10.0.0.1/24 set protocols static route 0.0.0.0/0 next-hop 10.0.0.2 set service dhcp-server shared-network dummy subnet 10.0.0.1/32 set service dhcp-server shared-network remote subnet 20.0.0.0/24 start 20.0.0.50 stop 20.0.0.50 set service dhcp-server shared-network remote2 subnet 30.0.0.0/24 start 30.0.0.50 stop 30.0.0.50 set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 3: Set the following configuration in DUT2 :
set interfaces ethernet eth0 vif 200 address dhcp set interfaces ethernet eth0 vif 300 address dhcp set system login user admin authentication encrypted-password '$6$GSjsCj8gHLv$/VcqU6FLi6CT2Oxn0MJQ2C2tqnRDrYKNF8HIYWJp68nvXvPdFccDsT04.WtigUONbKYrgKg8d6rEs8PjljMkH0'
Step 4: Ping IP address 10.0.0.1 from DUT0:
admin@DUT0$ ping 10.0.0.1 count 1 size 56 timeout 1Show output
PING 10.0.0.1 (10.0.0.1) 56(84) bytes of data. 64 bytes from 10.0.0.1: icmp_seq=1 ttl=64 time=0.185 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.185/0.185/0.185/0.000 ms
Step 5: Run command interfaces ethernet show at DUT2 and check if output contains the following tokens:
20.0.0.50Show output
--------------------------------------------------------------------- Name IP Address Admin Oper Vrf Description --------------------------------------------------------------------- eth0 fe80::dcad:beff:feef:6c20/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth0.300 30.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth1 down down
Step 6: Run command interfaces ethernet show at DUT2 and check if output contains the following tokens:
30.0.0.50Show output
--------------------------------------------------------------------- Name IP Address Admin Oper Vrf Description --------------------------------------------------------------------- eth0 fe80::dcad:beff:feef:6c20/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth0.300 30.0.0.50/24 up up fe80::dcad:beff:feef:6c20/64 eth1 down down
Step 7: Run command system journal show | cat at DUT1 and check if output matches the following regular expressions:
DHCPACK on 20.0.0.50 to [^\)]+\) via 20.0.0.2 DHCPACK on 30.0.0.50 to [^\)]+\) via 30.0.0.2Show output
Sep 05 11:37:39.279252 osdx systemd-journald[1555]: Runtime Journal (/run/log/journal/50a598a116a9494aab0ac4ddc8eeff40) is 932.0K, max 6.5M, 5.6M free. Sep 05 11:37:39.281941 osdx systemd-journald[1555]: Received client request to rotate journal, rotating. Sep 05 11:37:39.282018 osdx systemd-journald[1555]: Vacuuming done, freed 0B of archived journals from /run/log/journal/50a598a116a9494aab0ac4ddc8eeff40. Sep 05 11:37:39.289272 osdx OSDxCLI[1828]: User 'admin' executed a new command: 'system journal clear'. Sep 05 11:37:39.508966 osdx OSDxCLI[1828]: User 'admin' executed a new command: 'system coredump delete all'. Sep 05 11:37:41.087425 osdx OSDxCLI[1828]: User 'admin' entered the configuration menu. Sep 05 11:37:41.160182 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set interfaces eth0.100 address 10.0.0.1/24'. Sep 05 11:37:41.247826 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network dummy subnet 10.0.0.1/32'. Sep 05 11:37:41.306107 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network remote subnet 20.0.0.0/24 start 20.0.0.50 stop 20.0.0.50'. Sep 05 11:37:41.399976 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set protocols static route 0.0.0.0/0 next-hop 10.0.0.2'. Sep 05 11:37:41.464327 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network remote2 subnet 30.0.0.0/24 start 30.0.0.50 stop 30.0.0.50'. Sep 05 11:37:41.572927 osdx OSDxCLI[1828]: User 'admin' added a new cfg line: 'show working'. Sep 05 11:37:41.643199 osdx ubnt-cfgd[112405]: inactive Sep 05 11:37:41.672086 osdx INFO[112417]: FRR daemons did not change Sep 05 11:37:41.693945 osdx kernel: 8021q: adding VLAN 0 to HW filter on device eth0 Sep 05 11:37:41.712805 osdx (udev-worker)[112464]: Network interface NamePolicy= disabled on kernel command line. Sep 05 11:37:41.986304 osdx systemd[1]: Started dhcpd@main.service - "DHCP Server Service instance main". Sep 05 11:37:41.988302 osdx cfgd[1254]: [1828]Completed change to active configuration Sep 05 11:37:41.997649 osdx dhcpd[112538]: Wrote 0 leases to leases file. Sep 05 11:37:42.002183 osdx OSDxCLI[1828]: User 'admin' committed the configuration. Sep 05 11:37:42.020695 osdx OSDxCLI[1828]: User 'admin' left the configuration menu. Sep 05 11:37:42.025371 osdx dhcpd[112538]: Sep 05 11:37:42.025376 osdx dhcpd[112538]: No subnet declaration for eth0 (no IPv4 addresses). Sep 05 11:37:42.025379 osdx dhcpd[112538]: ** Ignoring requests on eth0. If this is not what Sep 05 11:37:42.025381 osdx dhcpd[112538]: you want, please write a subnet declaration Sep 05 11:37:42.025384 osdx dhcpd[112538]: in your dhcpd.conf file for the network segment Sep 05 11:37:42.025386 osdx dhcpd[112538]: to which interface eth0 is attached. ** Sep 05 11:37:42.025388 osdx dhcpd[112538]: Sep 05 11:37:42.034055 osdx dhcpd[112538]: Server starting service. Sep 05 11:37:42.758345 osdx dhcpd[112538]: DHCPDISCOVER from de:ad:be:ef:6c:20 via 20.0.0.2 Sep 05 11:37:42.874137 osdx dhcpd[112538]: DHCPDISCOVER from de:ad:be:ef:6c:20 via 30.0.0.2 Sep 05 11:37:43.758521 osdx dhcpd[112538]: DHCPOFFER on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.2 Sep 05 11:37:43.759127 osdx dhcpd[112538]: DHCPREQUEST for 20.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:20 (osdx) via 20.0.0.2 Sep 05 11:37:43.785058 osdx dhcpd[112538]: DHCPACK on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.2 Sep 05 11:37:43.874331 osdx dhcpd[112538]: DHCPOFFER on 30.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 30.0.0.2 Sep 05 11:37:43.874914 osdx dhcpd[112538]: DHCPREQUEST for 30.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:20 (osdx) via 30.0.0.2 Sep 05 11:37:43.905210 osdx dhcpd[112538]: DHCPACK on 30.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 30.0.0.2