SPRING-OPEN is not built on the latest version of ONOS (Avocet). It is built on the previous (internal) release of ONOS (Sept 2014). The source code for this project is available from the url below. To try out the prototype, you will need this version of ONOS, and you will also need the CLI that works with this version of the controller. For the switches, you have the choice of using software or hardware segment-routers. The software routers are built from a version of the CPqD OF 1.3 software switch. The hardware routers are built with Dell 4810 switches.
To get started we recommend downloading the pre-built VM from the link below. This VM has the specific version of ONOS (and its dependencies), the specific CLI, and the specific version of the CPqD OF1.3 software switch required for this project. It includes the Mininet network emulator required to run the software switches in a network topology of your choice. It also includes the recommended Wireshark dissector for OF1.3.4 protocol messages from the loxigen project.
If you do not wish to use this pre-built VM, you can download from source, and follow the installation directions below.
Pre-built VM
Download the pre-built VM (2.4 GB) from the URL: http://downloads.onosproject.org/spring-open/SPRING-OPEN.ova
Get a recent version of VirtualBox to import and run the VM.
You can login to the VM with login:mininet and password:mininet. Then ifconfig to note the IP address assigned to the VM (if you used Bridged-mode and DHCP in the VM's network settings).
You should now be able to ssh into the mininet VM and follow the Getting Started Tutorial
ONOS for SPRING-OPEN
If you wish to build from source, download the SPRING-OPEN version of the ONOS controller source code. We are assuming you are running in an Ubuntu linux environment.
git clone https://gerrit.onosproject.org/spring-open
You will also need Zookeeper 3.4.6: http://apache.arvixe.com/zookeeper/stable/
Download the tar file, and untar it is your home directory.
Run the controller Setup
cd ~/spring-open ./onos.sh setup
Compile the Controller code.
mvn clean mvn compile
To run the controller
./onos.sh start
To see the controller logs
tail -f onos-logs/onos.<host-name>.log
Note that ONOS needs to be configured to run a segment routed network. See Configuring ONOS for more details.
CLI for SPRING-OPEN
The CLI used for this project is a modified version of the CLI originally submitted to open-source here: https://github.com/opendaylight/net-virt-platform/tree/master/cli
Download a basic functioning build environment plus a few build-time dependencies.
sudo apt-get install unzip python-dev python-virtualenv \ git openjdk-7-jdk ant build-essential
Download the source code
git clone https://gerrit.onosproject.org/spring-open-cli
Build the code
cd spring-open-cli ./setup.sh make
To run the CLI
$ source ./workspace/ve/bin/activate (ve)$ sudo make start-sdncon (ve)$ cd cli/ (ve)$ ./cli.py version200 default controller: 127.0.0.1:8000, SDN OS 1.0 - custom version > enable #
Dell Hardware Switches
For this you will need Dell 4810 switches. If you are a network operator and you wish to try out this prototype (for free) in your lab, contact Saurav Das or Jaiwant Virk.
Once you have the switches, you will need to load the Force10 OS (FTOS) version the binary for which can be freely downloaded here: http://downloads.onosproject.org/spring-open/FTOS-SE-1-0-0-3516.bin
<more coming soon>
CPqD Software Switch
Download the source code
git clone https://github.com/CPqD/ofsoftswitch13.git
Go back to the specific version of Cpqd
git checkout f308c28242de57502f06d3dee80ce47ac17b6603
Apply the following patch
If you save it as a file (patchfile_cpqd), then you can apply the patch as following
patch -p0 < ../patchfile_cpqd
- Build it following the README.md file in the directory