.. _doc-architecture:
-Architecture
-============
+ONAP Architecture
+=================
.. toctree::
:maxdepth: 2
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0
+.. International License. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017 AT&T Intellectual Property. All rights reserved.
+
+.. _operation_guides:
+
+Operations and Administration Guides
+====================================
+The following guides are provided to describe tasks that an adminitrator and
+operator of ONAP need to perform when installing, monitoring and operating
+an instance of ONAP.
+
+.. toctree::
+ :maxdepth: 1
+
+ settingup/index.rst
+ platformoperations.rst
+ cloud_site/index.rst
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2017 AT&T Intellectual Property. All rights reserved.
+
+
+Platform Operations
+===================
+
+.. toctree::
+ :maxdepth: 1
+ :titlesonly:
+
+ONAP Operations
+---------------
+
+Configuring, scaling and upgrading ONAP is supported by OOM and can
+be found in:
+
+.. toctree::
+ :maxdepth: 2
+ :titlesonly:
+
+ ../../submodules/oom.git/docs/oom_user_guide.rst
+
+ONAP Testing and Monitoring
+---------------------------
+
+Monitoring of ONAP depends on the deployment scenario.
+Generally the infrastructure monitoring (Openstack, K8S) depends on the
+platform ONAP is installed on.
+
+Additionally ONAP supports the following additional tools to monitor ONAP
+functions
+
+**Basic Healthcheck of ONAP is supported by:**
+
+.. toctree::
+ :maxdepth: 2
+ :titlesonly:
+
+ RobotFramework <../../submodules/integration.git/docs/docs_robot.rst>
+
+**Interface Health can be checked via Consul:**
+
+ OOM provides two mechanisms to monitor the real-time health of an ONAP
+ deployment
+
+ * a Consul GUI for a human operator or downstream monitoring systems
+ and Kubernetes liveness probes that enable automatic healing of
+ failed containers, and
+ * a set of liveness probes which feed into the Kubernetes manager
+
+ Within ONAP, Consul is the monitoring system of choice and deployed
+ by OOM in two parts:
+
+ * a three-way, centralized Consul server cluster is deployed as a
+ highly available monitor of all of the ONAP components, and a number
+ of Consul agents.
+
+ The Consul server provides a user interface that allows a user to
+ graphically view the current health status of all of the ONAP components
+ for which agents have been created
+
+ The Consul GUI can be accessed via:
+
+ http://<kubernetes IP>:30270/ui/
+
+**ONAP Log collection is provided by the Logging and Analytics Module:**
+
+.. toctree::
+ :maxdepth: 2
+ :titlesonly:
+
+ Logging&Analytics <../../submodules/logging-analytics.git/docs/index.rst>
+
+ONAP Backup and Restore
+-----------------------
+
+To Backup ONAP a solution is described in Wiki (Migration to RTD->TBD):
+
+`Backup and Restore Solution <https://wiki.onap.org/display/DW/Backup+and+Restore+Solution%3A+ONAP-OOM>`_
+
+ONAP Multisite Deployment
+-------------------------
+
+ONAP Multisite deployment, coordination and management is supported by
+the MUSIC component:
+
+.. toctree::
+ :maxdepth: 2
+ :titlesonly:
+
+ Multi-Site State Coordination <../../submodules/music.git/docs/index.rst>
+
:maxdepth: 1
onapportal.rst
- platformoperations.rst
- cloud_site/index.rst
design/index.rst
instantiate/index.rst
configure/index.rst
+++ /dev/null
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. Copyright 2017 AT&T Intellectual Property. All rights reserved.
-
-
-Platform Operations
-===================
-
-.. toctree::
- :maxdepth: 1
- :titlesonly:
-
- ../../../submodules/oom.git/docs/oom_cloud_setup_guide.rst
- ../../../submodules/oom.git/docs/oom_quickstart_guide.rst
- ../../../submodules/oom.git/docs/oom_user_guide.rst
-
- Testing ONAP with RobotFramework <../../submodules/integration.git/docs/docs_robot.rst>
| | We can learn what functionalities ONAP provides and how the certain components in ONAP |
| | operate together. |
+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Setting Up ONAP <installing-onap>` | Installation guidelines and requirements help the very first set up of an |
- | | ONAP environment. The ONAP Operations Manager Cloud setup Guide and the |
- | | ONAP Operations Manager Quick Start Guide support the deployment and installation activities. |
+ | :ref:`Operations and Adminstration Guides <operation_guides>` | ONAP Platform operation and adminstration cover the configuration and installation of ONAP, |
+ | | its management, monitoring and other operational tasks (integration, user management,...) |
+ +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+
+ | :ref:`User Guides <user-guides>` | The User Guides focus on tasks to administer Services using ONAP, covering Service Design, |
+ | | instantiation and their management using control loops |
+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+
| :ref:`Developer Guides <ONAP_developer_guides>` | Developers contributing to the ONAP development can find crucial information |
| | in the Developer Guides. The reader can search among the developers’ topics |
| | in alphabetical order. |
+---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`User Guides <user-guides>` | The User Guides provide details on the ONAP portal, which portal integrates |
- | | numerous different ONAP applications at one place. Platform operations are |
- | | supported with ONAP Operations Quick Start Guide and with an ONAP Operations |
- | | User Guide. The instantiation and the management of resources and the services |
- | | are supported with a Service Design Guide and with guidelines on Service Deployment. |
- +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+
| :ref:`VNF/PNF Requirements and Guidelines <vnf_pnf_reqs>` | Harmonized VNF and PNF requirements and reduced customization of onboarding VNFs |
| | and PNFs can accelerate the optimal usage of this ONAP environment. The guidelines |
| | on VNF/PNF requirements facilitates synchronized and aligned activities for all participants. |
guides/overview/index
guides/onap-developer/architecture/index
guides/onap-developer/developing/index
- guides/onap-developer/settingup/index
- guides/onap-developer/index
+ guides/onap-operator/index
guides/onap-user/index
+ guides/onap-developer/index
guides/onap-provider/index