From 44aef04afbf7bee8f922c7fbdc107d19a70acd79 Mon Sep 17 00:00:00 2001 From: Colin Dixon Date: Tue, 21 Jun 2016 15:53:16 -0700 Subject: [PATCH] Migrating project-specific install guides from adoc to reST Change-Id: I7f71015d172c6ba567a640662538288c7aeaa255 Signed-off-by: Colin Dixon --- docs/getting-started-guide/index.rst | 2 +- .../installing_opendaylight.rst | 2 + .../project-specific-guides/index.rst | 10 + .../project-specific-guides/opflex.rst | 269 +++++++++++++++++ .../ovsdb-openstack.rst | 66 ++++ .../project-specific-guides/tsdr.rst | 244 +++++++++++++++ .../project-specific-guides/vtn.rst | 134 +++++---- .../asciidoc/bk-getting-started-guide.adoc | 10 - .../asciidoc/opflex/agent-ovs-install.adoc | 281 ------------------ .../asciidoc/ovsdb/ovsdb-hwvtep-install.adoc | 38 --- .../main/asciidoc/ovsdb/ovsdb-install.adoc | 7 - .../ovsdb/ovsdb-openstack-install.adoc | 54 ---- .../asciidoc/ovsdb/ovsdb-sfc-install.adoc | 37 --- .../tsdr/tsdr-installation-guide.adoc | 211 ------------- 14 files changed, 671 insertions(+), 694 deletions(-) create mode 100644 docs/getting-started-guide/project-specific-guides/index.rst create mode 100644 docs/getting-started-guide/project-specific-guides/opflex.rst create mode 100644 docs/getting-started-guide/project-specific-guides/ovsdb-openstack.rst create mode 100644 docs/getting-started-guide/project-specific-guides/tsdr.rst rename manuals/getting-started-guide/src/main/asciidoc/vtn/vtn-install.adoc => docs/getting-started-guide/project-specific-guides/vtn.rst (58%) delete mode 100644 manuals/getting-started-guide/src/main/asciidoc/opflex/agent-ovs-install.adoc delete mode 100644 manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-hwvtep-install.adoc delete mode 100644 manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-install.adoc delete mode 100644 manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-openstack-install.adoc delete mode 100644 manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-sfc-install.adoc delete mode 100644 manuals/getting-started-guide/src/main/asciidoc/tsdr/tsdr-installation-guide.adoc diff --git a/docs/getting-started-guide/index.rst b/docs/getting-started-guide/index.rst index 9ca17ac23..f44b2bd3f 100644 --- a/docs/getting-started-guide/index.rst +++ b/docs/getting-started-guide/index.rst @@ -14,4 +14,4 @@ Getting Started Guide api installing_opendaylight release_notes - + project-specific-guides/index diff --git a/docs/getting-started-guide/installing_opendaylight.rst b/docs/getting-started-guide/installing_opendaylight.rst index 034fbff96..a690a89e6 100644 --- a/docs/getting-started-guide/installing_opendaylight.rst +++ b/docs/getting-started-guide/installing_opendaylight.rst @@ -1,3 +1,5 @@ +.. _install_odl: + Installing OpenDaylight ======================= diff --git a/docs/getting-started-guide/project-specific-guides/index.rst b/docs/getting-started-guide/project-specific-guides/index.rst new file mode 100644 index 000000000..0d9fe48a3 --- /dev/null +++ b/docs/getting-started-guide/project-specific-guides/index.rst @@ -0,0 +1,10 @@ +Project-Specific Installation Guides +==================================== + +.. toctree:: + :maxdepth: 1 + + opflex + ovsdb-openstack + tsdr + vtn diff --git a/docs/getting-started-guide/project-specific-guides/opflex.rst b/docs/getting-started-guide/project-specific-guides/opflex.rst new file mode 100644 index 000000000..b63db141d --- /dev/null +++ b/docs/getting-started-guide/project-specific-guides/opflex.rst @@ -0,0 +1,269 @@ +OpFlex agent-ovs Install Guide +============================== + +Required Packages +----------------- + +You'll need to install the following packages and their dependencies: + +* libuv +* openvswitch-gbp +* openvswitch-gbp-lib +* openvswitch-gbp-kmod +* libopflex +* libmodelgbp +* agent-ovs + +Packages are available for Red Hat Enterprise Linux 7 and Ubuntu 14.04 +LTS. Some of the examples below are specific to RHEL7 but you can run +the equivalent commands for upstart instead of systemd. + +Note that many of these steps may be performed automatically if you're +deploying this along with a larger orchestration system. + +Host Networking Configuration +----------------------------- + +You'll need to set up your VM host uplink interface. You should +ensure that the MTU of the underlying network is sufficient to handle +tunneled traffic. We will use an example of setting up *eth0* as your +uplink interface with a vlan of 4093 used for the networking control +infrastructure and tunnel data plane. + +We just need to set the MTU and disable IPv4 and IPv6 +autoconfiguration. The MTU needs to be large enough to allow both the +VXLAN header and VLAN tags to pass through without fragmenting for +best performance. We'll use 1600 bytes which should be sufficient +assuming you are using a default 1500 byte MTU on your virtual machine +traffic. If you already have any NetworkManager connections configured +for your uplink interface find the connection name and proceed to the +next step. Otherwise, create a connection with (be sure to update the +variable UPLINK_IFACE as needed):: + + UPLINK_IFACE=eth0 + nmcli c add type ethernet ifname $UPLINK_IFACE + +Now, configure your interface as follows:: + + CONNECTION_NAME="ethernet-$UPLINK_IFACE" + nmcli connection mod "$CONNECTION_NAME" connection.autoconnect yes \ + ipv4.method link-local \ + ipv6.method ignore \ + 802-3-ethernet.mtu 9000 \ + ipv4.routes '224.0.0.0/4 0.0.0.0 2000' + +Then bring up the interface with:: + + nmcli connection up "$CONNECTION_NAME" + +Next, create the infrastructure interface using the infrastructure +VLAN (4093 by default). We'll need to create a vlan subinterface of +your uplink interface, the configure DHCP on that interface. Run the +following commands. Be sure to replace the variable values if needed. If +you're not using NIC teaming, replace the variable team0 below:: + + UPLINK_IFACE=team0 + INFRA_VLAN=4093 + nmcli connection add type vlan ifname $UPLINK_IFACE.$INFRA_VLAN dev $UPLINK_IFACE id $INFRA_VLAN + nmcli connection mod vlan-$UPLINK_IFACE.$INFRA_VLAN \ + ethernet.mtu 1600 ipv4.routes '224.0.0.0/4 0.0.0.0 1000' + sed "s/CLIENT_ID/01:$(ip link show $UPLINK_IFACE | awk '/ether/ {print $2}')/" \ + > /etc/dhcp/dhclient-$UPLINK_IFACE.$INFRA_VLAN.conf <`_. + +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/ + +Preparing for Installation +-------------------------- + +Follow the instructions in :ref:`install_odl`. + +Installing OVSDB OpenStack +-------------------------- + +Install the required features with the following command:: + + feature:install odl-ovsdb-openstack + +Sample output from the Karaf console +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: shell + + opendaylight-user@root>feature:list -i | grep ovsdb + odl-ovsdb-southbound-api | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT + OpenDaylight :: southbound :: api + odl-ovsdb-southbound-impl | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT + OpenDaylight :: southbound :: impl + odl-ovsdb-southbound-impl-rest | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT + OpenDaylight :: southbound :: impl :: REST + odl-ovsdb-southbound-impl-ui | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT + OpenDaylight :: southbound :: impl :: UI + odl-ovsdb-openstack | 1.1.0-SNAPSHOT | x | ovsdb-1.1.0-SNAPSHOT + OpenDaylight :: OVSDB :: OpenStack Network Virtual + +Verifying your Installation +--------------------------- + +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 +explain everything. + +Uninstalling OVSDB OpenStack +---------------------------- + +#. Shutdown the karaf instance:: + + system:shutdown + +#. Remove what is in the ``/data`` folder of the OpenDaylight distribution. diff --git a/docs/getting-started-guide/project-specific-guides/tsdr.rst b/docs/getting-started-guide/project-specific-guides/tsdr.rst new file mode 100644 index 000000000..35502f00c --- /dev/null +++ b/docs/getting-started-guide/project-specific-guides/tsdr.rst @@ -0,0 +1,244 @@ +TSDR Installation Guide +======================= + +This document is for the user to install the artifacts that are needed +for using Time Series Data Repository (TSDR) functionality in the ODL +Controller by enabling either an HSQLDB, HBase, or Cassandra Data Store. + + +Overview +-------- + +The Time Series Data Repository (TSDR) project in OpenDaylight (ODL) creates a framework for collecting, storing, querying, and maintaining time series data in the OpenDaylight SDN controller. Please refer to the User Guide for the detailed description of the functionality of the project and how to use the corresponding features provided in TSDR. + +Pre Requisites for Installing TSDR +---------------------------------- + +The software requirements for TSDR HBase Data Store are as follows: + +* In the case when the user chooses HBase or Cassandra data store, besides the software that ODL requires, we also require HBase and Cassandra database running in single node deployment scenario. + +No additional software is required for the HSQLDB Data Stores. + +Preparing for Installation +-------------------------- + +* When using HBase data store, download HBase from the following website: + + http://archive.apache.org/dist/hbase/hbase-0.94.15/ + +* When using Cassandra data store, download Cassandra from the following website: + + http://www.eu.apache.org/dist/cassandra/2.1.10/ + +* No additional steps are required to install the TSDR HSQL Data Store. + +Installing TSDR Data Stores +--------------------------- + +Installing HSQLDB Data Store +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Once OpenDaylight distribution is up, from karaf console install the HSQLDB data store using the following command:: + + feature:install odl-tsdr-hsqldb-all + +This will install hsqldb related dependency features (and can take sometime) as well as openflow statistics collector before returning control to the console. + + +Installing HBase Data Store +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Installing TSDR HBase Data Store contains two steps: + +#. Installing HBase server, and +#. Installing TSDR HBase Data Store features from ODL Karaf console. + +In Beryllium, we only support HBase single node running together on the same machine as OpenDaylight. Therefore, follow the steps to download and install HBase server onto the same machine as where OpenDaylight is running: + +#. Create a folder in Linux operating system for the HBase server. For example, create an hbase directory under ``/usr/lib``:: + + mkdir /usr/lib/hbase + +#. Unzip the downloaded HBase server tar file. + + Run the following command to unzip the installation package:: + + tar xvf /usr/lib/hbase + +#. Make proper changes in hbase-site.xml + + #. Under /conf/, there is a hbase-site.xml. Although it is not recommended, an experienced user with HBase can modify the data directory for hbase server to store the data. + + #. Modify the value of the property with name "hbase.rootdir" in the file to reflect the desired file directory for storing hbase data. + + The following is an example of the file:: + + + + hbase.rootdir + file:///usr/lib/hbase/data + + + hbase.zookeeper.property.dataDir + /usr/lib/hbase/zookeeper + + + +#. start hbase server:: + + cd + ./start-hbase.sh + +#. start hbase shell:: + + cd + ./hbase shell + +#. start Karaf console + +#. install hbase data store feature from Karaf console:: + + feature:install odl-tsdr-hbase + +Installing Cassandra Data Store +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Installing TSDR Cassandra Data Store contains two steps: + +#. Installing Cassandra server, and +#. Installing TSDR Cassandra Data Store features from ODL Karaf console. + +In Beryllium, we only support Cassadra single node running together on the same machine as OpenDaylight. Therefore, follow these steps to download and install Cassandra server onto the same machine as where OpenDaylight is running: + +#. Install Cassandra (latest stable version) by downloading the zip file and untar the tar ball to cassandra/ directory on the testing machine:: + + mkdir cassandra + wget http://www.eu.apache.org/dist/cassandra/2.1.10/apache-cassandra-2.1.10-bin.tar.gz[2.1.10 is current stable version, it can vary] + mv apache-cassandra-2.1.10-bin.tar.gz cassandra/ + cd cassandra + tar -xvzf apache-cassandra-2.1.10-bin.tar.gz + +#. Start Cassandra from cassandra directory by running:: + + ./apache-cassandra-2.1.10/bin/cassandra + +#. Start cassandra shell by running:: + + ./apache-cassandra-2.1.10/bin/cqlsh + +#. Start Karaf according to the instructions above. + +#. Install Cassandra data store feature from Karaf console:: + + feature:install odl-tsdr-cassandra + +Verifying your Installation +--------------------------- + +After the TSDR data store is installed, no matter whether it is HBase data store, Cassandra data store, or HSQLDB data store, the user can verify the installation with the following steps. + +#. Verify if the following two tsdr commands are available from Karaf console:: + + tsdr:list + tsdr:purgeAll + +#. Verify if openflow statisitcs data can be received successfully: + + #. Run "feature:install odl-tsdr-openflow-statistics-collector" from Karaf. + + #. Run mininet to connect to ODL controller. For example, use the following command to start a three node topology:: + + mn --topo single,3 --controller 'remote,ip=172.17.252.210,port=6653' --switch ovsk,protocols=OpenFlow13 + + #. From Karaf console, the user should be able to retrieve the statistics data of OpenFlow statistics data from the console:: + + tsdr:list FLOWSTATS + +Troubleshooting +^^^^^^^^^^^^^^^ + +Check the ``../data/log/karaf.log`` for any exception related to TSDR features. + +Post Installation Configuration +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Post Installation Configuration for HSQLDB Data Store +""""""""""""""""""""""""""""""""""""""""""""""""""""" + +The feature installation takes care of automated configuration of the datasource by installing a file in /etc named org.ops4j.datasource-metric.cfg. This contains the default location of /tsdr where the HSQLDB datastore files are stored. If you want to change the default location of the datastore files to some other location update the last portion of the url property in the org.ops4j.datasource-metric.cfg and then restart the Karaf container. + +Post Installation Configuration for HBase Data Store +"""""""""""""""""""""""""""""""""""""""""""""""""""" + +Please refer to HBase Data Store User Guide. + +Post Installation Configuration for Cassandra Data Store +"""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +There is no post configuration for TSDR Cassandra data store. + +Upgrading From a Previous Release +--------------------------------- + +The HBase data store was supported in the previous release as well as in this release. However, we do not support data store upgrade for HBase data store. +The user needs to reinstall TSDR and start to collect data in TSDR HBase datastore after the installation. + +HSQLDB and Cassandra are new data stores introduced in this release. Therefore, upgrading from previous release does not apply in these two data store scenarios. + +Uninstalling TSDR Data Stores +----------------------------- + +To uninstall TSDR HSQLDB data store +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To uninstall the TSDR functionality with the default store, you need to do the following from karaf console:: + + feature:uninstall odl-tsdr-hsqldb-all + feature:uninstall odl-tsdr-core + feature:uninstall odl-tsdr-hsqldb + feature:uninstall odl-tsdr-openflow-statistics-collector + +It is recommended to restart the Karaf container after the uninstallation of the TSDR functionality with the default store. + +To uninstall TSDR HBase Data Store +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To uninstall the TSDR functionality with the HBase data store, + +* Uninstall HBase data store related features from karaf console:: + + feature:uninstall odl-tsdr-hbase + feature:uninstall odl-tsdr-core + +* stop hbase server:: + + cd + ./stop-hbase.sh + +* remove the file directory that contains the HBase server installation:: + + rm -r + +It is recommended to restart the Karaf container after the uninstallation of the TSDR data store. + +To uninstall TSDR Cassandra Data Store +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To uninstall the TSDR functionality with the Cassandra store, + +* uninstall cassandra data store related features following from karaf console:: + + feature:uninstall odl-tsdr-cassandra + feature:uninstall odl-tsdr-core + +* stop cassandra database:: + + ps auwx | grep cassandra + sudo kill pid + +* remove the cassandra installation files:: + + rm + +It is recommended to restart the Karaf container after uninstallation of the TSDR data store. diff --git a/manuals/getting-started-guide/src/main/asciidoc/vtn/vtn-install.adoc b/docs/getting-started-guide/project-specific-guides/vtn.rst similarity index 58% rename from manuals/getting-started-guide/src/main/asciidoc/vtn/vtn-install.adoc rename to docs/getting-started-guide/project-specific-guides/vtn.rst index f06fef1bf..690650919 100644 --- a/manuals/getting-started-guide/src/main/asciidoc/vtn/vtn-install.adoc +++ b/docs/getting-started-guide/project-specific-guides/vtn.rst @@ -1,6 +1,8 @@ -== VTN Installation Guide +VTN Installation Guide +====================== -=== Overview +Overview +-------- OpenDaylight Virtual Tenant Network (VTN) is an application that provides multi-tenant virtual network on an SDN controller. @@ -12,106 +14,128 @@ VTN allows the users to define the network with a look and feel of conventional It is implemented as two major components -* <<_vtn_manager,VTN Manager>> -* <<_vtn_coordinator,VTN Coordinator>> +* :ref:`vtn_manager` +* :ref:`vtn_coordinator` -==== VTN Manager -An OpenDaylight Plugin that interacts with other modules to implement the components of the VTN model. It also provides a REST interface to configure VTN components in OpenDaylight. VTN Manager is implemented as one plugin to the OpenDaylight. This provides a REST interface to create/update/delete VTN components. The user command in VTN Coordinator is translated as REST API to VTN Manager by the OpenDaylight Driver component. In addition to the above mentioned role, it also provides an implementation to the OpenStack L2 Network Functions API. +.. _vtn_manager: -==== VTN Coordinator +VTN Manager +^^^^^^^^^^^ -The VTN Coordinator is an external application that provides a REST interface for an user to use OpenDaylight VTN Virtualization. It interacts with VTN Manager plugin to implement the user configuration. It is also capable of multiple OpenDaylight orchestration. It realizes VTN provisioning in OpenDaylight instances. In the OpenDaylight architecture VTN Coordinator is part of the network application, orchestration and services layer. VTN Coordinator will use the REST interface exposed by the VTN Manger to realize the virtual network using OpenDaylight. It uses OpenDaylight APIs (REST) to construct the virtual network in OpenDaylight instances. It provides REST APIs for northbound VTN applications and supports virtual networks spanning across multiple OpenDaylight by coordinating across OpenDaylight. +An OpenDaylight Plugin that interacts with other modules to implement the components of the VTN model. It also provides a REST interface to configure VTN components in OpenDaylight. VTN Manager is implemented as one plugin to the OpenDaylight. This provides a REST interface to create/update/delete VTN components. The user command in VTN Coordinator is translated as REST API to VTN Manager by the OpenDaylight Driver component. In addition to the above mentioned role, it also provides an implementation to the OpenStack L2 Network Functions API. + +.. _vtn_coordinator: -=== Preparing for Installation +VTN Coordinator +^^^^^^^^^^^^^^^ -==== VTN Manager +The VTN Coordinator is an external application that provides a REST interface for an user to use OpenDaylight VTN Virtualization. It interacts with VTN Manager plugin to implement the user configuration. It is also capable of multiple OpenDaylight orchestration. It realizes VTN provisioning in OpenDaylight instances. In the OpenDaylight architecture VTN Coordinator is part of the network application, orchestration and services layer. VTN Coordinator will use the REST interface exposed by the VTN Manger to realize the virtual network using OpenDaylight. It uses OpenDaylight APIs (REST) to construct the virtual network in OpenDaylight instances. It provides REST APIs for northbound VTN applications and supports virtual networks spanning across multiple OpenDaylight by coordinating across OpenDaylight. -===== Running the Karaf distribution +Preparing for Installation +-------------------------- -Follow the instructions in <<_getting_and_installing_opendaylight,Getting and Installing OpenDaylight>>. +VTN Manager +^^^^^^^^^^^ -==== VTN Coordinator +Follow the instructions in :ref:`install_odl`. -* Arrange a physical/virtual server with any one of the supported 64-bit OS environment. -** RHEL 7 -** CentOS 7 -** Fedora 20 / 21 / 22 +VTN Coordinator +^^^^^^^^^^^^^^^ -* Install these packages +#. Arrange a physical/virtual server with any one of the supported 64-bit OS environment. - yum install perl-Digest-SHA uuid libxslt libcurl unixODBC json-c bzip2 + * RHEL 7 + * CentOS 7 + * Fedora 20 / 21 / 22 - rpm -ivh http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-redhat93-9.3-1.noarch.rpm +#. Install these packages:: - yum install postgresql93-libs postgresql93 postgresql93-server postgresql93-contrib postgresql93-odbc + yum install perl-Digest-SHA uuid libxslt libcurl unixODBC json-c bzip2 + rpm -ivh http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-redhat93-9.3-1.noarch.rpm + yum install postgresql93-libs postgresql93 postgresql93-server postgresql93-contrib postgresql93-odbc -=== Installing VTN +Installing VTN +-------------- -==== VTN Manager +VTN Manager +^^^^^^^^^^^ -Install Feature +Install Feature:: - feature:install odl-vtn-manager-neutron odl-vtn-manager-rest + feature:install odl-vtn-manager-neutron odl-vtn-manager-rest -NOTE: The above command will install all features of VTN Manager. - You can install only REST or Neutron also. +.. note:: The above command will install all features of VTN Manager. + You can install only REST or Neutron also. -==== VTN Coordinator +VTN Coordinator +^^^^^^^^^^^^^^^ -* Enter into the externalapps directory in the top directory of Beryllium +* Enter into the externalapps directory in the top directory of Beryllium:: - cd distribution-karaf-0.4.0-Beryllium/externalapps + cd distribution-karaf-0.4.0-Beryllium/externalapps -* Run the below command to extract VTN Coordinator from the tar.bz2 file in the externalapps directory. +* Run the below command to extract VTN Coordinator from the tar.bz2 file in the externalapps directory:: - tar –C/ -jxvf distribution.vtn-coordinator-6.2.0-Beryllium-bin.tar.bz2 + tar –C/ -jxvf distribution.vtn-coordinator-6.2.0-Beryllium-bin.tar.bz2 This will install VTN Coordinator to /usr/local/vtn directory. The name of the tar.bz2 file name varies depending on the version. Please give the same tar.bz2 file name which is there in your directory. -* Configuring database for VTN Coordinator +* Configuring database for VTN Coordinator:: - /usr/local/vtn/sbin/db_setup + /usr/local/vtn/sbin/db_setup -* To start the Coordinator +* To start the Coordinator:: - /usr/local/vtn/bin/vtn_start + /usr/local/vtn/bin/vtn_start Using VTN REST API: -Get the version of VTN REST API using the below command, and make sure the setup is working. +Get the version of VTN REST API using the below command, and make sure the setup is working:: + + curl --user admin:adminpass -H 'content-type: application/json' -X GET http://:8083/vtn-webapi/api_version.json + +The response should be like this, but version might differ:: + + {"api_version":{"version":"V1.2"}} - curl --user admin:adminpass -H 'content-type: application/json' -X GET http://:8083/vtn-webapi/api_version.json +Verifying your Installation +--------------------------- -The response should be like this, but version might differ: +VTN Manager +^^^^^^^^^^^ - {"api_version":{"version":"V1.2"}} +* In the karaf prompt, type the below command to ensure that vtn packages are installed:: -=== Verifying your Installation + feature:list | grep vtn -==== VTN Manager +* Run any VTN Manager REST API:: -* In the karaf prompt, type the below command to ensure that vtn packages are installed. + curl --user "admin":"admin" -H "Accept: application/json" -H "Content-type: application/json" -X GET http://localhost:8181/restconf/operational/vtn:vtns - feature:list | grep vtn +VTN Coordinator +^^^^^^^^^^^^^^^ -* Run any VTN Manager REST API +.. code-block:: shell - curl --user "admin":"admin" -H "Accept: application/json" -H "Content-type: application/json" -X GET http://localhost:8181/restconf/operational/vtn:vtns + ps –ef | grep unc will list all the vtn apps + Run any REST API for VTN Coordinator version -==== VTN Coordinator +Uninstalling VTN +---------------- -* ps –ef | grep unc will list all the vtn apps -* Run any REST API for VTN Coordinator version +VTN Manager +^^^^^^^^^^^ -=== Uninstalling VTN +.. code-block:: shell -==== VTN Manager + feature:uninstall odl-vtnmanager-all - Feature:uninstall odl-vtnmanager-all +VTN Coordinator +^^^^^^^^^^^^^^^ -==== VTN Coordinator +#. Stop VTN:: - /usr/local/vtn/bin/vtn_stop + /usr/local/vtn/bin/vtn_stop - Remove the usr/local/vtn folder +#. Remove the ``usr/local/vtn`` folder diff --git a/manuals/getting-started-guide/src/main/asciidoc/bk-getting-started-guide.adoc b/manuals/getting-started-guide/src/main/asciidoc/bk-getting-started-guide.adoc index 16ef4861d..420462fa7 100644 --- a/manuals/getting-started-guide/src/main/asciidoc/bk-getting-started-guide.adoc +++ b/manuals/getting-started-guide/src/main/asciidoc/bk-getting-started-guide.adoc @@ -73,16 +73,6 @@ include::ch-controller-version.adoc[] include::chapter_security_considerations.adoc[] -= Project-specific Installation Guides - -include::opflex/agent-ovs-install.adoc[] - -include::ovsdb/ovsdb-install.adoc[] - -include::tsdr/tsdr-installation-guide.adoc[] - -include::vtn/vtn-install.adoc[] - :numbered!: ////////////////////////// diff --git a/manuals/getting-started-guide/src/main/asciidoc/opflex/agent-ovs-install.adoc b/manuals/getting-started-guide/src/main/asciidoc/opflex/agent-ovs-install.adoc deleted file mode 100644 index f9bd058cb..000000000 --- a/manuals/getting-started-guide/src/main/asciidoc/opflex/agent-ovs-install.adoc +++ /dev/null @@ -1,281 +0,0 @@ -== OpFlex agent-ovs Install Guide -=== Required Packages -You'll need to install the following packages and their dependencies: - -* libuv -* openvswitch-gbp -* openvswitch-gbp-lib -* openvswitch-gbp-kmod -* libopflex -* libmodelgbp -* agent-ovs - -Packages are available for Red Hat Enterprise Linux 7 and Ubuntu 14.04 -LTS. Some of the examples below are specific to RHEL7 but you can run -the equivalent commands for upstart instead of systemd. - -Note that many of these steps may be performed automatically if you're -deploying this along with a larger orchestration system. - -=== Host Networking Configuration - -You'll need to set up your VM host uplink interface. You should -ensure that the MTU of the underlying network is sufficient to handle -tunneled traffic. We will use an example of setting up *eth0* as your -uplink interface with a vlan of 4093 used for the networking control -infrastructure and tunnel data plane. - -We just need to set the MTU and disable IPv4 and IPv6 -autoconfiguration. The MTU needs to be large enough to allow both the -VXLAN header and VLAN tags to pass through without fragmenting for -best performance. We'll use 1600 bytes which should be sufficient -assuming you are using a default 1500 byte MTU on your virtual machine -traffic. If you already have any NetworkManager connections configured -for your uplink interface find the connection name and proceed to the -next step. Otherwise, create a connection with (be sure to update the -variable UPLINK_IFACE as needed): - ----- -UPLINK_IFACE=eth0 -nmcli c add type ethernet ifname $UPLINK_IFACE ----- - -Now, configure your interface as follows: - ----- -CONNECTION_NAME="ethernet-$UPLINK_IFACE" -nmcli connection mod "$CONNECTION_NAME" connection.autoconnect yes \ - ipv4.method link-local \ - ipv6.method ignore \ - 802-3-ethernet.mtu 9000 \ - ipv4.routes '224.0.0.0/4 0.0.0.0 2000' ----- -Then bring up the interface with - ----- -nmcli connection up "$CONNECTION_NAME" ----- - -Next, create the infrastructure interface using the infrastructure -VLAN (4093 by default). We'll need to create a vlan subinterface of -your uplink interface, the configure DHCP on that interface. Run the -following commands. Be sure to replace the variable values if needed. If -you're not using NIC teaming, replace the variable team0 below - ----- -UPLINK_IFACE=team0 -INFRA_VLAN=4093 -nmcli connection add type vlan ifname $UPLINK_IFACE.$INFRA_VLAN dev $UPLINK_IFACE id $INFRA_VLAN -nmcli connection mod vlan-$UPLINK_IFACE.$INFRA_VLAN \ - ethernet.mtu 1600 ipv4.routes '224.0.0.0/4 0.0.0.0 1000' -sed "s/CLIENT_ID/01:$(ip link show $UPLINK_IFACE | awk '/ether/ {print $2}')/" \ - > /etc/dhcp/dhclient-$UPLINK_IFACE.$INFRA_VLAN.conf <>. - -=== Installing OVSDB NetVirt Hardware VTEP -Install the required features with the following command: ------ -feature:install odl-ovsdb-netvirt-hwvtep ------ - -==== Sample output from the Karaf console ----- -TBD ----- - -=== Verifying your Installation -To verify that the installation was successful, use the following command in karaf and check that there -are no error logs relating to odl-ovsdb-netvirt-hwvtep ------ -log:display ------ - -==== Troubleshooting - -TBD - -=== Uninstalling OVSDB NetVirt Hardware VTEP -. Shutdown the karaf instance: -+ ------ -system:shutdown ------ -. Remove what is in the /data folder of the OpenDaylight Distribution. diff --git a/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-install.adoc b/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-install.adoc deleted file mode 100644 index 576872e7e..000000000 --- a/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-install.adoc +++ /dev/null @@ -1,7 +0,0 @@ - -include::ovsdb-openstack-install.adoc[] - -include::ovsdb-sfc-install.adoc[] - -include::ovsdb-hwvtep-install.adoc[] - diff --git a/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-openstack-install.adoc b/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-openstack-install.adoc deleted file mode 100644 index 5ac4c8c82..000000000 --- a/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-openstack-install.adoc +++ /dev/null @@ -1,54 +0,0 @@ -== OVSDB OpenStack Installation Guide - -=== Overview -This guide is geared towards installing OpenDaylight to use the OVSDB project to provide Neutron support for OpenStack. - -Open vSwitch (OVS) is generally accepted as the unofficial standard for Virtual Switching in the Open hypervisor based solutions. -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/ - -=== Preparing for Installation -Follow the instructions in <<_getting_and_installing_opendaylight,Getting and Installing OpenDaylight>>. - -=== Installing OVSDB OpenStack -Install the required features with the following command: ------ -feature:install odl-ovsdb-openstack ------ - -==== 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 -OpenDaylight :: southbound :: api -odl-ovsdb-southbound-impl | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT -OpenDaylight :: southbound :: impl -odl-ovsdb-southbound-impl-rest | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT -OpenDaylight :: southbound :: impl :: REST -odl-ovsdb-southbound-impl-ui | 1.1.0-SNAPSHOT | x | odl-ovsdb-southbound-1.1.0-SNAPSHOT -OpenDaylight :: southbound :: impl :: UI -odl-ovsdb-openstack | 1.1.0-SNAPSHOT | x | ovsdb-1.1.0-SNAPSHOT -OpenDaylight :: OVSDB :: OpenStack Network Virtual ----- - -=== Verifying your Installation -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 -explain everything. - -=== Uninstalling OVSDB OpenStack -. Shutdown the karaf instance: -+ ------ -system:shutdown ------ -. Remove what is in the /data folder of the OpenDaylight Distribution. diff --git a/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-sfc-install.adoc b/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-sfc-install.adoc deleted file mode 100644 index 1f8c4908d..000000000 --- a/manuals/getting-started-guide/src/main/asciidoc/ovsdb/ovsdb-sfc-install.adoc +++ /dev/null @@ -1,37 +0,0 @@ -== OVSDB Service Function Chaining Installation Guide - -=== Overview - -TBD - -=== Preparing for Installation -Follow the instructions in <<_getting_and_installing_opendaylight,Getting and Installing OpenDaylight>>. - -=== Installing OVSDB Service Function Chaining -Install the required features with the following command: ------ -feature:install odl-ovsdb-sfc-ui ------ - -==== Sample output from the Karaf console ----- -TBD ----- - -=== Verifying your Installation -To verify that the installation was successful, use the following command in karaf and check that there are -no error logs relating to odl-ovsdb-sfc ------ -log:display ------ -==== Troubleshooting - -TBD - -=== Uninstalling OVSDB Service Function Chaining -. Shutdown the karaf instance: -+ ------ -system:shutdown ------ -. Remove what is in the /data folder of the OpenDaylight Distribution. diff --git a/manuals/getting-started-guide/src/main/asciidoc/tsdr/tsdr-installation-guide.adoc b/manuals/getting-started-guide/src/main/asciidoc/tsdr/tsdr-installation-guide.adoc deleted file mode 100644 index 769d46841..000000000 --- a/manuals/getting-started-guide/src/main/asciidoc/tsdr/tsdr-installation-guide.adoc +++ /dev/null @@ -1,211 +0,0 @@ -== TSDR Installation Guide -This document is for the user to install the artifacts that are needed -for using Time Series Data Repository (TSDR) functionality in the ODL -Controller by enabling either an HSQLDB, HBase, or Cassandra Data Store. - - -=== Overview -The Time Series Data Repository (TSDR) project in OpenDaylight (ODL) creates a framework for collecting, storing, querying, and maintaining time series data in the OpenDaylight SDN controller. Please refer to the User Guide for the detailed description of the functionality of the project and how to use the corresponding features provided in TSDR. - -=== Pre Requisites for Installing TSDR -The software requirements for TSDR HBase Data Store are as follows: - -* In the case when the user chooses HBase or Cassandra data store, besides the software that ODL requires, we also require HBase and Cassandra database running in single node deployment scenario. - -No additional software is required for the HSQLDB Data Stores. - -=== Preparing for Installation -* When using HBase data store, download HBase from the following website: - - http://archive.apache.org/dist/hbase/hbase-0.94.15/ - -* When using Cassandra data store, download Cassandra from the following website: - - http://www.eu.apache.org/dist/cassandra/2.1.10/ - -* No additional steps are required to install the TSDR HSQL Data Store. - -=== Installing TSDR Data Stores -==== Installing HSQLDB Data Store -Once OpenDaylight distribution is up, from karaf console install the HSQLDB data store using the following command: - - feature:install odl-tsdr-hsqldb-all - -This will install hsqldb related dependency features (and can take sometime) as well as openflow statistics collector before returning control to the console. -e - -==== Installing HBase Data Store -Installing TSDR HBase Data Store contains two steps: - - * Installing HBase server, and - * Installing TSDR HBase Data Store features from ODL Karaf console. - -In Beryllium, we only support HBase single node running together on the same machine as OpenDaylight. Therefore, follow the steps to download and install HBase server onto the same machine as where OpenDaylight is running: - -* Create a folder in Linux operating system for the HBase server. - -For example, create an hbase directory under /usr/lib: - - mkdir /usr/lib/hbase - -* Unzip the downloaded HBase server tar file. - -Run the following command to unzip the installation package: - - tar xvf /usr/lib/hbase - -* Make proper changes in hbase-site.xml - - .. Under /conf/, there is a hbase-site.xml. Although it is not recommended, an experienced user with HBase can modify the data directory for hbase server to store the data. - - .. Modify the value of the property with name "hbase.rootdir" in the file to reflect the desired file directory for storing hbase data. - -The following is an example of the file: - - - - hbase.rootdir - file:///usr/lib/hbase/data - - - hbase.zookeeper.property.dataDir - /usr/lib/hbase/zookeeper - - - -* start hbase server - - cd - ./start-hbase.sh - -* start hbase shell - - cd - ./hbase shell - -* start Karaf console - -* install hbase data store feature from Karaf console - - feature:install odl-tsdr-hbase - -==== Installing Cassandra Data Store -Installing TSDR Cassandra Data Store contains two steps: - - * Installing Cassandra server, and - * Installing TSDR Cassandra Data Store features from ODL Karaf console. - -In Beryllium, we only support Cassadra single node running together on the same machine as OpenDaylight. Therefore, follow these steps to download and install Cassandra server onto the same machine as where OpenDaylight is running: - -Install Cassandra (latest stable version) by downloading the zip file and untar the tar ball to cassandra/ directory on the testing machine. - - mkdir cassandra - wget http://www.eu.apache.org/dist/cassandra/2.1.10/apache-cassandra-2.1.10-bin.tar.gz[2.1.10 is current stable version, it can vary] - mv apache-cassandra-2.1.10-bin.tar.gz cassandra/ - cd cassandra - tar -xvzf apache-cassandra-2.1.10-bin.tar.gz - -Start Cassandra from cassandra directory by running: - - ./apache-cassandra-2.1.10/bin/cassandra - -Start cassandra shell by running: - - ./apache-cassandra-2.1.10/bin/cqlsh - -Start Karaf according to the instructions above. - -Install Cassandra data store feature from Karaf console: - - feature:install odl-tsdr-cassandra - -=== Verifying your Installation - -After the TSDR data store is installed, no matter whether it is HBase data store, Cassandra data store, or HSQLDB data store, the user can verify the installation with the following steps. - -* Verify if the following two tsdr commands are available from Karaf console: - -** tsdr:list -** tsdr:purgeAll - -* Verify if openflow statisitcs data can be received successfully: - -** Run "feature:install odl-tsdr-openflow-statistics-collector" from Karaf. - -** Run mininet to connect to ODL controller. For example, use the following command to start a three node topology: - - "mn --topo single,3 --controller 'remote,ip=172.17.252.210,port=6653' --switch ovsk,protocols=OpenFlow13" - -** From Karaf console, the user should be able to retrieve the statistics data of OpenFlow statistics data from the console: - - tsdr:list FLOWSTATS - -==== Troubleshooting -Check the ../data/log/karaf.log for any exception related to TSDR features. - -==== Post Installation Configuration -===== Post Installation Configuration for HSQLDB Data Store - -The feature installation takes care of automated configuration of the datasource by installing a file in /etc named org.ops4j.datasource-metric.cfg. This contains the default location of /tsdr where the HSQLDB datastore files are stored. If you want to change the default location of the datastore files to some other location update the last portion of the url property in the org.ops4j.datasource-metric.cfg and then restart the Karaf container. - -===== Post Installation Configuration for HBase Data Store - -Please refer to HBase Data Store User Guide. - -===== Post Installation Configuration for Cassandra Data Store - -There is no post configuration for TSDR Cassandra data store. - -=== Upgrading From a Previous Release -The HBase data store was supported in the previous release as well as in this release. However, we do not support data store upgrade for HBase data store. -The user needs to reinstall TSDR and start to collect data in TSDR HBase datastore after the installation. - -HSQLDB and Cassandra are new data stores introduced in this release. Therefore, upgrading from previous release does not apply in these two data store scenarios. - -=== Uninstalling TSDR Data Stores -==== To uninstall TSDR HSQLDB data store -To uninstall the TSDR functionality with the default store, you need to do the following from karaf console - - feature:uninstall odl-tsdr-hsqldb-all - feature:uninstall odl-tsdr-core - feature:uninstall odl-tsdr-hsqldb - feature:uninstall odl-tsdr-openflow-statistics-collector - -It is recommended to restart the Karaf container after the uninstallation of the TSDR functionality with the default store. - -==== To uninstall TSDR HBase Data Store -To uninstall the TSDR functionality with the HBase data store, - -* Uninstall HBase data store related features from karaf console - - feature:uninstall odl-tsdr-hbase - feature:uninstall odl-tsdr-core - -* stop hbase server - - cd - ./stop-hbase.sh - -* remove the file directory that contains the HBase server installation - - rm -r - -It is recommended to restart the Karaf container after the uninstallation of the TSDR data store. -==== To uninstall TSDR Cassandra Data Store -To uninstall the TSDR functionality with the Cassandra store, - -* uninstall cassandra data store related features following from karaf console - - feature:uninstall odl-tsdr-cassandra - feature:uninstall odl-tsdr-core - -* stop cassandra database - - ps auwx | grep cassandra - sudo kill pid - -* remove the cassandra installation files - - rm - -It is recommended to restart the Karaf container after uninstallation of the TSDR data store. -- 2.36.6