The following sections describe how to import and set up a two-leaf/two-spine Cumulus VX topology with VirtualBox.
These sections assume a basic level of VirtualBox experience. For detailed instructions, refer to the VirtualBox documentation.
Create a Cumulus VX VM with VirtualBox
This section assumes that you have downloaded the Cumulus VX disk image for VirtualBox and that VirtualBox is installed. For more download locations and steps, refer to the Getting Started page.
Open VirtualBox and click File > Import Appliance.
Browse for the downloaded VirtualBox image, click the Open button, then click Continue.
Review the Appliance settings. Change the name of the VM to
CumulusVX-leaf1, then click Import to begin the import process.
This section assumes that you are configuring a two-leaf/two-spine network topology, that you have completed the steps in Create a Cumulus VX VM with VirtualBox above, and that you now have a VM called
Right click the created
CumulusVX-leaf1VM, then select Clone.
Change the name of the VM to
CumulusVX-leaf2, then click Continue.
Select Full Clone and click Clone.
Repeat steps 1-3 for two additional VMs:
After you have created all four VMs, follow the steps in Create a Two-Leaf, Two-Spine Topology to configure the network interfaces and routing.
You can also add a VM to one or more internal virtual networks in VirtualBox by cloning the VM. However, consider the following if you prefer to clone VMs:
To set up configurations quickly across multiple nodes, configure the settings for the original VM, then clone it using Machine > Clone. For example, if a management VM is being created for the new topology, set the
eth0port to be on a virtual network that the management VM is on. When you clone the new VM, the port will be duplicated, creating an out-of-band (OOB) network.
When you clone the VM, save the new VM on disk storage by referring to the original disk image, instead of copying it to the new VM.
Always reset MAC addresses on the virtual NICs, unless a critical reason not to exists.
VirtualBox Caveats and Errata
Consider the following caveats and expected behaviors when using Cumulus VX with VirtualBox:
You must select an OS type to export a setup. However, a bug exists in VirtualBox when the OS type
unknownis selected; while the VM works, the exported appliance does not import correctly.
Make sure to enable hardware virtualization in the host OS BIOS before starting the VM if you are using VirtualBox as the hypervisor, as some operating systems might not enable it by default.
An error message might appear when booting a VirtualBox OVA image for the first time stating that the interfaces file must be modified. If this occurs, click OK and continue booting. This is expected VirtualBox behavior, which is likely due to the physical interface against which the VM is being bridged and is highly dependent on the physical computer you are using. Some systems use
en0as the wireless interface, others use
en3, and a plugged-in Ethernet port would be
en1. The OVA requests the first interface, which might not be up and active on your system when you import the image, causing the error message.
Network Interface Limitations
By default, the VirtualBox Manager only displays the first 8 virtual NICs, and you can only modify the first 4. However, if you plan on using more than 8 virtual network interfaces, you can run the
VBoxManage command to configure and use up to 36 virtual NICs:
With the VM powered off, edit the VM settings.
Select the System tab.
On the Motherboard tab, in the Chipset list, select
ICH9, then check Enable I/O APIC.
Click OK to save the settings.
Alternately, use the
VBoxManage modifyvm command to update these settings:
After you configure the chipset and enable the I/O APIC, use the
VBoxManage showvminfo command to verify that the 36 virtual NICs are available:
The above output shows that
NIC 1 corresponds to the
eth0 management interface, while
NICs 2-36 correspond to the
swp1-35 switch port interfaces. You can configure the interfaces with the
VBoxManage modifyvm commands. See the VirtualBox networking documentation and VBoxManage command reference for more information on configuring virtual NICs.