From 87127d003fcaf24e717f9bfd60d37784637e476d Mon Sep 17 00:00:00 2001
From: Ivan Pepelnjak <ip@ipspace.net>
Date: Mon, 6 Mar 2023 15:32:07 +0100
Subject: [PATCH] Simple DHCP relaying scenario

---
 DHCP/relay/README.md          |  13 ++++++++++++
 DHCP/relay/dhcp-client/ios.j2 |   5 +++++
 DHCP/relay/dhcp-relay.png     | Bin 0 -> 11375 bytes
 DHCP/relay/dhcp-relay/eos.j2  |   4 ++++
 DHCP/relay/dhcp-relay/ios.j2  |   4 ++++
 DHCP/relay/dhcp-server.j2     |  20 ++++++++++++++++++
 DHCP/relay/graph.dot          |  21 +++++++++++++++++++
 DHCP/relay/topology.yml       |  37 ++++++++++++++++++++++++++++++++++
 tools                         |   2 +-
 9 files changed, 105 insertions(+), 1 deletion(-)
 create mode 100644 DHCP/relay/README.md
 create mode 100644 DHCP/relay/dhcp-client/ios.j2
 create mode 100644 DHCP/relay/dhcp-relay.png
 create mode 100644 DHCP/relay/dhcp-relay/eos.j2
 create mode 100644 DHCP/relay/dhcp-relay/ios.j2
 create mode 100644 DHCP/relay/dhcp-server.j2
 create mode 100644 DHCP/relay/graph.dot
 create mode 100644 DHCP/relay/topology.yml

diff --git a/DHCP/relay/README.md b/DHCP/relay/README.md
new file mode 100644
index 0000000..af40c7d
--- /dev/null
+++ b/DHCP/relay/README.md
@@ -0,0 +1,13 @@
+# DHCP relaying
+
+This directory contains *netlab* topology file for a simple DHCP relaying scenario.
+
+![DHCP relaying topology](dhcp-relay.png)
+
+After starting the lab, the *user* device should get DHCP-assigned IP address on its lab-facing interface.
+
+## Changing Device Types
+
+This topology can be used with Cisco IOSv or Arista EOSv. To test it with other devices, add custom configuration template to `dhcp-relay` directory.
+
+The easiest way to change the device types is to edit the topology file. You could also use the **netlab up** [CLI arguments](https://netsim-tools.readthedocs.io/en/latest/netlab/up.html#usage) -- to change the DHCP relay device type, use `-s nodes.relay.device=xxx` CLI argument.
diff --git a/DHCP/relay/dhcp-client/ios.j2 b/DHCP/relay/dhcp-client/ios.j2
new file mode 100644
index 0000000..1c868db
--- /dev/null
+++ b/DHCP/relay/dhcp-client/ios.j2
@@ -0,0 +1,5 @@
+{% for intf in interfaces if intf.dhcp.client is defined and intf.dhcp.client %}
+interface {{ intf.ifname }}
+ no ip address
+ ip address dhcp
+{% endfor %}
\ No newline at end of file
diff --git a/DHCP/relay/dhcp-relay.png b/DHCP/relay/dhcp-relay.png
new file mode 100644
index 0000000000000000000000000000000000000000..be4afd0af0a8b98ce563736bf3c4164d3ac3b221
GIT binary patch
literal 11375
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

literal 0
HcmV?d00001

diff --git a/DHCP/relay/dhcp-relay/eos.j2 b/DHCP/relay/dhcp-relay/eos.j2
new file mode 100644
index 0000000..d47d74d
--- /dev/null
+++ b/DHCP/relay/dhcp-relay/eos.j2
@@ -0,0 +1,4 @@
+{% for intf in interfaces if intf.dhcp.server is defined %}
+interface {{ intf.ifname }}
+ ip helper-address {{ hostvars[intf.dhcp.server].loopback.ipv4|ipaddr('address') }}
+{% endfor %}
\ No newline at end of file
diff --git a/DHCP/relay/dhcp-relay/ios.j2 b/DHCP/relay/dhcp-relay/ios.j2
new file mode 100644
index 0000000..d47d74d
--- /dev/null
+++ b/DHCP/relay/dhcp-relay/ios.j2
@@ -0,0 +1,4 @@
+{% for intf in interfaces if intf.dhcp.server is defined %}
+interface {{ intf.ifname }}
+ ip helper-address {{ hostvars[intf.dhcp.server].loopback.ipv4|ipaddr('address') }}
+{% endfor %}
\ No newline at end of file
diff --git a/DHCP/relay/dhcp-server.j2 b/DHCP/relay/dhcp-server.j2
new file mode 100644
index 0000000..2065e1b
--- /dev/null
+++ b/DHCP/relay/dhcp-server.j2
@@ -0,0 +1,20 @@
+logging buffered
+no service timestamp debug
+!
+do debug ip dhcp server packet
+do debug ip dhcp server event
+!
+{% for h,v in hostvars.items() %}
+{%   for intf in v.interfaces if intf.dhcp.server is defined and intf.ipv4 is defined %}
+ip dhcp excluded-address {{ intf.ipv4|ipaddr('address') }}
+{%   endfor %}
+{% endfor %}
+!
+{% for h,v in hostvars.items() %}
+{%   for intf in v.interfaces if intf.dhcp.server is defined and intf.ipv4 is defined %}
+!
+ip dhcp pool p_{{ intf.ipv4|ipaddr('network') }}
+ network {{ intf.ipv4|ipaddr('network') }} {{ intf.ipv4|ipaddr('netmask') }} 
+ default-router {{ intf.ipv4|ipaddr('address') }}
+{%   endfor %}
+{% endfor %}
\ No newline at end of file
diff --git a/DHCP/relay/graph.dot b/DHCP/relay/graph.dot
new file mode 100644
index 0000000..efe96ed
--- /dev/null
+++ b/DHCP/relay/graph.dot
@@ -0,0 +1,21 @@
+graph {
+  bgcolor="transparent"
+  node [shape=box, style="rounded,filled" fontname=Verdana]
+  edge [fontname=Verdana labelfontsize=10 labeldistance=1.5]
+  "srv" [
+    label=<srv [iosv]<br /><sub>10.0.0.1/32</sub>>
+    fillcolor="#ff9f01"
+  ]
+  "relay" [
+    label=<relay [iosv]<br /><sub>10.0.0.2/32</sub>>
+    fillcolor="#ff9f01"
+  ]
+  "user" [
+    label=<user [iosv]<br /><sub>10.0.0.3/32</sub>>
+    fillcolor="#ff9f01"
+  ]
+ "relay" -- "srv" [ ]
+  "relay_2" [style=filled fillcolor="#d1bfab" fontsize=11 label="172.16.0.0/24"]
+ "user" -- "relay_2" [  ]
+ "relay" -- "relay_2" [  ]
+}
diff --git a/DHCP/relay/topology.yml b/DHCP/relay/topology.yml
new file mode 100644
index 0000000..40b67b9
--- /dev/null
+++ b/DHCP/relay/topology.yml
@@ -0,0 +1,37 @@
+message: |
+  This topology sets up a simple network using DHCP relay
+  functionality. It includes a DHCP server (running on Cisco
+  IOSv), DHCP client (also on Cisco IOSv) and an intermediate
+  node.
+
+defaults.attributes:
+  link.dhcp:
+    client: bool
+    server: str
+
+defaults.device: iosv
+
+groups:
+  dhcp_server:
+    members: [ srv ]
+    module: [ ospf ]
+    config: [ dhcp-server ]
+    device: iosv
+  dhcp_client:
+    members: [ user ]
+    config: [ dhcp-client ]
+    device: iosv
+  switch:
+    members: [ relay ]
+    module: [ ospf ]
+    config: [ dhcp-relay ]
+
+nodes: [ srv, relay, user ]
+
+links:
+- relay-srv
+- user:
+    dhcp.client: True
+  relay:
+    dhcp.server: srv
+  type: lan
diff --git a/tools b/tools
index 36c2858..f1f4f67 160000
--- a/tools
+++ b/tools
@@ -1 +1 @@
-Subproject commit 36c2858cb5c27f3154a1b6214f9cf478536bbbda
+Subproject commit f1f4f67e49304baa9e4801b3847f44db65f38ffe