Cumulus Networks Services Demos

The Services team demos provide a virtual environment built using either VirtualBox or libvirt using Vagrant to manage the VMs. This environment utilizes the reference topology shown below. Vagrant and Cumulus VX can be used together to build virtual simulations of production networks to validate configurations, develop automation code and simulate failure scenarios.

Reference Topology

The Cumulus Linux reference topology includes cabling (in DOT format for dual use with PTM), MAC addressing, IP addressing, switches and servers. This topology is blessed by our Professional Services Team to fit a majority of designs seen in the field.

IP and MAC Addressing

Hostnameeth0 IPeth0 MACInterface Count
oob-mgmt-switch192.168.0.1anyCumulus RMP
leaf01192.168.0.11A0:00:00:00:00:1148x10g w/ 6x40g uplink
leaf02192.168.0.12A0:00:00:00:00:1248x10g w/ 6x40g uplink
leaf03192.168.0.13A0:00:00:00:00:1348x10g w/ 6x40g uplink
leaf04192.168.0.14A0:00:00:00:00:1448x10g w/ 6x40g uplink
server01192.168.0.31A0:00:00:00:00:3110g NICs
server02192.168.0.32A0:00:00:00:00:3210g NICs
server03192.168.0.33A0:00:00:00:00:3310g NICs
server04192.168.0.34A0:00:00:00:00:3410g NICs
exit01192.168.0.41A0:00:00:00:00:4148x10g w/ 6x40g uplink (exit leaf)
exit02192.168.0.42A0:00:00:00:00:4248x10g w/ 6x40g uplink (exit leaf)
edge01192.168.0.51A0:00:00:00:00:5110g NICs (customer edge device, firewall, load balancer, etc.)
internet192.168.0.253any(represents internet provider edge device)

Build the Topology

Virtual Appliance

You can build out the reference topology in hardware or using Cumulus VX. The Cumulus Reference Topology using Vagrant is essentially the reference topology built out inside Vagrant with VirtualBox or KVM. The installation and setup instructions for bringing up the entire reference topology on a laptop or server are on the cldemo-vagrant GitHub repo.


Any switch from the hardware compatibility list is compatible with the topology as long as you follow the interface count from the table above. Of course, in your own production environment, you don’t have to use exactly the same devices and cabling as outlined above.


You can find an up to date list of all the demos in the cldemo-vagrant GitHub repository, which is available to anyone free of charge.