User Tools

Site Tools


documentation:examples:graphpath

Testing graphpath, the ASCII network diagram tool

This lab show an jail/vnet based diagram used for testing BSDRP's graphpath.

Presentation

graphpath generates an ASCII network diagram of the path, view from the host, from a source toward a destination IP address.

For testing this tools, we need to create a network with a topology allowing all graphpath use cases.

Network diagram

Setting-up the lab

Downloading BSD Router Project images

Download BSDRP serial image (prevent to have to use an X display) on Sourceforge.

Download Lab scripts

More information on these BSDRP lab scripts available on How to build a BSDRP router lab.

Start the lab with only one router, example with bhyve under FreeBSD:

user:~ # tools/BSDRP-lab-bhyve.sh -i /usr/obj/BSDRPstable.amd64/BSDRP-1.801-full-amd64-serial.img.xz
BSD Router Project (http://bsdrp.net) - bhyve full-meshed lab script
Setting-up a virtual lab with 1 VM(s):
- Working directory: /tmp/BSDRP
- Each VM has 1 core(s) and 512M RAM
- Emulated NIC: virtio-net
- Switch mode: bridge + tap
- 1 LAN(s) between all VM
- Full mesh Ethernet links between each VM
VM 1 have the following NIC:
- vtnet0 connected to LAN number 1
For connecting to VM'serial console, you can use:
- VM 1 : cu -l /dev/nmdm1B

Network setup

From BSDRP, you can configure all these with only one command line:

labconfig graphpath

Host (me)

sysrc hostname="me"
sysrc cloned_interfaces="bridge1 bridge2 bridge11 bridge12 bridge21"
sysrc ifconfig_bridge1="inet 10.0.1.1/24"
sysrc ifconfig_bridge1_ipv6="inet6 2001:db8:1::1 prefixlen 64"
sysrc ifconfig_bridge2="inet 10.0.2.1/24"
sysrc ifconfig_bridge2_ipv6="inet6 2001:db8:2::1 prefixlen 64"
sysrc ifconfig_bridge11="up"
sysrc ifconfig_bridge12="up"
sysrc ifconfig_bridge21="up"
sysrc static_routes="host11 host12 host21"
sysrc route_host11="-net 10.0.11.0/24 10.0.1.11"
sysrc route_host12="-net 10.0.12.0/24 10.0.1.12"
sysrc route_host21="-net 10.0.21.0/24 10.0.2.21"
sysrc ipv6_static_routes="host11 host12 host21"
sysrc ipv6_route_host11="2001:db8:11:: -prefixlen 64 2001:db8:1::11"
sysrc ipv6_route_host12="2001:db8:12:: -prefixlen 64 2001:db8:1::12"
sysrc ipv6_route_host21="2001:db8:21:: -prefixlen 64 2001:db8:2::21"
hostname me
service netif restart
service routing restart

Jail host11

host11 is configured as a simple host:

tenant -c -j host11 -i bridge11
cat > /etc/jails/host11/rc.conf <<EOF
hostname="host11"
ifconfig_epair111b="inet 10.0.11.11/24"
ifconfig_epair111b_ipv6="inet6 2001:db8:11::11 prefixlen 64"
defaultrouter="10.0.11.254"
ipv6_defaultrouter="2001:db8:11::254"
EOF

Jail host12

host12 is configured as a simple host:

tenant -c -j host12 -i bridge12
cat > /etc/jails/host12/rc.conf <<EOF
hostname="host12"
ifconfig_epair212b="inet 10.0.12.12/24"
ifconfig_epair212b_ipv6="inet6 2001:db8:12::12 prefixlen 64"
defaultrouter="10.0.12.254"
ipv6_defaultrouter="2001:db8:12::254"
EOF

Jail router11

router11 is configured as a router:

tenant -c -j router11 -i bridge1,bridge11
cat > /etc/jails/router11/rc.conf <<EOF
hostname="router11"
gateway_enable=YES
ipv6_gateway_enable=YES
ifconfig_epair31b="inet 10.0.1.11/24"
ifconfig_epair31b_ipv6="inet6 2001:db8:1::11 prefixlen 64"
ifconfig_epair311b="inet 10.0.11.254/24"
ifconfig_epair311b_ipv6="inet6 2001:db8:11::254 prefixlen 64"
defaultrouter="10.0.1.1"
ipv6_defaultrouter="2001:db8:1::1"
EOF

Jail router12

router12 is configured as a router:

tenant -c -j router12 -i bridge1,bridge12
cat > /etc/jails/router12/rc.conf <<EOF
hostname=router12
gateway_enable=YES
ipv6_gateway_enable=YES
ifconfig_epair41b="inet 10.0.1.12/24"
ifconfig_epair41b_ipv6="inet6 2001:db8:1::12 prefixlen 64"
ifconfig_epair412b="inet 10.0.12.254/24"
ifconfig_epair412b_ipv6="inet6 2001:db8:12::254 prefixlen 64"
defaultrouter="10.0.1.1"
ipv6_defaultrouter="2001:db8:1::1"
EOF

Jail router21

router21 is configured as a router:

tenant -c -j router21 -i bridge2,bridge21
cat > /etc/jails/router21/rc.conf <<EOF
hostname="router21"
gateway_enable=YES
ipv6_gateway_enable=YES
ifconfig_epair52b="inet 10.0.2.21/24"
ifconfig_epair52b_ipv6="inet6 2001:db8:2::21 prefixlen 64"
ifconfig_epair521b="inet 10.0.21.254/24"
ifconfig_epair521b_ipv6="inet6 2001:db8:21::254 prefixlen 64"
defaultrouter="10.0.2.1"
ipv6_defaultrouter="2001:db8:2::1"
EOF

Jail host21

host21 is configured as a simple host:

tenant -c -j host21 -i bridge21
cat > /etc/jails/host21/rc.conf <<EOF
hostname="host21"
ifconfig_epair621b="inet 10.0.21.21/24"
ifconfig_epair621b_ipv6="inet6 2001:db8:21::21 prefixlen 64"
defaultrouter="10.0.21.254"
ipv6_defaultrouter="2001:db8:21::254"
EOF

Start the jails

[root@me]~# service jail start
Starting jails:epair111a: Ethernet address: 02:ff:c0:00:09:0a
epair111b: Ethernet address: 02:00:90:00:0a:0b
epair212a: Ethernet address: 02:ff:c0:00:0b:0a
epair212b: Ethernet address: 02:00:90:00:0c:0b
epair31a: Ethernet address: 02:ff:c0:00:0a:0a
epair31b: Ethernet address: 02:00:90:00:0d:0b
epair41a: Ethernet address: 02:ff:c0:00:0c:0a
epair41b: Ethernet address: 02:00:90:00:0e:0b
epair311a: Ethernet address: 02:ff:c0:00:0f:0a
epair311b: Ethernet address: 02:00:90:00:10:0b
epair52a: Ethernet address: 02:ff:c0:00:11:0a
epair52b: Ethernet address: 02:00:90:00:12:0b
epair412a: Ethernet address: 02:ff:c0:00:13:0a
epair412b: Ethernet address: 02:00:90:00:14:0b
epair621a: Ethernet address: 02:ff:c0:00:0d:0a
epair621b: Ethernet address: 02:00:90:00:10:0b
epair521a: Ethernet address: 02:ff:c0:00:15:0a
epair521b: Ethernet address: 02:00:90:00:16:0b
 host11 host12 host21 router21 router11 router12.

And test host11 can reach host21:

[root@me]~# jexec host11 traceroute 10.0.21.21
traceroute to 10.0.21.21 (10.0.21.21), 64 hops max, 40 byte packets
 1  10.0.11.254 (10.0.11.254)  0.055 ms  0.051 ms  0.039 ms
 2  10.0.1.1 (10.0.1.1)  0.043 ms  0.048 ms  0.041 ms
 3  10.0.2.21 (10.0.2.21)  0.044 ms  0.056 ms  0.043 ms
 4  10.0.21.21 (10.0.21.21)  0.047 ms  0.052 ms  0.045 ms
[root@me]~# jexec host11 traceroute6 2001:db8:21::21
traceroute6 to 2001:db8:21::21 (2001:db8:21::21) from 2001:db8:11::11, 64 hops max, 20 byte packets
 1  2001:db8:11::254  0.127 ms  0.103 ms  0.091 ms
 2  2001:db8:1::1  0.101 ms  0.106 ms  0.094 ms
 3  2001:db8:2::21  0.139 ms  0.108 ms  0.098 ms
 4  2001:db8:21::21  0.159 ms  0.112 ms  0.102 ms

Testing graphpath

Now, from the main host, we should be able to generate some ASCII network diagrams:

Inet4

[root@me]~# ping -c 1 10.0.11.11
[root@me]~# ping -c 1 10.0.12.12
[root@me]~# ping -c 1 10.0.21.21
[root@me]~# graphpath 10.0.11.11 10.0.12.12
+-----------------------------+  +-----------------------------+
| SOURCE HOST                 |  | DESTINATION HOST            |
| IP:   10.0.11.11            |  | IP:   10.0.12.12            |
+-----------------------------+  +-----------------------------+
              |                            |
+-----------------------------+  +-----------------------------+
| ROUTER TOWARDS SOURCE       |  | ROUTER TOWARDS DESTINATION  |
| IP:   10.0.1.11             |  | IP:   10.0.1.12             |
| ARP:  02:01:6c:01:b0:03     |  | ARP:  02:01:6c:01:b0:04     |
+-----------------------------+  +-----------------------------+
              |                            |
            --+---+------------------------+---
                  |
+-----------------------------+
| IF:   bridge1               |
| MAC:  02:e7:49:ed:fc:01     |
| IP:   10.0.1.1              |
| net:  10.0.11.0             |
| mask: 255.255.255.0         |
|                             |
|         THIS ROUTER         |
+-----------------------------+

[root@me]~# graphpath 10.0.11.11 10.0.21.21
+-----------------------------+
| SOURCE HOST                 |
| IP:   10.0.11.11            |
+-----------------------------+
              |
+-----------------------------+
| ROUTER TOWARDS SOURCE       |
| IP:   10.0.1.11             |
| ARP:  02:01:6c:01:b0:03     |
+-----------------------------+
              |
+-----------------------------+
| IF:   bridge1               |
| MAC:  02:e7:49:ed:fc:01     |
| IP:   10.0.1.1              |
| net:  10.0.11.0             |
| mask: 255.255.255.0         |
|                             |
|         THIS ROUTER         |
|                             |
| net:  10.0.21.0             |
| mask: 255.255.255.0         |
| IP:   10.0.2.1              |
| MAC:  02:e7:49:ed:fc:02     |
| IF:   bridge2               |
+-----------------------------+
              |
+-----------------------------+
| ROUTER TOWARDS DESTINATION  |
| IP:   10.0.2.21             |
| ARP:  02:02:6c:01:b0:05     |
+-----------------------------+
              |
+-----------------------------+
| DESTINATION HOST            |
| IP:   10.0.21.21            |
+-----------------------------+

[root@me]~# graphpath 10.0.11.11 10.0.1.12
+-----------------------------+  +-----------------------------+
| SOURCE HOST                 |  | DESTINATION HOST            |
| IP:   10.0.11.11            |  | IP:   10.0.1.12             |
|                             |  | ARP:  02:01:6c:01:b0:04     |
+-----------------------------+  +-----------------------------+
              |                            |
+-----------------------------+            |
| ROUTER TOWARDS SOURCE       |            |
| IP:   10.0.1.11             |            |
| ARP:  02:01:6c:01:b0:03     |            |
+-----------------------------+            |
              |                            |
            --+---+------------------------+---
                  |
+-----------------------------+
| IF:   bridge1               |
| MAC:  02:e7:49:ed:fc:01     |
| IP:   10.0.1.1              |
| net:  10.0.11.0             |
| mask: 255.255.255.0         |
|                             |
|         THIS ROUTER         |
+-----------------------------+

[root@me]~#  graphpath 10.0.1.12 10.0.11.11
+-----------------------------+  +-----------------------------+
| SOURCE HOST                 |  | DESTINATION HOST            |
| IP:   10.0.1.12             |  | IP:   10.0.11.11            |
| ARP:  02:01:c9:01:b0:04     |  |                             |
+-----------------------------+  +-----------------------------+
              |                            |
              |                  +-----------------------------+
              |                  | ROUTER TOWARDS DESTINATION  |
              |                  | IP:   10.0.1.11             |
              |                  | ARP:  02:01:c9:01:b0:03     |
              |                  +-----------------------------+
              |                            |
            --+---+------------------------+---
                  |
+-----------------------------+
| IF:   bridge1               |
| MAC:  02:de:f2:41:54:01     |
| IP:   10.0.1.1              |
| net:  10.0.1.0              |
| mask: 255.255.255.0         |
|                             |
|         THIS ROUTER         |
+-----------------------------+

Inet6

[root@me]~# ping6 -c 1 2001:db8:11::11
[root@me]~# ping6 -c 1 2001:db8:12::12
[root@me]~# ping6 -c 1 2001:db8:21::21
[root@me]~# graphpath 2001:db8:11::11 2001:db8:12::12
+---------------------------------------------------+  +---------------------------------------------------+
| SOURCE HOST                                       |  | DESTINATION HOST                                  |
| IP:   2001:db8:11::11                             |  | IP:   2001:db8:12::12                             |
+---------------------------------------------------+  +---------------------------------------------------+
                         |                                                  |
+---------------------------------------------------+  +---------------------------------------------------+
| ROUTER TOWARDS SOURCE                             |  | ROUTER TOWARDS DESTINATION                        |
| IP:   2001:db8:1::11                              |  | IP:   2001:db8:1::12                              |
| NDP:  02:01:c9:01:b0:03                           |  | NDP:  02:01:c9:01:b0:04                           |
+---------------------------------------------------+  +---------------------------------------------------+
                         |                                                  |
                       --+---+----------------------------------------------+---
                             |
+---------------------------------------------------+
| IF:   bridge1                                     |
| MAC:  02:de:f2:41:54:01                           |
| IP:   2001:db8:1::1                               |
| net:  2001:db8:11::                               |
| mask: ffff:ffff:ffff:ffff::                       |
|                                                   |
|                    THIS ROUTER                    |
+---------------------------------------------------+

[root@me]~# graphpath 2001:db8:11::11 2001:db8:21::21
+---------------------------------------------------+
| SOURCE HOST                                       |
| IP:   2001:db8:11::11                             |
+---------------------------------------------------+
                         |
+---------------------------------------------------+
| ROUTER TOWARDS SOURCE                             |
| IP:   2001:db8:1::11                              |
| NDP:  02:01:c9:01:b0:03                           |
+---------------------------------------------------+
                         |
+---------------------------------------------------+
| IF:   bridge1                                     |
| MAC:  02:de:f2:41:54:01                           |
| IP:   2001:db8:1::1                               |
| net:  2001:db8:11::                               |
| mask: ffff:ffff:ffff:ffff::                       |
|                                                   |
|                    THIS ROUTER                    |
|                                                   |
| net:  2001:db8:21::                               |
| mask: ffff:ffff:ffff:ffff::                       |
| IP:   2001:db8:2::1                               |
| MAC:  02:de:f2:41:54:02                           |
| IF:   bridge2                                     |
+---------------------------------------------------+
                         |
+---------------------------------------------------+
| ROUTER TOWARDS DESTINATION                        |
| IP:   2001:db8:2::21                              |
| NDP:  02:02:c9:01:b0:05                           |
+---------------------------------------------------+

[root@me]~# graphpath 2001:db8:11::11 2001:db8:1::12
+---------------------------------------------------+  +---------------------------------------------------+
| SOURCE HOST                                       |  | DESTINATION HOST                                  |
| IP:   2001:db8:11::11                             |  | IP:   2001:db8:1::12                              |
|                                                   |  | NDP:  02:01:c9:01:b0:04                           |
+---------------------------------------------------+  +---------------------------------------------------+
                         |                                                  |
+---------------------------------------------------+                       |
| ROUTER TOWARDS SOURCE                             |                       |
| IP:   2001:db8:1::11                              |                       |
| NDP:  02:01:c9:01:b0:03                           |                       |
+---------------------------------------------------+                       |
                         |                                                  |
                       --+---+----------------------------------------------+---
                             |
+---------------------------------------------------+
| IF:   bridge1                                     |
| MAC:  02:de:f2:41:54:01                           |
| IP:   2001:db8:1::1                               |
| net:  2001:db8:11::                               |
| mask: ffff:ffff:ffff:ffff::                       |
|                                                   |
|                    THIS ROUTER                    |
+---------------------------------------------------+

[root@me]~# graphpath 2001:db8:1::12 2001:db8:11::11
+---------------------------------------------------+  +---------------------------------------------------+
| SOURCE HOST                                       |  | DESTINATION HOST                                  |
| IP:   2001:db8:1::12                              |  | IP:   2001:db8:11::11                             |
| NDP:  02:01:c9:01:b0:04                           |  |                                                   |
+---------------------------------------------------+  +---------------------------------------------------+
                         |                                                  |
                         |                             +---------------------------------------------------+
                         |                             | ROUTER TOWARDS DESTINATION                        |
                         |                             | IP:   2001:db8:1::11                              |
                         |                             | NDP:  02:01:c9:01:b0:03                           |
                         |                             +---------------------------------------------------+
                         |                                                  |
                       --+---+----------------------------------------------+---
                             |
+---------------------------------------------------+
| IF:   bridge1                                     |
| MAC:  02:de:f2:41:54:01                           |
| IP:   2001:db8:1::1                               |
| net:  2001:db8:1::                                |
| mask: ffff:ffff:ffff:ffff::                       |
|                                                   |
|                    THIS ROUTER                    |
+---------------------------------------------------+
documentation/examples/graphpath.txt · Last modified: 2018/10/15 23:51 by olivier