...
- 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:
| Info |
|---|
Eclipse Luna version is recommended to successfully import Floodlight project. Other Eclipse version would work as well, just people sometimes might have trouble on configuring those versions(most of time, JDK issues and "unresolved compilation problem"). This tutorial is written and tested with Eclipse Luna version so that version is recommended. For Floodlight master branch, you should still ensure to have Java 8 installed in your environment and JDK 1.8 is correctly configured at Eclipse. |
| Code Block | ||||
|---|---|---|---|---|
| ||||
sudo apt-get install build-essential ant mvnmaven python-dev eclipse |
Floodlight v1.2 and Below
To download dependencies for Floodlight v1.2 and below:
| Code Block | ||||
|---|---|---|---|---|
| ||||
sudo apt-get install build-essential openjdk-7-jdk ant mvnmaven 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; just type 'javac' in a Terminal; this should automatically install the JDK if it isn't already present
- 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 use our VM here, which already includes the above dependencies for Floodlight v1.2 and below.
...
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 | ||||
|---|---|---|---|---|
| ||||
$ 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
| ||||
| Info |
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 | ||
|---|---|---|
| ||
$ cd floodlight
$ git pull origin master
$ git 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 | ||
|---|---|---|
| ||
$ ant |
Running Floodlight in the Terminal
...