diff options
Diffstat (limited to 'docs/userguide')
| -rw-r--r-- | docs/userguide/abstract.rst | 11 | ||||
| -rw-r--r-- | docs/userguide/general-system.rst | 4 | ||||
| -rw-r--r-- | docs/userguide/introduction.rst | 61 | ||||
| -rw-r--r-- | docs/userguide/onos.rst | 2 | ||||
| -rw-r--r-- | docs/userguide/opendaylight.rst | 2 | ||||
| -rw-r--r-- | docs/userguide/openstack.rst | 2 | ||||
| -rw-r--r-- | docs/userguide/ovs.rst | 2 |
7 files changed, 71 insertions, 13 deletions
diff --git a/docs/userguide/abstract.rst b/docs/userguide/abstract.rst index b7b22aa5b..502c3fb5f 100644 --- a/docs/userguide/abstract.rst +++ b/docs/userguide/abstract.rst @@ -1,8 +1,11 @@ Abstract -------- -This document provides guidance and instructions for using -features delivered in the Brahmaputra release of OPNFV. +OPNFV is a collaborative project aimed at providing a variety of virtualisation +deployments intended to host applications serving the networking and carrier industry. +This document provides guidance and instructions for using platform features designed +to support these applications, made available in the Brahmaputra release of OPNFV. -This document provides a guide for the usage of features and the -needed selection of tools and components as prerequisites. +This document is not intended to replace or replicate documentation from other open +source projects such as OpenStack or OpenDaylight, rather highlight the features and +capabilities delivered through the OPNFV project. diff --git a/docs/userguide/general-system.rst b/docs/userguide/general-system.rst index 3865f3dd7..b62d723c9 100644 --- a/docs/userguide/general-system.rst +++ b/docs/userguide/general-system.rst @@ -1,5 +1,5 @@ -General system usage -==================== +Usage of platform components +============================ 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 diff --git a/docs/userguide/introduction.rst b/docs/userguide/introduction.rst index a492c6efb..9ac9f0814 100644 --- a/docs/userguide/introduction.rst +++ b/docs/userguide/introduction.rst @@ -1,4 +1,59 @@ -OPNFV User Guide -================ +Overview +======== -Outline the structure and composition of the User Guide in this section. +OPNFV provides a variety of virtual infrastructure deployments designed 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. + +OPNFV Continuous Integration builds, deploys and tests combinations of virtual +infrastructure components in what are defined as scenarios. A scenario may include +components such as OpenStack, OpenDaylight, OVS, KVM etc. where each scenario will +include different source components or configurations. Scenarios are designed to +enable specific features and capabilities in the platform that can be leveraged by the +OPNFV user community. + +OPNFV Scenarios +---------------- + +Each OPNFV scenario provides unique features and capabilities, it is important to +ensure you have a scenario deployed on your infrastructure that provides the right capabilities +for your needs before working through the user guide. + +This user guide outlines how to work with key components and features in the platform, +each feature description section will indicate the scenarios that provide the components +and configurations required to use it. + +.. include:: ../scenario/featurematrix.rst + +For details on which scenario's are best for you and how to install and configure them +on your infrastructure the `OPNFV Configuration guide +<http://artifacts.opnfv.org/opnfvdocs/docs/configguide/index.html>`_ provides a definitive +reference. + +The user guide will describe how to enable and utilise features and use cases implemented and +tested on deployed OPNFV scenarios. For details of the use cases and tests that have been run +you should check the validation procedures section of the features configuration guide. This will +provide information about the specific use cases that have been validated and are working +on your deployment. + +General usage guidelines +------------------------ + +The user guide for OPNFV features and capabilities provide step by step instructions +for using features that have been configured according to the installation and configuration +instructions. + +This guide is structured in a manner that will provide usage instructions for each feature in its own +section. Identify the feature capability you would like to leverage and read through that user guide +section to understand the available usage. The combination of platform features, if available in a given +scenario and not otherwise indicated, should function by following each features section. +Dependencies between features will be highlighted in the user guide text. + +You may wish to use the platform in a manner that the development team have not foreseen, or +exercise capabilities not fully validated on the platform. If you experience issues leveraging the +platform for the uses you have envisioned the `OPNFV user mailing list <"mailto:opnfv-user@lists.opnfv.org">`_ +provides a mechanism to establish a dialog with the community to help you overcome any issues identified. + +It may be that you have identified a bug in the system, or that you are trying to execute a use case +that has not yet ben implemented. In either case OPNFV is in essence a development project +looking to ensure the required capabilities for our users are available. diff --git a/docs/userguide/onos.rst b/docs/userguide/onos.rst index 0806caae5..d4fdb59c1 100644 --- a/docs/userguide/onos.rst +++ b/docs/userguide/onos.rst @@ -1,5 +1,5 @@ ONOS User Guide -======================= +--------------- Add ONOS specific user guide information here. Needs to include OPNFV default ports and addresses and diff --git a/docs/userguide/opendaylight.rst b/docs/userguide/opendaylight.rst index 6e43c05c5..3616307e7 100644 --- a/docs/userguide/opendaylight.rst +++ b/docs/userguide/opendaylight.rst @@ -1,5 +1,5 @@ OpenDaylight User Guide -======================= +----------------------- Add opendaylight specific user guide information here. Needs to include OPNFV default ports and addresses and diff --git a/docs/userguide/openstack.rst b/docs/userguide/openstack.rst index daeb5240f..069dc4b76 100644 --- a/docs/userguide/openstack.rst +++ b/docs/userguide/openstack.rst @@ -1,5 +1,5 @@ OpenStack User Guide -==================== +-------------------- Add openstack specific user guide information here. Needs to include OPNFV default ports and addresses and diff --git a/docs/userguide/ovs.rst b/docs/userguide/ovs.rst index 9209ac61c..10e65baeb 100644 --- a/docs/userguide/ovs.rst +++ b/docs/userguide/ovs.rst @@ -1,5 +1,5 @@ OVS User Guide -============== +-------------- Add OVS specific user guide information here. Needs to include OPNFV default ports and addresses and |