blueprint: convert dhcp trough gre bridge to autotest

1 files changed, 98 insertions, 0 deletions

diff --git a/docs/configexamples/autotest/DHCPRelay_through_GRE/DHCPRelay_through_GRE.rst b/docs/configexamples/autotest/DHCPRelay_through_GRE/DHCPRelay_through_GRE.rst
new file mode 100644
index 00000000..7e3ce318
--- /dev/null
+++ b/docs/configexamples/autotest/DHCPRelay_through_GRE/DHCPRelay_through_GRE.rst
@@ -0,0 +1,98 @@
+############################
+DHCP Relay trough GRE-Bridge
+############################
+
+
+| Testdate: 2021-12-22
+| Version: 1.4-rolling-202112211328
+
+
+This simple structure shows how to configure a DHCP Relay over a GRE Bridge
+interface.
+
+********
+Topology
+********
+
+The topology has 3 VyOS routers and one client. Between the DHCP Server and
+the DHCP Relay is a GRE tunnel. The `transport` VyOS represent a large
+Network.
+
+.. image:: _include/topology.png
+  :alt: Ansible Example topology image
+
+*************
+Configuration
+*************
+
+First, we configure the transport network and the Tunnel interface.
+
+
+Transport:
+
+.. literalinclude:: _include/transport.conf
+   :language: none
+
+
+DHCP-Server
+
+.. literalinclude:: _include/dhcp-server.conf
+   :language: none
+   :lines: 1-8
+
+
+DHCP-Relay
+
+.. literalinclude:: _include/dhcp-relay.conf
+   :language: none
+   :lines: 1-8
+
+
+After this, we need the DHCP-Server and Relay configuration.
+To get a testable result, we just have one IP in the DHCP range.
+Expand it as you need it.
+
+DHCP-Server
+
+.. literalinclude:: _include/dhcp-server.conf
+   :language: none
+   :lines: 9-13
+
+
+DHCP-Relay
+
+.. literalinclude:: _include/dhcp-relay.conf
+   :language: none
+   :lines: 9-10
+
+
+***************
+Test the result
+***************
+
+Ping the Client from the DHCP Server.
+
+
+.. code-block:: none
+
+   vyos@dhcp-server:~$ ping 192.168.0.30 count 4
+   PING 192.168.0.30 (192.168.0.30) 56(84) bytes of data.
+   64 bytes from 192.168.0.30: icmp_seq=1 ttl=63 time=0.780 ms
+   64 bytes from 192.168.0.30: icmp_seq=2 ttl=63 time=1.05 ms
+   64 bytes from 192.168.0.30: icmp_seq=3 ttl=63 time=0.901 ms
+   64 bytes from 192.168.0.30: icmp_seq=4 ttl=63 time=1.04 ms
+   
+   --- 192.168.0.30 ping statistics ---
+   4 packets transmitted, 4 received, 0% packet loss, time 3040ms
+   rtt min/avg/max/mdev = 0.780/0.941/1.046/0.109 ms
+
+
+And show all DHCP Leases
+
+
+.. code-block:: none
+
+   vyos@dhcp-server:~$ show dhcp server leases
+   IP address    Hardware address    State    Lease start          Lease expiration     Remaining    Pool        Hostname
+   ------------  ------------------  -------  -------------------  -------------------  -----------  ----------  ----------
+   192.168.0.30  00:50:79:66:68:05   active   2021/12/22 19:28:16  2021/12/23 19:28:16  23:59:17     DHCPTun100  VPCS