This includes content from a variety of projects participating in Brahmaputra.
We need to move to editorial work shortly, establishing a consistent style now that
we have sufficient content in place to work with.
Change-Id: I3a54358186ec788bf8cb60b2e44517c36ff53fa2
Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
echo "fuel"
echo "joid"
echo "functest"
+ echo "apex"
+ echo "promise"
+ echo "copper"
}
git_clone() {
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
========
Abstract
========
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
=====================
Configuration Options
=====================
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
=====================
Feature Configuration
=====================
The following sections describe the configuration options for specific platform features provided in Brahmaputra.
Further details for each feature are captured in the referred project documentation.
+.. include:: ../projects/copper/configguide/configguide.rst
+.. include:: ../projects/promise/configguide/featureconfig.rst
.. include:: ../projects/sdnvpn/configguide/configguide.rst
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
<Project> configuration
=======================
Add a brief introduction to configure OPNFV with this specific feature including
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
*************************
OPNFV Configuration Guide
*************************
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
=======================
Installer Configuration
=======================
The following sections describe the per installer configuration options.
Further details for each installer are captured in the referred project documentation.
+.. include:: ../projects/apex/configguide/introduction.rst
+.. include:: ../projects/apex/configguide/baremetal.rst
.. include:: ../projects/fuel/configguide/installerconfig.rst
.. include:: ../projects/joid/configguide/installerconfig.rst
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
<Project> configuration
=======================
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
=============================
Post Configuration Activities
=============================
-This section describes the post configuration activitites that will allow you to validate the success
-of your configuration. Further details may be found in the referred project specific documentation.
+Once you have deployed and configured your scenario and features you should validate the
+state of the system using the following guides.
+
+The following guides provide information on how to validate the installation of you scenario
+based on the tools and test suites available for the installation tool you have selected:
.. include:: ../projects/functest/configguide/configguide.rst
.. include:: ../projects/joid/configguide/postinstall.rst
+
+The following sections provide information on how to validate the features you have
+installed in your scenario:
+
+.. include:: ../projects/copper/configguide/postinstall.rst
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
<Project> post installation procedures
======================================
Add a brief introduction to the methods of validating the installation
-..
- This file will have links to other projects docs in composite doc build.
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
+.. This file will have links to other projects docs in composite doc build.
+
network
contribution
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
Copyright 2015 Open Platform for NFV Project, Inc. and its contributors
Open Platform for NFV Project Software Licence
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
.. OPNFV Release Engineering documentation, created by
sphinx-quickstart on Tue Jun 9 19:12:31 2015.
You can adapt this file completely to your liking, but it should at least
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
========
Abstract
========
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
==========================
Using Brahmaputra Features
==========================
-This section of the user guide provides feature specific user guides and references.
-This provides user information when leveraging the features in the platform where as a user you may
-need to perform operations, many operation in this section refer to the guides in the general system usage
-section.
+The following sections of the user guide provide feature specific usage guidelines and references.
+Providing users the necessary information to leveraging the features in the platform,
+some operation in this section may refer back to the guides in the general system usage section.
+
+.. include:: ../projects/promise/userguide/userguide.rst
+.. include:: ../projects/copper/userguide/userguide.rst
+
-============================
-Usage of platform components
-============================
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
-This section of the user guide provides general system component user guides and references.
-This provides user information for common components of the platform where as a user you may
-need to perform operations, depending on the scenario deployed and types of activities you are doing.
+================================
+Using common platform components
+================================
+
+This section outlines basic usage principans and methods for some of the commonly deployed
+components of suported OPNFV scenario's in Brahmaputra.
+The subsections provide an outline of how these components are commonly used and how to address them
+in an OPNFV deployment. The components derive from autonomous upstream communities and where possible
+this guide will provide direction ot the relevant documentation made available by those communities
+to better help you navigate the OPNFV deployment.
.. include:: ./openstack.rst
.. include:: ./opendaylight.rst
.. include:: ./onos.rst
.. include:: ./ovs.rst
-.. include:: ../projects/functest/userguide/description.rst
-.. include:: ../projects/functest/userguide/runfunctest.rst
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
****************
OPNFV User Guide
****************
./abstract
./introduction
./general-system
+ ./test-usage
./feature-usage
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
========
Overview
========
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
ONOS User Guide
===============
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
OpenDaylight User Guide
=======================
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
OpenStack User Guide
====================
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
OVS User Guide
==============
-..
- This file will have links to other projects docs in composite doc build.
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
+.. include:: ../projects/promise/userguide/userguide.rst
+
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Christopher Price (Ericsson AB)
+
+==================================
+Using the test frameworks in OPNFV
+==================================
+
+Testing is one of the key activities in OPNFV, validation can include component level testing,
+system testing, automated deployment validation and performance charecteristics testing.
+
+The following sections outline how to use the test projects delivering automated
+test suites and frameworks in the in the Brahmaputra release of OPNFV.
+
+.. include:: ../projects/functest/userguide/description.rst
+.. include:: ../projects/functest/userguide/runfunctest.rst
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
<Feature> capabilities and usage
================================
Describe the specific capabilities and usage for <XYZ> feature.
<Feature and API usage guidelines and example>
-----------------------------------------------
Describe with examples how to use specfic features.
+