Cumulus Networks Services Demos

The Cumulus Networks 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 Networks reference topology includes cabling (in DOT format for dual use with PTM), MAC addressing, IP addressing, switches and servers. This topology is blessed by the Professional Services Team at Cumulus Networks to fit a majority of designs seen in the field.

IP and MAC Addressing

Hostname eth0 IP eth0 MAC Interface Count
oob-mgmt-server any
oob-mgmt-switch any Cumulus RMP
leaf01 A0:00:00:00:00:11 48x10g w/ 6x40g uplink
leaf02 A0:00:00:00:00:12 48x10g w/ 6x40g uplink
leaf03 A0:00:00:00:00:13 48x10g w/ 6x40g uplink
leaf04 A0:00:00:00:00:14 48x10g w/ 6x40g uplink
spine01 A0:00:00:00:00:21 32x40g
spine02 A0:00:00:00:00:22 32x40g
server01 A0:00:00:00:00:31 10g NICs
server02 A0:00:00:00:00:32 10g NICs
server03 A0:00:00:00:00:33 10g NICs
server04 A0:00:00:00:00:34 10g NICs
exit01 A0:00:00:00:00:41 48x10g w/ 6x40g uplink (exit leaf)
exit02 A0:00:00:00:00:42 48x10g w/ 6x40g uplink (exit leaf)
edge01 A0:00:00:00:00:51 10g NICs (customer edge device, firewall, load balancer, etc.)
internet any (represents internet provider edge device)

Build the Topology

Virtual Appliance

You can build out the reference topology in hardware or using Cumulus VX (the free Cumulus Networks virtual appliance). 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.