Create from Template
blueprintModuleCompleteKey com.atlassian.confluence.plugins.confluence-questions:ask-a-space-question-blueprint contentBlueprintId e4da771a-d1a3-4914-b7f8-1088c0fed594 templateName e4da771a-d1a3-4914-b7f8-1088c0fed594 buttonLabel Ask a Question

Getting Started

Overview

Table of Contents

Introduction

Floodlight is Java-based and intended to run with standard JDK tools and ant and can optionally be run in Eclipse.

Installation

Prerequisites

Linux

...

• Your favorite flavor of Linux
• Java development kit
  • JDK 8 for Floodlight master and above
  • JDK 7 for Floodlight v1.2 and below
• Ant or Maven to build
• Python development package
• Eclipse IDE (Eclipse Luna Preferred)

Floodlight Master and Above

To download Java 8, please refer to these instructions. Please download the latest version of Eclipse, making sure the version you choose supports Java 8. To download remaining dependencies for Floodlight master and above:

sudo apt-get install build-essential ant maven python-dev

Floodlight v1.2 and Below

To download dependencies for Floodlight v1.2 and below:

sudo apt-get install build-essential defaultopenjdk-7-jdk ant maven python-dev eclipse

Mac

• Mac OS X 10.6 or higher: older versions may work but have not been tested
• Xcode 4.1 (for 10.7 Lion) or Xcode 4.0.2 (for 10.6 Snow Leopard) (includes gcc, make, git, etc.)
• Java Development Kit 1.7: to install, ; just type 'javac' in a Terminal; this should automatically install the JDK if it isn't already present
  Eclipse (optional)
  • Java 8 for Floodlight master and above
  • Java 7 for Floodlight v1.2 and below
  • Latest version of Eclipse

  Note: Want to get started fast? You can set up an Ubuntu image on Amazon here and add the above Linux dependenciesuse our VM here, which already includes the above dependencies for Floodlight v1.2 and below.

  Windows

  Floodlight is written in Java, so it should work in Windows; however, specific instructions are not provided aside from this helpful site for using ant on Windows and this helpful site that documents how to use git on Windows. If you wish to use Windows, do so at your own risk or use our Floodlight Linux VM instead.

  Download And Build

  Floodlight is simple to download from Github and build. Please follow the following steps to either download and install a new copy of Floodlight or update an existing installation of Floodlight:

  Installing Floodlight from Scratch

  The "git clone" step below uses the master version of Floodlight. To use a specific version, specify the version branch in the "git clone" step by appending "-b <branch-name>", e.g. "-b v1.2".

  Code Block
  xml xml
  $ git clone git://github.com/floodlight/floodlight.git $ cd floodlight $ git submodule init $ git submodule update $ ant $ sudo mkdir /var/lib/floodlight $ sudo chmod 777 /var/lib/floodlight

  Updating an Existing Floodlight Installation

  The following steps show how to update Floodlight to master. Substitute "master" in the "git pull" step with your desired version's branch, e.g. "v1.1", "v1.2", etc. if you would like to switch to a different version.

  Code Block
  language bash
  $ cd floodlight $ git pull origin master $ git

  Note: This uses the master version of Floodlight.

  ...

  submodule init $ git submodule update

  If you are upgrading from Floodlight v1.2 or below to a newer version or the master branch, you should update to Java 8 at this point. Others should already have Java 8 installed or do not require it (if downgrading to v1.2 or below). Once you have satisfied this requirement, proceed with re-building the controller:

  Code Block
  language bash
  $ ant

  Running Floodlight in the Terminal

  Assuming java is in your path, you can directly run the floodlight.jar file produced by ant .from within the floodlight directory:

  Code Block
  xml xml
  $ java -jar target/floodlight.jar

  Floodlight will start running and print log and debug output to your console.

  ...

  If you would like to save your log, you can redirect it to a file.

  Eclipse IDE

  Developing Floodlight in Eclipse

  Its also possible to setup, develop and run Floodlight through Eclipse. Rather than setting up projects manually, its easily to use the Eclipse ant target.

  ...

  You now have a working Eclipse project for Floodlight. You can run the project directly through Eclipse as well. Since we use a dynamic module loading system to run Floodlight, we must configure Eclipse to launch it in the correct manner.

  Running Floodlight in Eclipse

  Create the FloodlightLaunch target:

  ...

  To then run Floodlight click on the drop-down arrow next to the Play button and select the proper target to run. These also work with debug targets.

  Simulating A Network

  Now that Floodlight is running, you need to attach it to an OpenFlow network. One of the best tools for this is Mininet, a network simulation tool.

  ...

  Code Block
  xml xml
  $ ssh -X floodlight@<vm-ip> $ sudo wireshark

  Next Steps

  If you are finished the getting started guide, you may want to check out Floodlight for Developers, where you will find useful examples, tutorials, and information to help you get started as a Floodlight developer.