Changes between Version 4 and Version 5 of Documentation/fSDN/cOpenDaylight

Timestamp:

May 27, 2015, 8:33:24 PM (9 years ago)

Author:

ssugrim

Comment:

—

Documentation/fSDN/cOpenDaylight

@@ -11 +11 @@
 The "install" process is split into two parts, Env !Prep/Download and the Karaf shell.
 
-''' Env !Prep/Download '''
+''' Env !Prep/Download '''[[BR]]
+
+First we need to prepare the install environment.
 
  1. You will need the openjdk-7:
@@ -31 +33 @@
     }}}
 
-''' Karaf '''
+''' Karaf '''[[BR]]
 
-TODO
+Once you have the environment setup, the next step is installing features via Karaf:
+
+For a basic learning switch capable controller (built for working with open-Vswitch) we will need to install ODL features to "talk" to switches. '''Note:''' No features come installed by default. To install the features needed follow these steps:
+
+ 1. Start the karaf shell
+    {{{
+/UNTARPATH/distribution-karaf-0.2.3-Helium-SR3/bin/karaf
+    }}}
+ 2. Install the following features in the listed orderd
+    {{{
+feature:install odl-base-all odl-aaa-authn odl-restconf odl-adsal-northbound odl-mdsal-apidocs odl-l2switch-switch
+feature:install odl-ovsdb-northbound
+    }}}
+ 3. Exit the karaf shell via ctrl-C
+ 4. Start the controller instance via the startup script
+    {{{
+/UNTARPATH/distribution-karaf-0.2.3-Helium-SR3/bin/start
+    }}}
+
+This will start the ODL controller. You can verify it's running by looking for
+the java process:
+{{{
+root@node1-1:~# ps -ef | grep karaf
+
+root      3188     1 33 16:11 pts/0    00:04:26 /usr/lib/jvm/java-1.7.0-openjdk-amd64/bin/java -server -Xms128M -Xmx2048m -XX:+UnlockDiagnosticVMOptions -XX:+UnsyncloadClass -XX:MaxPermSize=512m -Dcom.sun.management.jmxremote -Djava.endorsed.dirs=/usr/lib/jvm/java-1.7.0-openjdk-amd64/jre/lib/endorsed:/usr/lib/jvm/java-1.7.0-openjdk-amd64/lib/endorsed:/root/distribution-karaf-0.2.3-Helium-SR3/lib/endorsed -Djava.ext.dirs=/usr/lib/jvm/java-1.7.0-openjdk-amd64/jre/lib/ext:/usr/lib/jvm/java-1.7.0-openjdk-amd64/lib/ext:/root/distribution-karaf-0.2.3-Helium-SR3/lib/ext -Dkaraf.instances=/root/distribution-karaf-0.2.3-Helium-SR3/instances -Dkaraf.home=/root/distribution-karaf-0.2.3-Helium-SR3 -Dkaraf.base=/root/distribution-karaf-0.2.3-Helium-SR3 -Dkaraf.data=/root/distribution-karaf-0.2.3-Helium-SR3/data -Dkaraf.etc=/root/distribution-karaf-0.2.3-Helium-SR3/etc -Djava.io.tmpdir=/root/distribution-karaf-0.2.3-Helium-SR3/data/tmp -Djava.util.logging.config.file=/root/distribution-karaf-0.2.3-Helium-SR3/etc/java.util.logging.properties -Dkaraf.startLocalConsole=false -Dkaraf.startRemoteShell=true -classpath /root/distribution-karaf-0.2.3-Helium-SR3/lib/karaf-jaas-boot.jar:/root/distribution-kara -0.2.3-Helium-SR3/lib/karaf-jmx-boot.jar:/root/distribution-karaf-0.2.3-Helium-SR3/lib/karaf-org.osgi.core.jar:/root/distribution-karaf-0.2.3-Helium-SR3/lib/karaf.branding-1.0.3-Helium-SR3.jar:/root/distribution-karaf-0.2.3-Helium-SR3/lib/karaf.jar org.apache.karaf.main.Main
+}}}
+If properly running you should see this PID listening on port 6633 as well as several others.
+{{{
+root@node1-1:~# netstat -tnlup | grep 3188
+tcp6       0      0 :::8101                 :::*                    LISTEN      3188/java
+tcp6       0      0 :::6633                 :::*                    LISTEN      3188/java
+tcp6       0      0 :::1099                 :::*                    LISTEN      3188/java
+tcp6       0      0 127.0.0.1:57453         :::*                    LISTEN      3188/java
+tcp6       0      0 :::6640                 :::*                    LISTEN      3188/java
+tcp6       0      0 :::8080                 :::*                    LISTEN      3188/java
+tcp6       0      0 127.0.0.1:50353         :::*                    LISTEN      3188/java
+tcp6       0      0 127.0.0.1:40659         :::*                    LISTEN      3188/java
+tcp6       0      0 :::8181                 :::*                    LISTEN      3188/java
+tcp6       0      0 :::56886                :::*                    LISTEN      3188/java
+tcp6       0      0 127.0.0.1:7800          :::*                    LISTEN      3188/java
+tcp6       0      0 127.0.0.1:54936         :::*                    LISTEN      3188/java
+tcp6       0      0 :::8185                 :::*                    LISTEN      3188/java
+tcp6       0      0 :::44444                :::*                    LISTEN      3188/java
+tcp6       0      0 :::6653                 :::*                    LISTEN      3188/java
+tcp6       0      0 :::12001                :::*                    LISTEN      3188/java
+udp6       0      0 :::7500                 :::*                                3188/java
+}}}
+
+At this point switches should be able to connect to this controller for control messages using the default control port '''6633'''. (e.g. using mininet: mn --controller=remote,ip=CTRLIP). In ''/UNTARPATH/distribution-karaf-0.2.3-Helium-SR3/bin'' are additional control scripts for stopping the server and setting environment variables.
 
 ----