From 6d1c5491ffc6dd72c6a93083a5aaba29378e9a72 Mon Sep 17 00:00:00 2001 From: Sofia Wallin Date: Thu, 5 Oct 2017 14:34:05 +0200 Subject: Updated doc structure and added index file Created userguide/ under release/ and added an index.rst to enable document rendering. Change-Id: I868b4f5d4834b28b3fd184550a13f087cbe19b1c Signed-off-by: Sofia Wallin (cherry picked from commit 8b0f080fafe6fd3e150cb669f8087ec1c2b9be23) --- docs/release/userguide.rst | 112 ----------------------------------- docs/release/userguide/index.rst | 15 +++++ docs/release/userguide/userguide.rst | 112 +++++++++++++++++++++++++++++++++++ 3 files changed, 127 insertions(+), 112 deletions(-) delete mode 100644 docs/release/userguide.rst create mode 100644 docs/release/userguide/index.rst create mode 100644 docs/release/userguide/userguide.rst diff --git a/docs/release/userguide.rst b/docs/release/userguide.rst deleted file mode 100644 index 706eb8a..0000000 --- a/docs/release/userguide.rst +++ /dev/null @@ -1,112 +0,0 @@ -.. _opnfv-user-config: - -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. SPDX-License-Identifier: CC-BY-4.0 -.. (c) Sofia Wallin (sofia.wallin@ericssion.com) - -================================= -OpenContrail in OPNFV -================================= - -Introduction -============ - -OpenContrail provides virtual networking in OpenStack by providing a complete -implementation of the Neutron networking API in a combination of a controller -and a forwarding element (vRouter) that is installed in place of Linux bridge -Open vSwitch. OpenContrail uses XMPP for the management and control plane between -the controller and the vRouters, and uses BGP for the control plane to physical devices. - OpenContrail uses overlay networking between vRouters -to deliver highly scalable, multi-tenant connectivity with fine-grained network -policy and many L2 and L3 networking features not available in the standard -Neutron API, such as, ARP-proxy, ACLs, ECMP load-balancing, service chaining, -port mirroring. In addition, OpenContrail provides analytics based on collection of metrics -from the virtual and physical infrastructure. - -More details on the OpenContrail architecture and its operation can be found at -http://www.opencontrail.org/opencontrail-architecture-documentation/. - -Installation -============ - -In the Euphrates release of OPNFV, OpenContrail installation is supported using the -JOID installer. Installation instructions are provided in that project's -documentation. In summary, following download and deployment of JOID, OpenContrail -can be deployed using the following command in the /joid/ci directory. - -./deploy.sh -o ocata -t nonha|ha -s ocl -d xenial -l custom -m openstack - -where "nonha" or "ha" indicate if a single instance, or highly available multi-instance -OpenStack/OpenContrail environment should be deployed. - -Using OpenContrail -================== - -The OpenContrail GUI is accessed at :8080 where "public_ip" is the IP address -that is used to access OpenStack services. - -The OpenContrail REST API is found at :8082. Documentation for the API can be found at: - -https://www.juniper.net/documentation/en_US/release-independent/contrail/information-products/pathway-pages/api-server/index.html - -Python libraries are available for OpenContrail and their use is described at: - -https://www.juniper.net/documentation/en_US/release-independent/contrail/information-products/pathway-pages/api-server/tutorial_with_library.html - -The OpenContrail controller is deployed in docker containers that run on the corresponding - juju services (contrail-controller, contrail-analytics, contrail-analyticsdb). This means -that OpenContrail command line utilities need to be accessed using using "docker exec". E.g. -in order to check the status of an OpenContrail cluster, issue the following command from the -Juju jumphost - -$ juju ssh contrail-controller/0 "sudo docker exec contrail-controller contrail-status" -== Contrail Control == -contrail-control: active -contrail-named: active -contrail-dns: active -contrail-control-nodemgr: active -== Contrail Config == -contrail-api: active -contrail-schema: active -contrail-svc-monitor: active -contrail-device-manager: active -contrail-config-nodemgr: active -== Contrail Web UI == -contrail-webui: active -contrail-webui-middleware: active -== Contrail Support Services == -rabbitmq-server: active (disabled on boot) -zookeeper: active -Connection to 172.16.50.153 closed. - -Note that due to the distributed containerized deployment that is used in Juju, the contrail-status -command only shows the status of services running on that node. So the same command issued to a -contrail-analytics node yields: - -$ juju ssh contrail-analytics/0 "sudo docker exec contrail-analytics contrail-status" -== Contrail Analytics == -contrail-collector: active -contrail-analytics-api: active -contrail-query-engine: active -contrail-alarm-gen: active -contrail-snmp-collector: active -contrail-topology: active -contrail-analytics-nodemgr: active -Connection to 172.16.50.153 closed. - -A set of command line python utilities are provided that implement most OpenContrail features. These -are located at /opt/contail/utils. Since the nova compute nodes have the contrail utilities installed in the base operating system, it -can be more convenient to run commands on these types of nodes after logging in using "juju ssh nova/compute/0". - -================================ -OpenContrail Community Resources -================================ - -The OpenContrail main web site is at www.opencontrail.org. - -There are various mailing lists that are used by community members to get answers about deployment and operation -of OpenContrail. The mailing lists can be joined at http://www.opencontrail.org/newsletter-and-mailing-lists/ - - -http://www.opencontrail.org/newsletter-and-mailing-lists/ - diff --git a/docs/release/userguide/index.rst b/docs/release/userguide/index.rst new file mode 100644 index 0000000..2d5dc92 --- /dev/null +++ b/docs/release/userguide/index.rst @@ -0,0 +1,15 @@ +.. _ovno-userguide: + +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. SPDX-License-Identifier: CC-BY-4.0 +.. (c) + +****************************************** +OpenContrail Virtual Networking User Guide +****************************************** + +.. toctree:: + :numbered: + :maxdepth: 2 + + userguide.rst diff --git a/docs/release/userguide/userguide.rst b/docs/release/userguide/userguide.rst new file mode 100644 index 0000000..706eb8a --- /dev/null +++ b/docs/release/userguide/userguide.rst @@ -0,0 +1,112 @@ +.. _opnfv-user-config: + +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. SPDX-License-Identifier: CC-BY-4.0 +.. (c) Sofia Wallin (sofia.wallin@ericssion.com) + +================================= +OpenContrail in OPNFV +================================= + +Introduction +============ + +OpenContrail provides virtual networking in OpenStack by providing a complete +implementation of the Neutron networking API in a combination of a controller +and a forwarding element (vRouter) that is installed in place of Linux bridge +Open vSwitch. OpenContrail uses XMPP for the management and control plane between +the controller and the vRouters, and uses BGP for the control plane to physical devices. + OpenContrail uses overlay networking between vRouters +to deliver highly scalable, multi-tenant connectivity with fine-grained network +policy and many L2 and L3 networking features not available in the standard +Neutron API, such as, ARP-proxy, ACLs, ECMP load-balancing, service chaining, +port mirroring. In addition, OpenContrail provides analytics based on collection of metrics +from the virtual and physical infrastructure. + +More details on the OpenContrail architecture and its operation can be found at +http://www.opencontrail.org/opencontrail-architecture-documentation/. + +Installation +============ + +In the Euphrates release of OPNFV, OpenContrail installation is supported using the +JOID installer. Installation instructions are provided in that project's +documentation. In summary, following download and deployment of JOID, OpenContrail +can be deployed using the following command in the /joid/ci directory. + +./deploy.sh -o ocata -t nonha|ha -s ocl -d xenial -l custom -m openstack + +where "nonha" or "ha" indicate if a single instance, or highly available multi-instance +OpenStack/OpenContrail environment should be deployed. + +Using OpenContrail +================== + +The OpenContrail GUI is accessed at :8080 where "public_ip" is the IP address +that is used to access OpenStack services. + +The OpenContrail REST API is found at :8082. Documentation for the API can be found at: + +https://www.juniper.net/documentation/en_US/release-independent/contrail/information-products/pathway-pages/api-server/index.html + +Python libraries are available for OpenContrail and their use is described at: + +https://www.juniper.net/documentation/en_US/release-independent/contrail/information-products/pathway-pages/api-server/tutorial_with_library.html + +The OpenContrail controller is deployed in docker containers that run on the corresponding + juju services (contrail-controller, contrail-analytics, contrail-analyticsdb). This means +that OpenContrail command line utilities need to be accessed using using "docker exec". E.g. +in order to check the status of an OpenContrail cluster, issue the following command from the +Juju jumphost + +$ juju ssh contrail-controller/0 "sudo docker exec contrail-controller contrail-status" +== Contrail Control == +contrail-control: active +contrail-named: active +contrail-dns: active +contrail-control-nodemgr: active +== Contrail Config == +contrail-api: active +contrail-schema: active +contrail-svc-monitor: active +contrail-device-manager: active +contrail-config-nodemgr: active +== Contrail Web UI == +contrail-webui: active +contrail-webui-middleware: active +== Contrail Support Services == +rabbitmq-server: active (disabled on boot) +zookeeper: active +Connection to 172.16.50.153 closed. + +Note that due to the distributed containerized deployment that is used in Juju, the contrail-status +command only shows the status of services running on that node. So the same command issued to a +contrail-analytics node yields: + +$ juju ssh contrail-analytics/0 "sudo docker exec contrail-analytics contrail-status" +== Contrail Analytics == +contrail-collector: active +contrail-analytics-api: active +contrail-query-engine: active +contrail-alarm-gen: active +contrail-snmp-collector: active +contrail-topology: active +contrail-analytics-nodemgr: active +Connection to 172.16.50.153 closed. + +A set of command line python utilities are provided that implement most OpenContrail features. These +are located at /opt/contail/utils. Since the nova compute nodes have the contrail utilities installed in the base operating system, it +can be more convenient to run commands on these types of nodes after logging in using "juju ssh nova/compute/0". + +================================ +OpenContrail Community Resources +================================ + +The OpenContrail main web site is at www.opencontrail.org. + +There are various mailing lists that are used by community members to get answers about deployment and operation +of OpenContrail. The mailing lists can be joined at http://www.opencontrail.org/newsletter-and-mailing-lists/ + + +http://www.opencontrail.org/newsletter-and-mailing-lists/ + -- cgit 1.2.3-korg