Mininet VM

This page describes how to get our custom virtual machine image that provides tools to quickly get Mininet running and connected to your SDN Developer Lab.

1. Be sure you meet the Prerequisites
2. On your computer:

   1. On SDN Developer Lab scroll down to the 'Devices' table. In the header click the link 'Download Mininet VM'. This is a large file, it will take some time to download.

   2. Once the Mininet VM has completed downloading you will have a .OVA file in your downloads folder.

   3. Copy the .OVA file to a safe location such as where you store your documents. Remember the location.

   4. Open VirtualBox

      1. Select File:Import Appliance
      2. Browse to the .OVA file and select it, it will take some time to load this OVA.
      3. Highlight the newly imported virtual machine named: Elbrys SDN Developer Portal Virtual Switch
      4. Select 'Start'
      5. A new terminal window will open and you will see the virtual machine starting

   5. In the running virtual machine

      1. Login with mininet as the username and mininet as the password.
      2. Once logged in, go into the FirstSdnApp directory:

      cd FirstSdnApp

      1. Update the source code to be sure it is up to date.

      git pull

      1. Become super user

      sudo su

      1. Run the FirstSwitch.py application providing it with the required set of flags (be sure you are superuser, the prompt should be a # not a >)

      python FirstSwitch.py --id <Id> --server <IP> --port <OFPort>

      • Where:
        • Id: SDN App Id found in the header of the 'SDN Applications' table on the SDN Developer Lab screen.
        • IP: IP Address of controller found in the 'SDN Controller' table on the SDN Developer Lab screen.
        • OFPort: TCP port number that the controller is listening on for OpenFlow connections. It is found in the 'SDN Controller' table on the SDN Developer Lab screen.
      1. At this point Mininet runs, creates a virtual switch, connects it to your SDN Developer Lab and connects two virtual hosts (endpoints) to the virtual switch. Leave this window open and running.
      2. Return to Quick Start Guide

Notes

1. If you want a different topology with more hosts, switches or connections then make a copy of FirstSwitch.py and edit it and then run it instead of FirstSwitch.py.