From 1db1bd89db4cffe08845f3042af6fc0989a71d5f Mon Sep 17 00:00:00 2001 From: ChristopherPrice Date: Wed, 29 Mar 2017 14:51:26 +0200 Subject: Updating composite docs with links, information and versions. Comments welcome. Change-Id: I1c6bca795d0d638e0867a59fa6b1fd0a17e5333c Signed-off-by: ChristopherPrice --- docs/images/opnfvplatformgraphic.png | Bin 0 -> 256545 bytes docs/release/index.rst | 208 ----------------------------- docs/release/installation.introduction.rst | 43 ++---- docs/release/overview.rst | 24 ++-- docs/release/release-notes.rst | 99 +------------- docs/release/userguide.introduction.rst | 13 +- 6 files changed, 40 insertions(+), 347 deletions(-) create mode 100644 docs/images/opnfvplatformgraphic.png delete mode 100644 docs/release/index.rst diff --git a/docs/images/opnfvplatformgraphic.png b/docs/images/opnfvplatformgraphic.png new file mode 100644 index 000000000..8039bcd32 Binary files /dev/null and b/docs/images/opnfvplatformgraphic.png differ diff --git a/docs/release/index.rst b/docs/release/index.rst deleted file mode 100644 index 6f3ee54b8..000000000 --- a/docs/release/index.rst +++ /dev/null @@ -1,208 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) Open Platform for NFV Project, Inc. and its contributors - -******************* -OPNFV Documentation -******************* - -============================== -Colorado Release Documentation -============================== - -OPNFV release documentation is structured with brief platform-level documents referencing -more detailed installation instructions and descriptive documentation. - -Platform documentation -====================== - -* `OPNFV platform overview document `_ -* `OPNFV Installation instruction `_ -* `OPNFV user guide `_ - -Installation instructions -========================= - -* `Apex installation instruction `_ -* `Apex release notes `_ -* `Compass installation instruction `_ -* `Compass release notes `_ -* `Fuel installation instruction `_ -* `Fuel release notes `_ -* `Joid installation instruction `_ -* `Joid release notes `_ - -Feature project documentation -============================= - ---------------- -ARMband project ---------------- - -* `Installation instruction `_ -* `Release notes `_ - ----------------------------------------------- -Copper release documentation ----------------------------------------------- - -* `Design documentation `_ -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ - ------------------------------------------------------ -Doctor features and capabilities ------------------------------------------------------ - -* `Project overview `_ -* `User guide `_ -* `Release notes `_ - ----------------------------------------------------------------- -Domino features and capabilities ----------------------------------------------------------------- - -* `User guide `_ - -------------------------------------------------- -FastDataStacks feature and scenario documentation -------------------------------------------------- - -* `OpenDaylight integrated fd.io scenario description `_ - ------------------------------------- -IPv6 platform support and capability ------------------------------------- - -* `Configuration guide `_ -* `User guide `_ - ------------ -KVM for NFV ------------ - -* `Installation instruction `_ -* `Configuration guide `_ -* `User guide `_ -* `Release notes `_ - --------------------------------- -MOON security management for NFV --------------------------------- - -* `Project and Scenario overview `_ -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ - ----------------------------- -Multisite datacenter project ----------------------------- - -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ - -------------------------- -Network readiness project -------------------------- - -* `Requirements document `_ - ----------------------- -ONOS framework project ----------------------- - -* `Installation instruction `_ -* `User guide `_ - ----------------------------- -OVSNFV release documentation ----------------------------- - -* `OVS for NFV scenario description `_ -* `Configuration guide `_ -* `User guide `_ - --------------- -Parser project --------------- - -* `Parser release documentation `_ -* `Installation instruction `_ -* `User guide `_ - ------- -Pharos ------- - -* `Pharos specification `_ -* `Configuration guide `_ - -------- -Promise -------- - -* `Requirement specification `_ -* `Installation and configuration guide `_ -* `User guide `_ - ------- -SDNVPN ------- - -* `BGPVPN scenario description `_ -* `User guide `_ -* `Release notes `_ - ---- -SFC ---- - -* `Design documentation `_ -* `SFC scenario description `_ -* `High availability SFC scenario description `_ -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ - ------------------------------------------------- -Software fast-path quality metrics documentation ------------------------------------------------- - -* `Release and development documentation `_ - - -Test Project documentation -========================== - -------------------------- -Bottlenecks documentation -------------------------- - -* `Installation instruction `_ -* `Release notes `_ - ----------------------- -Functest documentation ----------------------- - -* `Configuration guide `_ -* `User guide `_ -* `Developer guide `_ -* `Release notes `_ - -------------------------- -vSwitchPerf documentation -------------------------- - -* `Release and development documentation `_ - ------------------------ -Yardstick documentation ------------------------ - -* `User guide `_ -* `Release notes `_ - diff --git a/docs/release/installation.introduction.rst b/docs/release/installation.introduction.rst index bacedb76d..e31c5b1ee 100644 --- a/docs/release/installation.introduction.rst +++ b/docs/release/installation.introduction.rst @@ -10,12 +10,12 @@ Abstract ======== The following document provides an overview of the instructions required for the installation -of the Colorado release of OPNFV. +of the Danube release of OPNFV. -The Colorado release can be installed using a tool from the following -integration projects participating in OPNFV: Apex, Compass4Nfv, Fuel and JOID. -Each installer provides the ability to install a common OPNFV platform as well as integrating -additional features delivered through a variety of scenarios by the OPNFV community. +The Danube release can be installed using a tool from the following integration projects in OPNFV: +Apex, Compass4Nfv, Fuel and JOID. Each installer provides the ability to install a common OPNFV +platform as well as integrating additional features delivered through a variety of scenarios by +the OPNFV community. Introduction @@ -30,7 +30,7 @@ it is important to understand your required target platform capabilities before configuring your scenarios. An OPNFV installation requires either a physical, or virtual, infrastructure environment as defined -in the `Pharos specification `. +in the `Pharos specification `. When configuring a physical infrastructure it is strongly advised to follow the Pharos configuration guidelines. @@ -44,25 +44,17 @@ solving specific problems for the deployment of VNF’s. A scenario may, for instance, include components such as OpenStack, OpenDaylight, OVS, KVM etc., where each scenario will include different source components or configurations. -To learn more about the scenarios supported in the Colorado release refer to the scenario +To learn more about the scenarios supported in the Danube release refer to the scenario description documents provided: -- Accelerated OVS `os-nosdn-ovs `_ -- Layer 3 overlay using opendaylight `os-odl-l2-bgpvpn `_ -- FD.io based forwarding using opendaylight SDN `os-odl-12-fdio-noha `_ -- High availability service function chaining `os-odl-l2-sfc-ha `_ -- Service function chaining `os-odl-l2-sfc-noha `_ -- Accelerated KVM hypervisor `os-nosdn-kvm-ha `_ -- LXD container hypervisor `os-nosdn-lxd-noha `_ -- High Availability LXD container hypervisor `os-nosdn-lxd-ha `_ - +- Links to scenario description documents need to be added here. (todo) Installation Procedure ====================== Detailed step by step instructions for working with an installation toolchain and installing the required scenario are provided by each installation project. The four projects providing installation -support for the OPNFV Colorado release are; Apex, Compass4nfv, Fuel and Joid. +support for the OPNFV Danube release are; Apex, Compass4nfv, Fuel and Joid. The instructions for each toolchain can be found in these links: @@ -94,16 +86,7 @@ Many of the OPNFV test project provide user-guide documentation and installation Security Notes ============== -The following patches were applied to fix security issues discovered in opnfv -projects, during the Colorado release cycle. - -- `Removal of private keys `_ -- `Fix security issues of eval-s in testapi `_ -- `Implements use of yaml.safe_load `_ -- `Fix security issues reported by the security audit `_ -- `Fix issues found in security review `_ -- `Removing OpenSteak Project `_ -- `Remove unsed files in open-contrail role `_ -- `Get rid of private key in repo `_ -- `Handling file loads and tmp dirs differently `_ -- `Remove 'Debug = True' when run Flask and add logger `_ +The following patches were applied to fix security issues discovered in OPNFV +projects, during the Danube release cycle. + +- Links to security patches need to be added here. (todo) diff --git a/docs/release/overview.rst b/docs/release/overview.rst index 712430662..07a38c18a 100644 --- a/docs/release/overview.rst +++ b/docs/release/overview.rst @@ -30,9 +30,9 @@ OPNFV initially focused on building NFV Infrastructure (NFVI) and Virtualised In Management (VIM) by integrating components from upstream projects such as OpenDaylight, OpenStack, Ceph Storage, KVM, Open vSwitch, and Linux. More recently, OPNFV has extended its portfolio of forwarding solutions to include fd.io and ODP, -is able to run on both Intel and ARM commercial and white-box hardware, and includes -Management and Network Orchestration MANO components primarily for application composition -and management in the Colorado release. +is able to run on both Intel and ARM commercial and white-box hardware, support VM, Container and +BareMetal workloads, and includes Management and Network Orchestration MANO components primarily +for application composition and management in the Danube release. These capabilities, along with application programmable interfaces (APIs) to other NFV elements, form the basic infrastructure required for Virtualized Network Functions (VNF) @@ -71,7 +71,8 @@ OPNFV Lab Infrastructure The infrastructure working group oversees such topics as lab management, workflow, definitions, metrics and tools for OPNFV infrastructure. -Fundamental to the WG is the `Pharos Project `_ +Fundamental to the WG is the +`Pharos Specification `_ which provides a set of defined lab infrastructures over a geographically and technically diverse federated global OPNFV lab. @@ -111,8 +112,7 @@ an NFV domain, the OPNFV community consumes a sub-set of OpenStack projects wher composition may vary depending on the installer and scenario. For details on the scenarios available in OPNFV and the specific composition of components -refer to the OPNFV installation instruction: -http://artifacts.opnfv.org/opnfvdocs/colorado/2.0/docs/installationprocedure/index.html +refer to the `OPNFV User Guide & Configuration Guide`_ ----------------- Operating Systems @@ -168,7 +168,7 @@ A typical OPNFV deployment starts with three controller nodes running in a high configuration including control plane components from OpenStack, SDN, etc. and a minimum of two compute nodes for deployment of workloads (VNFs). A detailed description of the hardware requirements required to support the 5 node configuration -can be found in pharos specification: http://artifacts.opnfv.org/pharos/colorado/2.0/docs/specification/index.html +can be found in pharos specification: `Pharos Project `_ In addition to the deployment on a highly available physical infrastructure, OPNFV can be deployed for development and lab purposes in a virtual environment. In this case each of the hosts @@ -194,7 +194,7 @@ systems, real time and automated analysis of results, storage and publication of each run as shown in the following diagram. .. image:: ../images/OPNFV_testing_group.png - :alt: Overview infographic of the Colorado OPNFV testing Ecosystem + :alt: Overview infographic of the OPNFV testing Ecosystem Release Verification ==================== @@ -215,7 +215,7 @@ derived from the functional testing project ‘functest,’ a set of test cases platform system and performance test project ‘yardstick,’ and a selection of test cases for feature capabilities derived from other test projects such as bottlenecks, vsperf, cperf and storperf. The scenario needs to be able to be deployed, pass these tests, and be removed from -the infrastructure iteratively (no less that 4 times) in order to fulfill the release criteria. +the infrastructure iteratively (no less that 4 times) in order to fulfil the release criteria. -------- Functest @@ -257,7 +257,7 @@ OPNFV ecosystem. The Dovetail project will provide a test framework and methodology able to be used on any NFV platform, including an agreed set of test cases establishing an evaluation criteria for exercising an OPNFV compatible system. The Dovetail project has begun establishing the test framework -and will provide a preliminary methodology for the Colorado release. Work will continue to +and will provide a preliminary methodology for the Danube release. Work will continue to develop these test cases to establish a stand alone compliance evaluation solution in future releases. @@ -289,6 +289,6 @@ Bottlenecks provides a framework to find system limitations and bottlenecks, pro root cause isolation capabilities to facilitate system evaluation. -.. _`OPNFV Configuration Guide`: http://artifacts.opnfv.org/opnfvdocs/colorado/2.0/docs/configguide -.. _`OPNFV User Guide`: http://artifacts.opnfv.org/opnfvdocs/colorado/2.0/docs/userguide +.. _`OPNFV Configuration Guide`: `OPNFV User Guide & Configuration Guide` +.. _`OPNFV User Guide`: `OPNFV User Guide & Configuration Guide` .. _`Dovetail project`: https://wiki.opnfv.org/display/dovetail diff --git a/docs/release/release-notes.rst b/docs/release/release-notes.rst index 02ba32fbf..24f6dc84d 100644 --- a/docs/release/release-notes.rst +++ b/docs/release/release-notes.rst @@ -5,182 +5,97 @@ OPNFV Release Notes =================== -Apex ------ +Release notes as provided by the OPNFV participating documents are captured in this section. +These include details of software versions used, known limitations and outstanding trouble +reports. + +Project release notes: +---------------------- + :ref:`Apex Release Notes ` -Armband --------- :ref:`Armband Release Notes ` -Availability -------------- -No Release documentation - -Bottlenecks ------------- :ref:`Bottlenecks Release Notes ` -Compass4nfv ------------- :ref:`Compass4nfv Release Notes ` -Conductor ----------- :ref:`Conductor Release Notes ` -Copper -------- :ref:`Copper Release Notes ` -Daisy ------- :ref:`Daisy Release Notes ` -Doctor -------- :ref:`Doctor Release Notes ` -Domino -------- :ref:`Domino Release Notes ` -Dovetail ---------- :ref:`Dovetail Release Notes ` -Dpacc ------- :ref:`Dpacc Release Notes ` -Enfv ------ :ref:`Enfv Release Notes ` -Escalator ----------- :ref:`Escalator Release Notes ` -Fastpathmetrics ----------------- :ref:`Fastpathmetrics Release Notes ` -Fds ----- :ref:`Fds Release Notes ` -Fuel ------ :ref:`Fuel Release Notes ` -Functest ---------- :ref:`Functest Release Notes ` -Genesisreq ------------ :ref:`Genesisreq Release Notes ` -Inspector ----------- :ref:`Inspector Release Notes ` -Ipv6 ----- :ref:`Ipv6 Release Notes ` -Joid ------ :ref:`Joid Release Notes ` -Kvmfornfv ----------- :ref:`Kvmfornfv Release Notes ` -Lsoapi -------- :ref:`Lsoapi Release Notes ` -Moon ------ :ref:`Moon Release Notes ` -Multisite ----------- :ref:`Multisite Release Notes ` -Netready ---------- :ref:`Netready Release Notes ` -Octopus --------- :ref:`Octopus Release Notes ` -Onosfw -------- :ref:`Onosfw Release Notes ` -Ovsnfv -------- :ref:`Ovsnfv Release Notes ` -Parser -------- :ref:`Parser Release Notes ` -Pharos -------- :ref:`Pharos Release Notes ` -Prediction ------------ :ref:`Prediction Release Notes ` -Promise --------- :ref:`Promise Release Notes ` -QTIP ------ :ref:`QTIP Release Notes ` -Releng -------- :ref:`Releng Release Notes ` -Sdnvpn -------- :ref:`Sdnvpn Release Notes ` -Sfc ----- :ref:`Sfc Release Notes ` -Storperf ---------- :ref:`Storperf Release Notes ` -Ves ----- :ref:`Ves Release Notes ` -Vnf_Forwarding_Graph -------------------- :ref:`Vnf_Forwarding_Graph Release Notes ` -VSPERF ------------- :ref:`VSPERF Release Notes ` -Yardstick ----------- :ref:`Yardstick Release Notes ` -Ovno ------ :ref:`Ovno Release Notes ` -Snaps ------- :ref:`Snaps Release Notes ` diff --git a/docs/release/userguide.introduction.rst b/docs/release/userguide.introduction.rst index d143a743f..18f349793 100644 --- a/docs/release/userguide.introduction.rst +++ b/docs/release/userguide.introduction.rst @@ -9,11 +9,11 @@ OPNFV User Guide & Configuration Guide Abstract ======== -OPNFV is a collaborative project aimed at providing a variety of virtualization +OPNFV is a collaborative project aimed at providing a variety of virtualisation deployments intended to host applications serving the networking and carrier industries. This document provides guidance and instructions for using platform features designed to support these applications, made available in the OPNFV -Colorado release. +Danube release. This document is not intended to replace or replicate documentation from other upstream open source projects such as KVM, OpenDaylight, or OpenStack, but to highlight the @@ -24,7 +24,7 @@ Introduction ============ OPNFV provides a suite of scenarios, infrastructure deployment options, which -are able to be installed to host virtualized network functions (VNFs). +are able to be installed to host virtualised network functions (VNFs). This Guide intends to help users of the platform leverage the features and capabilities delivered by the OPNFV project. @@ -40,7 +40,7 @@ Feature Overview ================ The following links outline the feature deliverables from participating OPNFV -projects in the Colorado release. Each of the participating projects provides +projects in the Danube release. Each of the participating projects provides detailed descriptions about the delivered features including use cases, implementation and configuration specifics. @@ -62,11 +62,13 @@ Feature Configuration Guides - :ref:`IPv6 Configuration Guide ` - :ref:`KVMforNFV Configuration Guide ` - :ref:`Multisite Configuration Guide ` +- :ref:`Netready Configuration Guide ` - :ref:`ONOSFW Configuration Guide ` +- :ref:`Parser Configuration Guide ` - :ref:`Promise Configuration Guide ` +- :ref:`SDNVPN Configuration Guide ` - :ref:`SFC Configuration Guide ` - Feature User Guides =================== @@ -76,6 +78,7 @@ Feature User Guides - :ref:`IPv6 User Guide ` - :ref:`KVMforNFV User Guide ` - :ref:`Multisite User Guide ` +- :ref:`Netready User Guide ` - :ref:`ONOSFW User Guide ` - :ref:`Parser User Guide ` - :ref:`Promise User Guide ` -- cgit 1.2.3-korg