| 1 | == Open Daylight Experimentation == |
| 2 | |
| 3 | The following instructions are for installing the ODL controller on Ubuntu version 13.04 on ORBIT infrastructure. |
| 4 | |
| 5 | === Installing the ODL Controller === |
| 6 | |
| 7 | The SDN controller used in the MF SDN prototype is the Open Daylight Controller. The release version is Hydrogen and we use the Base edition. |
| 8 | |
| 9 | Required Packages |
| 10 | |
| 11 | {{{ |
| 12 | sudo apt-get update |
| 13 | sudo apt-get install git maven openjdk-7-jdk openjdk-7-jre |
| 14 | }}} |
| 15 | The pre-built version of the controller can be downloaded at the following link [http://nexus.opendaylight.org/content/repositories/opendaylight.release/org/opendaylight/integration/distributions-base/0.1.1/distributions-base-0.1.1-osgipackage.zip Open Dayligth Controller Hydrogen Base Edition] |
| 16 | |
| 17 | Download and unzip the controller in a Linux machine. The controller was tested to work in Ubuntu 13.04. |
| 18 | |
| 19 | {{{ |
| 20 | unzip distributions-base-0.1.1-osgipackage.zip |
| 21 | }}} |
| 22 | For more details, visit the controller installation guide at: https://wiki.opendaylight.org/view/Release/Hydrogen/Base/Installation_Guide#Installing |
| 23 | |
| 24 | === Developing !OpenFlow 1.3 Modules with the Controller === |
| 25 | |
| 26 | For developing applications and running the controller with OF 1.3, download the openflowplugin from git at the following link: |
| 27 | |
| 28 | {{{ |
| 29 | git clone https://git.opendaylight.org/gerrit/p/openflowplugin.git |
| 30 | }}} |
| 31 | A sample application for a Learning switch is provided by the plugin. For learning to develop new modules as applications, this is a good starting point. |
| 32 | |
| 33 | Build the application: |
| 34 | |
| 35 | {{{ |
| 36 | cd openflowplugin/samples/learning-switch/ |
| 37 | mvn clean install |
| 38 | }}} |
| 39 | For running the learning switch application,do the following steps |
| 40 | |
| 41 | {{{ |
| 42 | rm opendaylight/plugins/org.opendaylight.controller.samples.simpleforwarding-0.4.1.jar |
| 43 | }}} |
| 44 | Copy the 'learning-switch-0.0.3-SNAPSHOT.jar' bundle into the ‘opendaylight/plugins' folder. |
| 45 | |
| 46 | To run the controller with OF 1.3: |
| 47 | |
| 48 | {{{ |
| 49 | cd opendaylight |
| 50 | |
| 51 | ./run.sh -of13 |
| 52 | }}} |
| 53 | To test if the learning switch is working, on the controller console: |
| 54 | |
| 55 | {{{ |
| 56 | osgi > lb learn |
| 57 | }}} |
| 58 | Now you can see the controller installing flow rules when you test the network by pinging nodes. |
| 59 | |
| 60 | For more details and information for developing applications you can visit the [https://wiki.opendaylight.org/view/OpenDaylight_Controller:Hydrogen_Developer_Guide:MD-SAL_App_Tutorial Open Daylight wiki] |
| 61 | |
| 62 | === Running the Controller === |
| 63 | |
| 64 | The controller can be started directly by running the script in the following directory |
| 65 | |
| 66 | {{{ |
| 67 | cd opendaylight |
| 68 | ./run.sh |
| 69 | }}} |
| 70 | |
| 71 | Once the controller is running,to access the GUI, point your browser to the IP address running the controller with port 8080: http://<ip-address-of-machine-where-you-ran-opendaylight>::8080 or http://127.0.0.1:8080 from the same machine running the controller |
| 72 | |
| 73 | Login with the following details: username: admin password: admin |
| 74 | |
| 75 | You can set up flow rules or make modifications using the GUI provided. |
| 76 | |
| 77 | |