This documentation is for the extended support release (ESR) version of Cumulus Linux. We will continue to keep this content up to date until 21 February, 2023, when ESR support ends. For more information about ESR, please read this knowledge base article.

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 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 our Professional Services Team to fit a majority of designs seen in the field.

IP and MAC Addressing

Hostnameeth0 IPeth0 MACInterface Count
oob-mgmt-server192.168.0.254any
oob-mgmt-switch192.168.0.1any
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
spine01192.168.0.21A0:00:00:00:00:2132x40g
spine02192.168.0.22A0:00:00:00:00:2232x40g
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.

Hardware

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.

Demos

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.