Transparent management interfaces for Cisco nodes.

c8000v/docker/launch.py

@@ -150,6 +150,8 @@ def bootstrap_spin(self):
     def bootstrap_config(self):
         """Do the actual bootstrap config"""
         self.logger.info("applying bootstrap configuration")
+
+        v4_mgmt_address = vrnetlab.cidr_to_ddn(self.mgmt_address_ipv4)
 
         self.wait_write("", None)
         self.wait_write("enable", wait=">")
@@ -165,17 +167,23 @@ def bootstrap_config(self):
             self.wait_write("ip domain-name example.com")
         self.wait_write("crypto key generate rsa modulus 2048")
 
+        self.wait_write("ipv6 unicast-routing")
+
         self.wait_write("vrf definition clab-mgmt")
+        self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
         self.wait_write("address-family ipv4")
         self.wait_write("exit")
-        self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
+        self.wait_write("address-family ipv6")
+        self.wait_write("exit")
         self.wait_write("exit")
 
-        self.wait_write("ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 10.0.0.2")
+        self.wait_write(f"ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 {self.mgmt_gw_ipv4}")
+        self.wait_write(f"ipv6 route vrf clab-mgmt ::/0 {self.mgmt_gw_ipv6}")
 
         self.wait_write("interface GigabitEthernet1")
         self.wait_write("vrf forwarding clab-mgmt")
-        self.wait_write("ip address 10.0.0.15 255.255.255.0")
+        self.wait_write(f"ip address {v4_mgmt_address[0]} {v4_mgmt_address[1]}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("no shut")
         self.wait_write("exit")
         self.wait_write("restconf")

cat9kv/docker/launch.py

@@ -157,6 +157,8 @@ def bootstrap_spin(self):
     def bootstrap_config(self):
         """Do the actual bootstrap config"""
         self.logger.info("applying bootstrap configuration")
+
+        v4_mgmt_address = vrnetlab.cidr_to_ddn(self.mgmt_address_ipv4)
 
         self.wait_write("", None)
         self.wait_write("enable", wait=">")
@@ -173,12 +175,16 @@ def bootstrap_config(self):
         self.wait_write("crypto key generate rsa modulus 2048")
 
         self.wait_write("no ip domain lookup")
+
+        self.wait_write("ipv6 unicast-routing")
 
         # add mgmt vrf static route
-        self.wait_write("ip route vrf Mgmt-vrf 0.0.0.0 0.0.0.0 10.0.0.2")
+        self.wait_write(f"ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 {self.mgmt_gw_ipv4}")
+        self.wait_write(f"ipv6 route vrf clab-mgmt ::/0 {self.mgmt_gw_ipv6}")
 
         self.wait_write("interface GigabitEthernet0/0")
-        self.wait_write("ip address 10.0.0.15 255.255.255.0")
+        self.wait_write(f"ip address {v4_mgmt_address[0]} {v4_mgmt_address[1]}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("no shut")
         self.wait_write("exit")
 

common/vrnetlab.py

@@ -837,3 +837,31 @@ def get_digits(input_str: str) -> int:
 
     non_string_chars = re.findall(r"\d", input_str)
     return int("".join(non_string_chars))
+
+def cidr_to_ddn(prefix: str):
+    """
+    Convert a IPv4 CIDR notation prefix to address + mask in DDN notation
+
+    Returns a list of IP address (str) and mask (str) in dotted decimal 
+
+    Example: 
+    get_ddn_mask('192.168.0.1/24') 
+    returns ['192.168.0.1' ,'255.255.255.0']
+    """
+
+    address, _, mask = prefix.partition("/")
+    mask = int(mask)
+
+    if mask > 32 or mask <= 0:
+        raise ValueError(f"Prefix: {prefix} has invalid mask length. Should be from 1-32 (inclusive).")
+
+    # turn the prefix length into a bitmask
+    bit_mask = f"{'1' * mask}{'0'*(32-mask)}"
+
+    # split bit mask into 4 octets and convert to binary
+    octets = [bit_mask[i:i+8] for i in range(0, 32, 8)]
+
+    # from each octet in the list, turn it into a single string and add the dots
+    ddn_mask = '.'.join(str(int(octet, 2)) for octet in octets)
+
+    return([address, ddn_mask])

csr/docker/launch.py

@@ -144,6 +144,8 @@ def bootstrap_spin(self):
     def bootstrap_config(self):
         """Do the actual bootstrap config"""
         self.logger.info("applying bootstrap configuration")
+
+        v4_mgmt_address = vrnetlab.cidr_to_ddn(self.mgmt_address_ipv4)
 
         self.wait_write("", None)
         self.wait_write("enable", wait=">")
@@ -159,17 +161,23 @@ def bootstrap_config(self):
            self.wait_write("ip domain-name example.com")
         self.wait_write("crypto key generate rsa modulus 2048")
 
+        self.wait_write("ipv6 unicast-routing")
+
         self.wait_write("vrf definition clab-mgmt")
+        self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
         self.wait_write("address-family ipv4")
         self.wait_write("exit")
-        self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
+        self.wait_write("address-family ipv6")
+        self.wait_write("exit")
         self.wait_write("exit")
 
-        self.wait_write("ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 10.0.0.2")
+        self.wait_write(f"ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 {self.mgmt_gw_ipv4}")
+        self.wait_write(f"ipv6 route vrf clab-mgmt ::/0 {self.mgmt_gw_ipv6}")
 
         self.wait_write("interface GigabitEthernet1")
         self.wait_write("vrf forwarding clab-mgmt")
-        self.wait_write("ip address 10.0.0.15 255.255.255.0")
+        self.wait_write(f"ip address {v4_mgmt_address[0]} {v4_mgmt_address[1]}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("no shut")
         self.wait_write("exit")
         self.wait_write("restconf")

n9kv/docker/launch.py

@@ -142,13 +142,19 @@ def bootstrap_config(self):
 
         # configure management vrf
         self.wait_write("vrf context management")
-        self.wait_write("ip route 0.0.0.0/0 10.0.0.2")
+        self.wait_write(f"ip route 0.0.0.0/0 {self.mgmt_gw_ipv4}")
+        self.wait_write(f"ipv6 route ::/0 {self.mgmt_gw_ipv6}")
         self.wait_write("exit")
 
         # configure mgmt interface
         self.wait_write("interface mgmt0")
-        self.wait_write("ip address 10.0.0.15/24")
+        self.wait_write(f"ip address {self.mgmt_address_ipv4}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("exit")
+
+        # configure longer ssh keys
+        self.wait_write("ssh key rsa 2048 force")
+        self.wait_write("feature ssh")
 
         # setup nxapi/scp server
         self.wait_write("feature scp-server")

nxos/docker/launch.py

@@ -108,10 +108,23 @@ def bootstrap_config(self):
         )
         self.wait_write("hostname %s" % (self.hostname))
 
+        # configure management vrf
+        self.wait_write("vrf context management")
+        self.wait_write(f"ip route 0.0.0.0/0 {self.mgmt_gw_ipv4}")
+        self.wait_write(f"ipv6 route ::/0 {self.mgmt_gw_ipv6}")
+        self.wait_write("exit")
+
         # configure mgmt interface
         self.wait_write("interface mgmt0")
-        self.wait_write("ip address 10.0.0.15/24")
+        self.wait_write(f"ip address {self.mgmt_address_ipv4}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("exit")
+
+        # configure longer ssh keys
+        self.wait_write("no feature ssh")
+        self.wait_write("ssh key rsa 2048 force")
+        self.wait_write("feature ssh")
+
         self.wait_write("exit")
         self.wait_write("copy running-config startup-config")
 

vios/README.md

@@ -53,8 +53,8 @@ The following protocols are enabled on the management interface:
 
 | ID              | Description               | Default    |
 |-----------------|---------------------------|------------|
-| USERNAME        | SSH username              | vrnetlab   |
-| PASSWORD        | SSH password              | VR-netlab9 |
+| USERNAME        | SSH username              | admin      |
+| PASSWORD        | SSH password              | admin      |
 | HOSTNAME        | device hostname           | vios       |
 | TRACE           | enable trace logging      | false      |
 | CONNECTION_MODE | interface connection mode | tc         |
@@ -75,10 +75,7 @@ name: vios-lab
 topology:
   kinds:
     linux:
-      image: vrnetlab/vr-vios:15.9.3M6
-      env:
-        USERNAME: admin
-        PASSWORD: admin
+      image: vrnetlab/cisco_vios:15.9.3M6
   nodes:
     vios1:
       kind: linux

vios/docker/launch.py

@@ -121,6 +121,9 @@ def _bootstrap_config(self):
         self.wait_write(f"hostname {self.hostname}")
         self.wait_write(f"ip domain-name {self.hostname}.clab")
         self.wait_write("no ip domain-lookup")
+
+        # Explicitly enable IPv6
+        self.wait_write("ipv6 unicast-routing")
 
         self.wait_write(f"username {self.username} privilege 15 secret {self.password}")
 
@@ -138,17 +141,24 @@ def _bootstrap_config(self):
         self.wait_write("exit")
 
         self.wait_write("vrf definition clab-mgmt")
+        self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
         self.wait_write("address-family ipv4")
         self.wait_write("exit")
-        self.wait_write("description Management network")
+        self.wait_write("address-family ipv6")
         self.wait_write("exit")
+        self.wait_write("exit")
+
+        v4_mgmt_address = vrnetlab.cidr_to_ddn(self.mgmt_address_ipv4)
 
         self.wait_write("interface GigabitEthernet0/0")
         self.wait_write("vrf forwarding clab-mgmt")
-        self.wait_write("ip address 10.0.0.15 255.255.255.0")
+        self.wait_write(f"ip address {v4_mgmt_address[0]} {v4_mgmt_address[1]}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("no shutdown")
         self.wait_write("exit")
-        self.wait_write("ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 10.0.0.2")
+
+        self.wait_write(f"ip route vrf clab-mgmt 0.0.0.0 0.0.0.0 {self.mgmt_gw_ipv4}")
+        self.wait_write(f"ipv6 route vrf clab-mgmt ::/0 {self.mgmt_gw_ipv6}")
 
         self.wait_write("crypto key generate rsa modulus 2048")
         self.wait_write("ip ssh version 2")
@@ -195,10 +205,10 @@ def __init__(self, hostname: str, username: str, password: str, conn_mode: str):
         default=os.getenv("TRACE", "false").lower() == "true",
     )
     parser.add_argument(
-        "--username", help="Username", default=os.getenv("USERNAME", "vrnetlab")
+        "--username", help="Username", default=os.getenv("USERNAME", "admin")
     )
     parser.add_argument(
-        "--password", help="Password", default=os.getenv("PASSWORD", "VR-netlab9")
+        "--password", help="Password", default=os.getenv("PASSWORD", "admin")
     )
     parser.add_argument(
         "--hostname", help="Router hostname", default=os.getenv("HOSTNAME", "vios")

xrv/docker/launch.py

@@ -172,13 +172,18 @@ def bootstrap_config(self):
         self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
         self.wait_write("address-family ipv4 unicast")
         self.wait_write("exit")
+        self.wait_write("address-family ipv6 unicast")
+        self.wait_write("exit")
         self.wait_write("exit")
 
         # add static route for management
         self.wait_write("router static")
         self.wait_write("vrf clab-mgmt")
         self.wait_write("address-family ipv4 unicast")
-        self.wait_write("0.0.0.0/0 10.0.0.2")
+        self.wait_write(f"0.0.0.0/0 {self.mgmt_gw_ipv4}")
+        self.wait_write("exit")
+        self.wait_write("address-family ipv6 unicast")
+        self.wait_write(f"::/0 {self.mgmt_gw_ipv6}")
         self.wait_write("exit")
         self.wait_write("exit")
         self.wait_write("exit")
@@ -203,7 +208,8 @@ def bootstrap_config(self):
         self.wait_write("interface MgmtEth 0/0/CPU0/0")
         self.wait_write("vrf clab-mgmt")
         self.wait_write("no shutdown")
-        self.wait_write("ipv4 address 10.0.0.15/24")
+        self.wait_write(f"ipv4 address {self.mgmt_address_ipv4}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("exit")
         self.wait_write("commit")
         self.wait_write("exit")

xrv9k/docker/launch.py

@@ -73,21 +73,34 @@ def __init__(self, hostname, username, password, nics, conn_mode, vcpu, ram, ins
     def gen_mgmt(self):
         """Generate qemu args for the mgmt interface(s)"""
         res = []
-        # mgmt interface
-        res.extend(
-            ["-device", "virtio-net-pci,netdev=mgmt,mac=%s" % vrnetlab.gen_mac(0)]
+
+
+        self.mgmt_mac = (
+            "c0:00:01:00:ca:fe"
+            if getattr(self, "_static_mgmt_mac", False)
+            else vrnetlab.gen_mac(0)
         )
-        res.extend(
-            [
-                "-netdev",
-                "user,id=mgmt,net=10.0.0.0/24,"
-                "tftp=/tftpboot,"
-                "hostfwd=tcp:0.0.0.0:22-10.0.0.15:22,"
-                "hostfwd=udp:0.0.0.0:161-10.0.0.15:161,"
-                "hostfwd=tcp:0.0.0.0:830-10.0.0.15:830,"
-                "hostfwd=tcp:0.0.0.0:57400-10.0.0.15:57400"
-            ]
+        # mgmt interface
+        res.append(
+            f"-device virtio-net-pci,netdev=mgmt,mac={self.mgmt_mac} -netdev"
         )
+        if self.mgmt_passthrough:
+            # mgmt interface is passthrough - we just create a normal mirred tap interface
+            res.append(
+                "tap,id=mgmt,ifname=tap0,script=/etc/tc-tap-mgmt-ifup,downscript=no"
+            )
+            self.create_tc_tap_mgmt_ifup()
+        else:
+            res.extend(
+                [
+                    "user,id=mgmt,net=10.0.0.0/24,"
+                    "tftp=/tftpboot,"
+                    "hostfwd=tcp:0.0.0.0:22-10.0.0.15:22,"
+                    "hostfwd=udp:0.0.0.0:161-10.0.0.15:161,"
+                    "hostfwd=tcp:0.0.0.0:830-10.0.0.15:830,"
+                    "hostfwd=tcp:0.0.0.0:57400-10.0.0.15:57400"
+                ]
+            )
         # dummy interface for xrv9k ctrl interface
         res.extend(
             [
@@ -244,13 +257,18 @@ def bootstrap_config(self):
         self.wait_write("description Containerlab management VRF (DO NOT DELETE)")
         self.wait_write("address-family ipv4 unicast")
         self.wait_write("exit")
+        self.wait_write("address-family ipv6 unicast")
+        self.wait_write("exit")
         self.wait_write("exit")
 
         # add static route for management
         self.wait_write("router static")
         self.wait_write("vrf clab-mgmt")
         self.wait_write("address-family ipv4 unicast")
-        self.wait_write("0.0.0.0/0 10.0.0.2")
+        self.wait_write(f"0.0.0.0/0 {self.mgmt_gw_ipv4}")
+        self.wait_write("exit")
+        self.wait_write("address-family ipv6 unicast")
+        self.wait_write(f"::/0 {self.mgmt_gw_ipv6}")
         self.wait_write("exit")
         self.wait_write("exit")
         self.wait_write("exit")
@@ -274,10 +292,10 @@ def bootstrap_config(self):
         self.wait_write("interface MgmtEth0/RP0/CPU0/0")
         self.wait_write("vrf clab-mgmt")
         self.wait_write("no shutdown")
-        self.wait_write("ipv4 address 10.0.0.15/24")
-        self.wait_write("exit")
+        self.wait_write(f"ipv4 address {self.mgmt_address_ipv4}")
+        self.wait_write(f"ipv6 address {self.mgmt_address_ipv6}")
         self.wait_write("commit")
-        self.wait_write("exit")
+        self.wait_write("end")
 
         return True
 
@@ -365,7 +383,7 @@ def install(self):
     parser.add_argument("--nics", type=int, default=128, help="Number of NICS")
     parser.add_argument('--install', action="store_true", help="Pre-install image")
     parser.add_argument(
-        "--vcpu", type=int, default=2, help="Number of cpu cores to use"
+        "--vcpu", type=int, default=4, help="Number of cpu cores to use"
     )
     parser.add_argument(
         "--ram", type=int, default=16384, help="Number RAM to use in MB"