From: ulik Date: Thu, 28 Jan 2016 11:24:29 +0000 (+0100) Subject: Platformoverview structured in separate files per section and added some content X-Git-Tag: brahmaputra.1.0~28 X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=commitdiff_plain;h=refs%2Fchanges%2F93%2F8293%2F1;p=opnfvdocs.git Platformoverview structured in separate files per section and added some content Jira: DOCS-42 Next step to create platform overview document. Proper use of index.rst, separate files per major section. Started to provide content. Change-Id: I542ae1ed334d9832bbed24926213ce651d2ae4ce Signed-off-by: ulik --- diff --git a/docs/platformoverview/deploymenttools.rst b/docs/platformoverview/deploymenttools.rst new file mode 100644 index 000000000..996bca263 --- /dev/null +++ b/docs/platformoverview/deploymenttools.rst @@ -0,0 +1,46 @@ +---------------- +Deployment Tools +---------------- + +Brahmaputra provides 4 different installers. + +The installers will deploy the target platform onto a set of virtual or bare metal servers according +to the configuration files. After the deployment, it doesn't matter which of the installers had been used +to deploy the target scenario. + + +Apex +==== + +Apex is an OPNFV Installation tool based on RDO Manager that deploys OPNFV using the RDO Project +OpenStack Distribution. +RDO manager is a Triple-O based installation tool. +Triple-O is an image based life cycle deployment tool that is a member of the OpenStack Big Tent Governance. + +Apex uses Centos on all target platforms and can deploy all SDN controllers. + +Compass +======= + +Compass is an installer project based on open source project Compass, which provides automated deployment +and management of OpenStack and other distributed systems. +It can be considered as what the LiveCD to a single box for a pool of servers – bootstrapping the server pool. + +Compass is based on Ansible. +It can deploy Ubuntu or Centos as target operating system and ODL and ONOS as SDN controllers. + + +Fuel +==== + +Editors note: +Just a high level intro and link to the main fuel documents. + +Joid +==== + +Editors note: +Just a high level intro and link to the main joid documents. + + + diff --git a/docs/platformoverview/index.rst b/docs/platformoverview/index.rst index 44a48e573..6f01e571a 100644 --- a/docs/platformoverview/index.rst +++ b/docs/platformoverview/index.rst @@ -10,15 +10,14 @@ OPNFV Platform Overview document Contents: .. toctree:: - :maxdepth: 4 - - platformoverview.rst - + :maxdepth: 2 + ./introduction.rst + ./softwarearchitecture.rst + ./deploymenttools.rst + ./testcasesframework.rst Indices and tables ================== -* :ref:`genindex` -* :ref:`modindex` * :ref:`search` diff --git a/docs/platformoverview/introduction.rst b/docs/platformoverview/introduction.rst new file mode 100644 index 000000000..495655106 --- /dev/null +++ b/docs/platformoverview/introduction.rst @@ -0,0 +1,66 @@ +------------------------ +Introduction +------------------------ + +The OPNFV project provides different kinds of output to its users: + +1. **Target Software Platform** + + This provides the software which will run as NFVI and VIM in an actual NFV deployment + It is an integrated solution of several other open source projects, e.g. OpenStack, + Linux, ODL. + +2. **Deployment Tools** + + So called installers help the user deploy target software on his hardware. + OPNFV provides multiple options to do this. + +3. **Test Cases and Framework** + + The target software platform can be verified and evaluated using these testcases. + Their goal is to show that the deployed platform is usable to run VNFs. + +4. **Documentation** + + OPNFV provides the necessary documents describing target software platform, deployment + tools, tests, etc. in their architecture and usage. + +5. **Requirements** + + OPNFV community works on requirements of open source projects used in OPNFV to + make these projects better suitable for NFV telco carrier use cases. + These requirements are described in requirement documents and also forwarded + to the "upstream" projects in the format required by these projects. + +6. **Community Labs** + + OPNFV creates lab environments not only for development of OPNFV, but also to help + build the NFV ecosystem. OPNFV labs follow a defined structure and configuration. + Some of the labs have their dedicated tasks in the development environment, some of + the labs will be provided for open use. + +**OPNFV Releases** + +OPNFV bundles the target software, installers, documentation, test cases and lab +description to releases and provides documentation describing the scope and features +provided. + +Since OPNFV releases contain different options (e.g. for installers, SDN controllers, etc.) +We define a set of scenarios, that is a set of components, combinations +and associated configuration. +This set of scenarios shows which combinations of components and features are tested as +part of the OPNFV release. + +This overview document introduces these components and scenarios on a high level and +points you to more +detailed documentation. +It describes the OPNFV Brahmaputra release. + +OPNFV Requirement documents typically describe requirements that will be implemented in +later releases of OPNFV. Thus they are not part of a release package. + +Also community labs are independent of releases. Only the lab description is included in +the release and describes the requirements of a lab to successfully run Brahmaputra +deployments. + + diff --git a/docs/platformoverview/platformoverview.rst b/docs/platformoverview/platformoverview.rst deleted file mode 100644 index b590f06f7..000000000 --- a/docs/platformoverview/platformoverview.rst +++ /dev/null @@ -1,174 +0,0 @@ ------------------------- -Introduction ------------------------- - -The OPNFV project provides different kinds of output to its users: - -1. **Target Software Platform** - - This provides the software which will run as NFVI and VIM in an actual NFV deployment - It is an integrated solution of several other open source projects, e.g. OpenStack, - Linux, ODL. - -2. **Deployment Tools** - - So called installers help the user deploy target software on his hardware. - OPNFV provides multiple options to do this. - -3. **Test Cases and Framework** - - The target software platform can be verified and evaluated using these testcases. - Their goal is to show that the deployed platform is usable to run VNFs. - -4. **Documentation** - - OPNFV provides the necessary documents describing target software platform, deployment - tools, tests, etc. in their architecture and usage. - -5. **Requirements** - - OPNFV community works on requirements of open source projects used in OPNFV to - make these projects better suitable for NFV telco carrier use cases. - These requirements are described in requirement documents and also forwarded - to the "upstream" projects in the format required by these projects. - -6. **Community Labs** - - OPNFV creates lab environments not only for development of OPNFV, but also to help - build the NFV ecosystem. OPNFV labs follow a defined structure and configuration. - Some of the labs have their dedicated tasks in the development environment, some of - the labs will be provided for open use. - -**OPNFV Releases** - -OPNFV bundles the target software, installers, documentation, test cases and lab -description to releases and provides documentation describing the scope and features -provided. - -This overview document introduces these components on a high level and points you to more -detailed documentation. -It describes the OPNFV Brahmaputra release. - -OPNFV Requirement documents typically describe requirements that will be implemented in -later releases of OPNFV. Thus they are not part of a release package. - -Also community labs are independent of releases. Only the lab description is included in -the release and describes the requirements of a lab to successfully run Brahmaputra -deployments. - - ------------------------- -Target software platform ------------------------- - -Software architecture -===================== - -This section will provide information which upstream projects, versions and components are -integrated in the Brahmaputra release - -OpenStack ---------- - -OPNFV uses OpenStack as cloud management system. -Brahmaputra is based on OpenStack Liberty Release. It comprises the following sub-projects -and modules: - -* Nova -* Neutron -* Cinder -* Ceilometer -* etc. - -Operating System ----------------- - -OPNFV uses Linux on all target machines. Depending on the installers, different -distributions are supported. - -Editors note: -Add a table showing which installer supports which operating system for controller nodes and for compute nodes. - - -SDN Controllers ---------------- - -OPNFV Brahmaputra release supports three different SDN controllers: - -* OpenDaylight -* ONOS -* OpenContrail - -Depending on the SDN controller you are using, the featureset will vary. - -OpenDaylight -++++++++++++ - -Editor's note: -We need a high level paragraph here and a description of how we use ODL. - -ONOS -++++ - -Editors note: -We need a high level paragraph here and a description of how we use ONOS, especially the -relation of ONOS and ONOSFW project's integration and features. - -OpenContrail -++++++++++++ - -Editors note: -We need a high level paragraph here and a description of how we use OpenContrail, including -its vRouter capabilities. - -Data Plane ----------- - -Other Components ----------------- - -Deployment Architecture -======================= - -Editors note: -Short description that we use a typical configuration with 3 controller nodes running -OpenStack, SDN, etc. and a minimum of 2 compute nodes for deployment of the VNFs. -Also mention that we use a "jumphost" for the initial bring-up, and the deployment of the -test framework. - -In a second level of detail, describe how software is distributed over the 3 controller -nodes, compute nodes and other hardware. - -Dynamic View -============ - -Editors note: we might skip this section completely for Brahmaputra. - -Or we provide rather short statements. In later versions, we have to describe which -software is involved in which way during: - -* VNF Life Cycle (onboarding, instantiate, scaling): we can reference to other documents -* Hardware Life Cycle (mainly how to add compute nodes, but also other cases) -* ... - ----------------- -Deployment Tools ----------------- - -Brahmaputra provides 4 different installers - -Editors note: -A table to summarize main characteristics would be nice - -We also need to list restrictions or dependencies like which installer can install which SDN...... - ------------------------ -Testcases and Framework ------------------------ - -Editors note: -Just a high level description about the different types of tests and the role of yardstick as central framework. - - - - diff --git a/docs/platformoverview/softwarearchitecture.rst b/docs/platformoverview/softwarearchitecture.rst new file mode 100644 index 000000000..c8593c4d1 --- /dev/null +++ b/docs/platformoverview/softwarearchitecture.rst @@ -0,0 +1,123 @@ +------------------------ +Target software platform +------------------------ + +Software architecture +===================== + +This section will provide information which upstream projects, versions and components are +integrated in the Brahmaputra release + +OpenStack +--------- + +OPNFV uses OpenStack as cloud management system. +Brahmaputra is based on OpenStack Liberty Release. It comprises the following sub-projects +and modules: + +* Nova (Compute) +* Neutron (Network) +* Cinder (Block Storage) +* Swift (Object Storage) +* Ceilometer (Telemetry) +* Keystone (Identity) +* Glance (Image Service) +* Heat (Orchestration) +* etc. + +Some of the sub-projects are not deployed in all scenarios. +Besides target software, also deployment and test framework use OpenStack components +(Fuel, Tempest, Rally) + + +Operating System +---------------- + +OPNFV uses Linux on all target machines. Depending on the installers, different +distributions are supported. + +Ubuntu 14 supported by Fuel, Compass and Joid installers +CentOS 7 supported by Apex and Compass + + +SDN Controllers +--------------- + +OPNFV Brahmaputra release supports three different SDN controllers: + +* OpenDaylight +* ONOS +* OpenContrail + +Depending on the SDN controller you are using, the featureset will vary. + +OpenDaylight +++++++++++++ + +Editor's note: +We need a high level paragraph here and a description of how we use ODL. + + +ONOS +++++ + +Editors note: +We need a high level paragraph here and a description of how we use ONOS, especially the +relation of ONOS and ONOSFW project's integration and features. + +OpenContrail +++++++++++++ + +Editors note: +We need a high level paragraph here and a description of how we use OpenContrail, including +its vRouter capabilities. + +Data Plane +---------- + +Other Components +---------------- + +Deployment Architecture +======================= + +OPNFV starts with a typical configuration with 3 controller nodes running +OpenStack, SDN, etc. and a minimum of 2 compute nodes for deployment of VNFs. +A detailed description of this 5 node configuration can be found in pharos documentation. + +The 3 controller nodes allow to provide an HA configuration. The number of compute +nodes can be increased dynamically after the initial deployment. + +OPNFV can be deployed on bare metal or in a virtual environment, where each of the hosts +is a virtual machine and provides the virtual resources using nested virtualization. + +The initial deployment is done using a so-called "jumphost". This server (either bare metal +or virtual) is first installed with the installer program that then installs OpenStack +and other components on the controller nodes and compute nodes. See the installer +documentation for more details. + +Editors note: +In a second level of detail, describe how software is distributed over the 3 controller +nodes, compute nodes and other hardware. + +In Brahmaputra, the following scenarios are supported: + + + + +Dynamic View +============ + +Editors note: we might skip this section completely for Brahmaputra. + +Or we provide rather short statements. In later versions, we have to describe which +software is involved in which way during: + +* VNF Life Cycle (onboarding, instantiate, scaling): we can reference to other documents +* Hardware Life Cycle (mainly how to add compute nodes, but also other cases) +* ... + + + + + diff --git a/docs/platformoverview/testcasesframework.rst b/docs/platformoverview/testcasesframework.rst new file mode 100644 index 000000000..f06c98b7a --- /dev/null +++ b/docs/platformoverview/testcasesframework.rst @@ -0,0 +1,10 @@ +----------------------- +Testcases and Framework +----------------------- + +Editors note: +Just a high level description about the different types of tests and the role of yardstick as central framework. + + + +