If you are using the current version of Cumulus Linux, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

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
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.


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.