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.239 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.239/0.239/0.239/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.230 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.230/0.230/0.230/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
Jun 25 09:32:24.272412 osdx systemd-journald[1559]: Runtime Journal (/run/log/journal/4da79601fcd1495d87d4eb077a64e8bc) is 1000.0K, max 7.2M, 6.3M free. Jun 25 09:32:24.273482 osdx systemd-journald[1559]: Received client request to rotate journal, rotating. Jun 25 09:32:24.273529 osdx systemd-journald[1559]: Vacuuming done, freed 0B of archived journals from /run/log/journal/4da79601fcd1495d87d4eb077a64e8bc. Jun 25 09:32:24.284231 osdx OSDxCLI[1830]: User 'admin' executed a new command: 'system journal clear'. Jun 25 09:32:24.480256 osdx OSDxCLI[1830]: User 'admin' executed a new command: 'system coredump delete all'. Jun 25 09:32:25.856294 osdx OSDxCLI[1830]: User 'admin' entered the configuration menu. Jun 25 09:32:25.981859 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'set interfaces eth0.100 address 10.0.0.1/24'. Jun 25 09:32:26.047802 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network dummy subnet 10.0.0.1/32'. Jun 25 09:32:26.162789 osdx OSDxCLI[1830]: 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'. Jun 25 09:32:26.249540 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'set protocols static route 0.0.0.0/0 next-hop 10.0.0.2'. Jun 25 09:32:26.337812 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'show working'. Jun 25 09:32:26.433485 osdx ubnt-cfgd[125864]: inactive Jun 25 09:32:26.472829 osdx INFO[125874]: FRR daemons did not change Jun 25 09:32:26.493496 osdx kernel: 8021q: adding VLAN 0 to HW filter on device eth0 Jun 25 09:32:26.511551 osdx (udev-worker)[125923]: Network interface NamePolicy= disabled on kernel command line. Jun 25 09:32:26.689786 osdx systemd[1]: Started dhcpd@main.service - "DHCP Server Service instance main". Jun 25 09:32:26.691523 osdx cfgd[1261]: [1830]Completed change to active configuration Jun 25 09:32:26.693248 osdx dhcpd[125991]: Wrote 0 leases to leases file. Jun 25 09:32:26.704977 osdx OSDxCLI[1830]: User 'admin' committed the configuration. Jun 25 09:32:26.721514 osdx OSDxCLI[1830]: User 'admin' left the configuration menu. Jun 25 09:32:26.724427 osdx dhcpd[125991]: Jun 25 09:32:26.724432 osdx dhcpd[125991]: No subnet declaration for eth0 (no IPv4 addresses). Jun 25 09:32:26.724434 osdx dhcpd[125991]: ** Ignoring requests on eth0. If this is not what Jun 25 09:32:26.724437 osdx dhcpd[125991]: you want, please write a subnet declaration Jun 25 09:32:26.724439 osdx dhcpd[125991]: in your dhcpd.conf file for the network segment Jun 25 09:32:26.724441 osdx dhcpd[125991]: to which interface eth0 is attached. ** Jun 25 09:32:26.724443 osdx dhcpd[125991]: Jun 25 09:32:26.737605 osdx dhcpd[125991]: Server starting service. Jun 25 09:32:27.265536 osdx dhcpd[125991]: DHCPDISCOVER from de:ad:be:ef:6c:20 via 20.0.0.3 Jun 25 09:32:28.266173 osdx dhcpd[125991]: DHCPOFFER on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.3 Jun 25 09:32:28.267262 osdx dhcpd[125991]: DHCPREQUEST for 20.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:20 (osdx) via 20.0.0.3 Jun 25 09:32:28.289966 osdx dhcpd[125991]: 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.271 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.271/0.271/0.271/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.287 ms --- 1.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.287/0.287/0.287/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.206 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.206/0.206/0.206/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
Jun 25 09:32:48.295705 osdx systemd-journald[1559]: Runtime Journal (/run/log/journal/4da79601fcd1495d87d4eb077a64e8bc) is 1.0M, max 7.2M, 6.2M free. Jun 25 09:32:48.298940 osdx systemd-journald[1559]: Received client request to rotate journal, rotating. Jun 25 09:32:48.299018 osdx systemd-journald[1559]: Vacuuming done, freed 0B of archived journals from /run/log/journal/4da79601fcd1495d87d4eb077a64e8bc. Jun 25 09:32:48.305296 osdx OSDxCLI[1830]: User 'admin' executed a new command: 'system journal clear'. Jun 25 09:32:48.511189 osdx OSDxCLI[1830]: User 'admin' executed a new command: 'system coredump delete all'. Jun 25 09:32:50.116524 osdx OSDxCLI[1830]: User 'admin' entered the configuration menu. Jun 25 09:32:50.199201 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'set interfaces eth0.100 address 10.0.0.1/24'. Jun 25 09:32:50.291730 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network dummy subnet 10.0.0.1/32'. Jun 25 09:32:50.355686 osdx OSDxCLI[1830]: 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'. Jun 25 09:32:50.451825 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'set protocols static route 0.0.0.0/0 next-hop 10.0.0.2'. Jun 25 09:32:50.520978 osdx OSDxCLI[1830]: 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'. Jun 25 09:32:50.624921 osdx OSDxCLI[1830]: User 'admin' added a new cfg line: 'show working'. Jun 25 09:32:50.688237 osdx ubnt-cfgd[126801]: inactive Jun 25 09:32:50.714230 osdx INFO[126813]: FRR daemons did not change Jun 25 09:32:50.730941 osdx kernel: 8021q: adding VLAN 0 to HW filter on device eth0 Jun 25 09:32:50.750236 osdx (udev-worker)[126860]: Network interface NamePolicy= disabled on kernel command line. Jun 25 09:32:50.875209 osdx systemd[1]: Started dhcpd@main.service - "DHCP Server Service instance main". Jun 25 09:32:50.878087 osdx cfgd[1261]: [1830]Completed change to active configuration Jun 25 09:32:50.879479 osdx dhcpd[126930]: Wrote 0 leases to leases file. Jun 25 09:32:50.890731 osdx OSDxCLI[1830]: User 'admin' committed the configuration. Jun 25 09:32:50.908825 osdx OSDxCLI[1830]: User 'admin' left the configuration menu. Jun 25 09:32:50.931477 osdx dhcpd[126930]: Jun 25 09:32:50.931482 osdx dhcpd[126930]: No subnet declaration for eth0 (no IPv4 addresses). Jun 25 09:32:50.931485 osdx dhcpd[126930]: ** Ignoring requests on eth0. If this is not what Jun 25 09:32:50.931487 osdx dhcpd[126930]: you want, please write a subnet declaration Jun 25 09:32:50.931489 osdx dhcpd[126930]: in your dhcpd.conf file for the network segment Jun 25 09:32:50.931492 osdx dhcpd[126930]: to which interface eth0 is attached. ** Jun 25 09:32:50.931494 osdx dhcpd[126930]: Jun 25 09:32:50.939157 osdx dhcpd[126930]: Server starting service. Jun 25 09:32:51.570879 osdx dhcpd[126930]: DHCPDISCOVER from de:ad:be:ef:6c:20 via 20.0.0.2 Jun 25 09:32:51.706948 osdx dhcpd[126930]: DHCPDISCOVER from de:ad:be:ef:6c:20 via 30.0.0.2 Jun 25 09:32:52.571571 osdx dhcpd[126930]: DHCPOFFER on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.2 Jun 25 09:32:52.572187 osdx dhcpd[126930]: DHCPREQUEST for 20.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:20 (osdx) via 20.0.0.2 Jun 25 09:32:52.593348 osdx dhcpd[126930]: DHCPACK on 20.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 20.0.0.2 Jun 25 09:32:52.707159 osdx dhcpd[126930]: DHCPOFFER on 30.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 30.0.0.2 Jun 25 09:32:52.707791 osdx dhcpd[126930]: DHCPREQUEST for 30.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:20 (osdx) via 30.0.0.2 Jun 25 09:32:52.719298 osdx dhcpd[126930]: DHCPACK on 30.0.0.50 to de:ad:be:ef:6c:20 (osdx) via 30.0.0.2