From cb2ea4e9378b9e4d26830ec42321c8f3ef247d60 Mon Sep 17 00:00:00 2001 From: Sofia Wallin Date: Tue, 18 Oct 2016 16:28:59 +0200 Subject: [PATCH] Colorado 2.0 updates Updated according to comments All links updated for colorado 2.0 Link fixed in the overview doc according to Jira ticket DOCS-161 Change-Id: Ib3ff5f1159c45c6dc45601360e4e31a5210a15ec Signed-off-by: Sofia Wallin (cherry picked from commit 4e69c67a03b49020b140390932d995dc89fed776) --- docs/documentation/index.rst | 137 ++++++++++----------- .../installation.introduction.rst | 54 ++++---- docs/overview/overview.rst | 11 +- docs/userguide/userguide.introduction.rst | 48 ++++---- 4 files changed, 124 insertions(+), 126 deletions(-) diff --git a/docs/documentation/index.rst b/docs/documentation/index.rst index d885d8f5c..6f3ee54b8 100644 --- a/docs/documentation/index.rst +++ b/docs/documentation/index.rst @@ -16,21 +16,21 @@ more detailed installation instructions and descriptive documentation. Platform documentation ====================== -* `OPNFV platform overview document `_ -* `OPNFV Installation instruction `_ -* `OPNFV user guide `_ +* `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 `_ +* `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 ============================= @@ -39,140 +39,139 @@ Feature project documentation ARMband project --------------- -* `Installation instruction `_ -* `Release notes `_ +* `Installation instruction `_ +* `Release notes `_ ---------------------------------------------- Copper release documentation ---------------------------------------------- -* `Design documentation `_ -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ +* `Design documentation `_ +* `Installation instruction `_ +* `User guide `_ +* `Release notes `_ ----------------------------------------------------- Doctor features and capabilities ----------------------------------------------------- -* `Project overview `_ -* `User guide `_ -* `Release notes `_ +* `Project overview `_ +* `User guide `_ +* `Release notes `_ ---------------------------------------------------------------- Domino features and capabilities ---------------------------------------------------------------- -* `User guide `_ +* `User guide `_ ------------------------------------------------- FastDataStacks feature and scenario documentation ------------------------------------------------- -* `OpenDaylight integrated fd.io scenario description `_ +* `OpenDaylight integrated fd.io scenario description `_ ------------------------------------ IPv6 platform support and capability ------------------------------------ -* `Configuration guide `_ -* `User guide `_ +* `Configuration guide `_ +* `User guide `_ ----------- KVM for NFV ----------- -* `Installation instruction `_ -* `Configuration guide `_ -* `User guide `_ -* `Release notes `_ +* `Installation instruction `_ +* `Configuration guide `_ +* `User guide `_ +* `Release notes `_ -------------------------------- MOON security management for NFV -------------------------------- -* `Project and Scenario overview `_ -* `Installation instruction `_ -* `Configuration guide `_ -* `User guide `_ -* `Release notes `_ +* `Project and Scenario overview `_ +* `Installation instruction `_ +* `User guide `_ +* `Release notes `_ ---------------------------- Multisite datacenter project ---------------------------- -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ +* `Installation instruction `_ +* `User guide `_ +* `Release notes `_ ------------------------- Network readiness project ------------------------- -* `Requirements document `_ +* `Requirements document `_ ---------------------- ONOS framework project ---------------------- -* `Installation instruction `_ -* `User guide `_ +* `Installation instruction `_ +* `User guide `_ ---------------------------- OVSNFV release documentation ---------------------------- -* `OVS for NFV scenario description `_ -* `Configuration guide `_ -* `User guide `_ +* `OVS for NFV scenario description `_ +* `Configuration guide `_ +* `User guide `_ -------------- Parser project -------------- -* `Parser release documentation `_ -* `Installation instruction `_ -* `User guide `_ +* `Parser release documentation `_ +* `Installation instruction `_ +* `User guide `_ ------ Pharos ------ -* `Pharos specification `_ -* `Configuration guide `_ +* `Pharos specification `_ +* `Configuration guide `_ ------- Promise ------- -* `Requirement specification `_ -* `Installation and configuration guide `_ -* `User guide `_ +* `Requirement specification `_ +* `Installation and configuration guide `_ +* `User guide `_ ------ SDNVPN ------ -* `BGPVPN scenario description `_ -* `User guide `_ -* `Release notes `_ +* `BGPVPN scenario description `_ +* `User guide `_ +* `Release notes `_ --- SFC --- -* `Design documentation `_ -* `SFC scenario description `_ -* `High availability SFC scenario description `_ -* `Installation instruction `_ -* `User guide `_ -* `Release notes `_ +* `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 `_ +* `Release and development documentation `_ Test Project documentation @@ -182,28 +181,28 @@ Test Project documentation Bottlenecks documentation ------------------------- -* `Installation instruction `_ -* `Release notes `_ +* `Installation instruction `_ +* `Release notes `_ ---------------------- Functest documentation ---------------------- -* `Configuration guide `_ -* `User guide `_ -* `Developer guide `_ -* `Release notes `_ +* `Configuration guide `_ +* `User guide `_ +* `Developer guide `_ +* `Release notes `_ ------------------------- vSwitchPerf documentation ------------------------- -* `Release and development documentation `_ +* `Release and development documentation `_ ----------------------- Yardstick documentation ----------------------- -* `User guide `_ -* `Release notes `_ +* `User guide `_ +* `Release notes `_ diff --git a/docs/installationprocedure/installation.introduction.rst b/docs/installationprocedure/installation.introduction.rst index 3183ff05b..201112cad 100644 --- a/docs/installationprocedure/installation.introduction.rst +++ b/docs/installationprocedure/installation.introduction.rst @@ -26,7 +26,7 @@ it is important to understand your required target platform capabilities before configuring your target scenario. 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. ========= @@ -42,14 +42,14 @@ 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 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 `_ +- 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 `_ ====================== Installation Procedure @@ -61,10 +61,10 @@ support for the OPNFV Colorado release are; Apex, Compass4nfv, Fuel and Joid. The instructions for each toolchain can be found in these links: -- `Apex installation instruction `_ -- `Compass4nfv installation instruction `_ -- `Fuel installation instruction `_ -- `Joid installation instruction `_ +- `Apex installation instruction `_ +- `Compass4nfv installation instruction `_ +- `Fuel installation instruction `_ +- `Joid installation instruction `_ ===================== OPNFV Test Frameworks @@ -78,12 +78,12 @@ select the right test suites to run on your platform from the available projects Many of the OPNFV test project provide user-guide documentation and installation instructions as provided below: -- `Functest user guide `_ -- `Yardstick user guide `_ -- `vSwitchPerf user guide `_ -- `Software Fastpath Service Quality Metrics (SFQM) user guide `_ -- `Bottlenecks user guide `_ -- `Storage Performance Benchmarking for NFVI (StorPerf) user guide `_ +- `Functest user guide `_ +- `Yardstick user guide `_ +- `vSwitchPerf user guide `_ +- `Software Fastpath Service Quality Metrics (SFQM) user guide `_ +- `Bottlenecks user guide `_ +- `Storage Performance Benchmarking for NFVI (StorPerf) user guide `_ ============== Security Notes @@ -92,13 +92,13 @@ Security Notes The following patches were applied to fix security issues discovered in opnfv projects, during the c-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: `_ +- `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 `_ diff --git a/docs/overview/overview.rst b/docs/overview/overview.rst index 26ec052b1..5f2fc15e2 100644 --- a/docs/overview/overview.rst +++ b/docs/overview/overview.rst @@ -109,7 +109,7 @@ 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: -https://artifacts.opnfv.org/opnfvdocs/colorado/docs/installationprocedure/index.rst +http://artifacts.opnfv.org/opnfvdocs/colorado/2.0/docs/installationprocedure/index.html ----------------- Operating Systems @@ -165,7 +165,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: https://artifacts.opnfv.org/pharos/colorado/docs/specification/index.rst +can be found in pharos specification: http://artifacts.opnfv.org/pharos/colorado/2.0/docs/specification/index.html 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 @@ -219,7 +219,7 @@ Functest Functest provides a functional testing framework incorporating a number of test suites and test cases that test and verify OPNFV platform functionality. The scope of Functest and relevant test cases can be found in its -`user guide `_. +`user guide `_. Functest provides both feature project and component test suite integration, leveraging OpenStack and SDN controllers testing frameworks to verify the key components of the OPNFV @@ -283,7 +283,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/docs/configguide -.. _`OPNFV User Guide`: http://artifacts.opnfv.org/opnfvdocs/colorado/docs/userguide +.. _`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 .. _Dovetail project: https://wiki.opnfv.org/display/dovetail - diff --git a/docs/userguide/userguide.introduction.rst b/docs/userguide/userguide.introduction.rst index 9e8ae3ebb..48112e78e 100644 --- a/docs/userguide/userguide.introduction.rst +++ b/docs/userguide/userguide.introduction.rst @@ -54,32 +54,32 @@ You can find project specific usage and configuration information below: Feature Configuration Guides ============================ -- `Armband configuration guide `_ -- `Copper configuration guide `_ -- `Doctor configuration guide `_ -- `IPv6 configuration guide `_ -- `KVMforNFV configuration guide `_ -- `Moon configuration guide `_ -- `Multisite configuration guide `_ -- `ONOSFW configuration guide `_ -- `OVSNFV configuration guide `_ -- `Promise configuration guide `_ -- `SFC configuration guide `_ +- `Armband configuration guide `_ +- `Copper configuration guide `_ +- `Doctor configuration guide `_ +- `IPv6 configuration guide `_ +- `KVMforNFV configuration guide `_ +- `Moon configuration guide `_ +- `Multisite configuration guide `_ +- `ONOSFW configuration guide `_ +- `OVSNFV configuration guide `_ +- `Promise configuration guide `_ +- `SFC configuration guide `_ Feature User Guides =================== -- `Copper user guide `_ -- `Doctor user guide `_ -- `Domino user guide `_ -- `IPv6 user guide `_ -- `KVMforNFV user guide `_ -- `Moon user guide `_ -- `Multisite user guide `_ -- `ONOSFW user guide `_ -- `OVSNFV user guide `_ -- `Parser user guide `_ -- `Promise user guide `_ -- `SDNVPN user guide `_ -- `SFC user guide `_ +- `Copper user guide `_ +- `Doctor user guide `_ +- `Domino user guide `_ +- `IPv6 user guide `_ +- `KVMforNFV user guide `_ +- `Moon user guide `_ +- `Multisite user guide `_ +- `ONOSFW user guide `_ +- `OVSNFV user guide `_ +- `Parser user guide `_ +- `Promise user guide `_ +- `SDNVPN user guide `_ +- `SFC user guide `_ -- 2.16.6