Cumulus Linux in Unetlab

Cumulus Linux provides a virtual appliance for testing and development. It’s free to download. The post below shows how to get Cumulus VX up and running in UNL.

How to add Cumulus VX to Unetlab

  • Follow my previous post to install Unetlab
  • Download Cumulus VX from here – Download the KVM edition


  • Once the download completes, rename the file to hda.qcow2
  • Using SFTP or SCP, transfer the file to the /root directory on the UNL host
  • Login to the UNL host Create a directory for Cumulus under /opt/unetlab/addons/qemu/, move the Cumulus VX image and then run the unl_wrapper

root@unl01:~# pwd
root@unl01:~# ll hda.qcow2
-rw-r--r-- 1 root root 1217593344 Jan 6 01:08 hda.qcow22
root@unl01:~# mkdir /opt/unetlab/addons/qemu/cumulus-3.2.0/
root@unl01:~# mv hda.qcow2 /opt/unetlab/addons/qemu/cumulus-3.2.0/
root@unl01:~# /opt/unetlab/wrappers/unl_wrapper -a fixpermissions

  • Login to the UNL web interface, from the menu bar select Actions > Add a new lab
  • Open the lab

  • From the menu bar, select Add an object > Node. Select Cumulus VX from the Template, you should see the Image that has just been uploaded as available.
  • For this lab I’m going to add 2 switches with 3 interfaces on each (1 for management and 2 switch ports).
  • From the menu bar, select Add an objeect Network. Select Type pnet0. This will create a bridge to the Network Adapter that is connected to the UNL server. This will be used to connect to the management interfaces of the switches.

  • From the menu, select Connect Node.
  • Select sw1, connect the eth0 interface to pnet0.
  • Select sw2, connect the eth0 interface to pnet0.
  • Select sw1, connect swp1 to sw2 swp1
  • Select sw2, connect swp2 to sw2 swp2

  • Right click on each switch, select Start. Click on each switch, this will telnet to the console of the switch
  • Login using the default username: cumulus and default password: CumulusLinux!
  • Rather than using the console, I’d like to use the eth0 management interface. To configure a static IP address, edit the /etc/network/interfaces file
cumulus@cumulus:~$ cat /etc/network/interfaces
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*.intf

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth0
iface eth0

From there you should be able to SSH into your switches…

So, what do you think ?