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.326 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.326/0.326/0.326/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:6c30/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c30/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.272 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.272/0.272/0.272/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:6c30/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c30/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
Jul 17 17:15:18.283343 osdx systemd-journald[1360]: Runtime Journal (/run/log/journal/1136bfd51c6042e9ac02f83740870c06) is 2.4M, max 9.7M, 7.3M free. Jul 17 17:15:18.288991 osdx systemd-journald[1360]: Received client request to rotate journal, rotating. Jul 17 17:15:18.289058 osdx systemd-journald[1360]: Vacuuming done, freed 0B of archived journals from /run/log/journal/1136bfd51c6042e9ac02f83740870c06. Jul 17 17:15:18.298293 osdx OSDxCLI[75437]: User 'admin' executed a new command: 'system journal clear'. Jul 17 17:15:18.785800 osdx osdx-coredump[162518]: Deleting all coredumps in /opt/vyatta/etc/config/coredump... Jul 17 17:15:18.796625 osdx OSDxCLI[75437]: User 'admin' executed a new command: 'system coredump delete all'. Jul 17 17:15:20.345374 osdx OSDxCLI[75437]: User 'admin' entered the configuration menu. Jul 17 17:15:20.412507 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'set interfaces eth0.100 address 10.0.0.1/24'. Jul 17 17:15:20.502607 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network dummy subnet 10.0.0.1/32'. Jul 17 17:15:20.572897 osdx OSDxCLI[75437]: 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'. Jul 17 17:15:20.662024 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'set protocols static route 0.0.0.0/0 next-hop 10.0.0.2'. Jul 17 17:15:20.740896 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'show working'. Jul 17 17:15:20.857352 osdx kernel: 8021q: adding VLAN 0 to HW filter on device eth0 Jul 17 17:15:20.893912 osdx (udev-worker)[162585]: Network interface NamePolicy= disabled on kernel command line. Jul 17 17:15:21.041655 osdx systemd[1]: Started dhcpd@main.service - "DHCP Server Service instance main". Jul 17 17:15:21.043958 osdx cfgd[1028]: [75437]Completed change to active configuration Jul 17 17:15:21.047845 osdx dhcpd[162606]: Wrote 0 leases to leases file. Jul 17 17:15:21.073273 osdx OSDxCLI[75437]: User 'admin' committed the configuration. Jul 17 17:15:21.086186 osdx dhcpd[162606]: Jul 17 17:15:21.086190 osdx dhcpd[162606]: No subnet declaration for eth0 (no IPv4 addresses). Jul 17 17:15:21.086193 osdx dhcpd[162606]: ** Ignoring requests on eth0. If this is not what Jul 17 17:15:21.086195 osdx dhcpd[162606]: you want, please write a subnet declaration Jul 17 17:15:21.086197 osdx dhcpd[162606]: in your dhcpd.conf file for the network segment Jul 17 17:15:21.086200 osdx dhcpd[162606]: to which interface eth0 is attached. ** Jul 17 17:15:21.086202 osdx dhcpd[162606]: Jul 17 17:15:21.088644 osdx OSDxCLI[75437]: User 'admin' left the configuration menu. Jul 17 17:15:21.093459 osdx dhcpd[162606]: Server starting service. Jul 17 17:15:21.706335 osdx dhcpd[162606]: DHCPDISCOVER from de:ad:be:ef:6c:30 via 20.0.0.3 Jul 17 17:15:22.707307 osdx dhcpd[162606]: DHCPOFFER on 20.0.0.50 to de:ad:be:ef:6c:30 (osdx) via 20.0.0.3 Jul 17 17:15:22.708106 osdx dhcpd[162606]: DHCPREQUEST for 20.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:30 (osdx) via 20.0.0.3 Jul 17 17:15:22.726395 osdx dhcpd[162606]: DHCPACK on 20.0.0.50 to de:ad:be:ef:6c:30 (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.229 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.229/0.229/0.229/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.368 ms --- 1.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.368/0.368/0.368/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:6c30/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c30/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.228 ms --- 10.0.0.1 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 0.228/0.228/0.228/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:6c30/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c30/64 eth0.300 30.0.0.50/24 up up fe80::dcad:beff:feef:6c30/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:6c30/64 up up eth0.200 20.0.0.50/24 up up fe80::dcad:beff:feef:6c30/64 eth0.300 30.0.0.50/24 up up fe80::dcad:beff:feef:6c30/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
Jul 17 17:15:39.292487 osdx systemd-journald[1360]: Runtime Journal (/run/log/journal/1136bfd51c6042e9ac02f83740870c06) is 2.4M, max 9.7M, 7.3M free. Jul 17 17:15:39.298002 osdx systemd-journald[1360]: Received client request to rotate journal, rotating. Jul 17 17:15:39.298081 osdx systemd-journald[1360]: Vacuuming done, freed 0B of archived journals from /run/log/journal/1136bfd51c6042e9ac02f83740870c06. Jul 17 17:15:39.308053 osdx OSDxCLI[75437]: User 'admin' executed a new command: 'system journal clear'. Jul 17 17:15:39.761378 osdx osdx-coredump[163153]: Deleting all coredumps in /opt/vyatta/etc/config/coredump... Jul 17 17:15:39.769107 osdx OSDxCLI[75437]: User 'admin' executed a new command: 'system coredump delete all'. Jul 17 17:15:41.373272 osdx OSDxCLI[75437]: User 'admin' entered the configuration menu. Jul 17 17:15:41.507794 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'set interfaces eth0.100 address 10.0.0.1/24'. Jul 17 17:15:41.569183 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'set service dhcp-server shared-network dummy subnet 10.0.0.1/32'. Jul 17 17:15:41.678814 osdx OSDxCLI[75437]: 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'. Jul 17 17:15:41.796978 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'set protocols static route 0.0.0.0/0 next-hop 10.0.0.2'. Jul 17 17:15:41.884724 osdx OSDxCLI[75437]: 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'. Jul 17 17:15:42.000123 osdx OSDxCLI[75437]: User 'admin' added a new cfg line: 'show working'. Jul 17 17:15:42.102325 osdx kernel: 8021q: adding VLAN 0 to HW filter on device eth0 Jul 17 17:15:42.134623 osdx (udev-worker)[163223]: Network interface NamePolicy= disabled on kernel command line. Jul 17 17:15:42.234474 osdx systemd[1]: Started dhcpd@main.service - "DHCP Server Service instance main". Jul 17 17:15:42.236683 osdx cfgd[1028]: [75437]Completed change to active configuration Jul 17 17:15:42.240577 osdx dhcpd[163244]: Wrote 0 leases to leases file. Jul 17 17:15:42.269719 osdx dhcpd[163244]: Jul 17 17:15:42.269723 osdx dhcpd[163244]: No subnet declaration for eth0 (no IPv4 addresses). Jul 17 17:15:42.269726 osdx dhcpd[163244]: ** Ignoring requests on eth0. If this is not what Jul 17 17:15:42.269728 osdx dhcpd[163244]: you want, please write a subnet declaration Jul 17 17:15:42.269731 osdx dhcpd[163244]: in your dhcpd.conf file for the network segment Jul 17 17:15:42.269733 osdx dhcpd[163244]: to which interface eth0 is attached. ** Jul 17 17:15:42.269735 osdx dhcpd[163244]: Jul 17 17:15:42.274228 osdx dhcpd[163244]: Server starting service. Jul 17 17:15:42.275437 osdx OSDxCLI[75437]: User 'admin' committed the configuration. Jul 17 17:15:42.291276 osdx OSDxCLI[75437]: User 'admin' left the configuration menu. Jul 17 17:15:42.931469 osdx dhcpd[163244]: DHCPDISCOVER from de:ad:be:ef:6c:30 via 20.0.0.2 Jul 17 17:15:43.047020 osdx dhcpd[163244]: DHCPDISCOVER from de:ad:be:ef:6c:30 via 30.0.0.2 Jul 17 17:15:43.932298 osdx dhcpd[163244]: DHCPOFFER on 20.0.0.50 to de:ad:be:ef:6c:30 (osdx) via 20.0.0.2 Jul 17 17:15:43.933351 osdx dhcpd[163244]: DHCPREQUEST for 20.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:30 (osdx) via 20.0.0.2 Jul 17 17:15:43.955238 osdx dhcpd[163244]: DHCPACK on 20.0.0.50 to de:ad:be:ef:6c:30 (osdx) via 20.0.0.2 Jul 17 17:15:44.047259 osdx dhcpd[163244]: DHCPOFFER on 30.0.0.50 to de:ad:be:ef:6c:30 (osdx) via 30.0.0.2 Jul 17 17:15:44.048613 osdx dhcpd[163244]: DHCPREQUEST for 30.0.0.50 (10.0.0.1) from de:ad:be:ef:6c:30 (osdx) via 30.0.0.2 Jul 17 17:15:44.063789 osdx dhcpd[163244]: DHCPACK on 30.0.0.50 to de:ad:be:ef:6c:30 (osdx) via 30.0.0.2