Boron update of SXP aDocs
[docs.git] / manuals / getting-started-guide / src / main / asciidoc / ovsdb / ovsdb-openstack-install.adoc
index b85ebb08a02bdc1c58eb50f1ad83bbbf5fa29cbd..5ac4c8c8293641e92735b138e9cd8a078ceb2422 100644 (file)
@@ -1,4 +1,4 @@
-== OVSDB Openstack Installation Guide
+== OVSDB OpenStack Installation Guide
 
 === Overview
 This guide is geared towards installing OpenDaylight to use the OVSDB project to provide Neutron support for OpenStack.
@@ -9,23 +9,16 @@ For information on OVS, see http://openvswitch.org/[Open vSwitch].
 With OpenStack within the SDN context, controllers and applications interact using two channels: OpenFlow and OVSDB. OpenFlow addresses the forwarding-side of the OVS functionality. OVSDB, on the other hand, addresses the management-plane.
 A simple and concise overview of Open Virtual Switch Database (OVSDB) is available at: http://networkstatic.net/getting-started-ovsdb/
 
-=== Pre Requisites for Installing OVSDB Openstack
-* JRE 1.7+
-* A distribution of OpenDaylight
-
 === Preparing for Installation
-. Download a copy of the latest OpenDaylight release in a Pre-Build archive of your choosing.
-http://www.opendaylight.org/software/downloads[Download OpenDaylight]
-
+Follow the instructions in <<_getting_and_installing_opendaylight,Getting and Installing OpenDaylight>>.
 
-=== Installing OVSDB Openstack
-. Extract the OpenDaylight distribution somewhere.
-. Navigate to the /bin/ directory
-. Execute the karaf binary file, that should bring up the OpenDaylight console
-. Install the required features with these commands:
+=== Installing OVSDB OpenStack
+Install the required features with the following command:
+-----
 feature:install odl-ovsdb-openstack
+-----
 
-===== Sample output from the Karaf console
+==== Sample output from the Karaf console
 ----
 opendaylight-user@root>feature:list -i | grep ovsdb
 odl-ovsdb-southbound-api             | 1.1.0-SNAPSHOT   | x         | odl-ovsdb-southbound-1.1.0-SNAPSHOT
@@ -41,14 +34,21 @@ OpenDaylight :: OVSDB :: OpenStack Network Virtual
 ----
 
 === Verifying your Installation
-To verify that the installation was successful, use the log:display command in karaf and check that there are no errors
+To verify that the installation was successful, use the following command in karaf and check that there are no errors
 logs relating to odl-ovsdb-openstack.
+-----
+log:display
+-----
 
 ==== Troubleshooting
 There is no easy way to troubleshoot an installation of odl-ovsdb-openstack. Perhaps a combination of
-log:display | grep -i ovsdb in karaf, Open vSwitch commands (ovs-vsctl) and openstack logs will be useful but will not
+log:display | grep -i ovsdb in karaf, Open vSwitch commands (ovs-vsctl) and OpenStack logs will be useful but will not
 explain everything.
 
-=== Uninstalling OVSDB Openstack
-. Shutdown the karaf instance: system:shutdown
+=== Uninstalling OVSDB OpenStack
+. Shutdown the karaf instance:
++
+-----
+system:shutdown
+-----
 . Remove what is in the /data folder of the OpenDaylight Distribution.