From a4cf27d8797028cf0c2ffc165bf74b89375bf6f7 Mon Sep 17 00:00:00 2001 From: Rich Bennett Date: Sun, 12 Nov 2017 23:11:28 -0500 Subject: Consolidated ccsdk references ccsdk will provide documentation for multiple repos in ccsdk/distribution. Split content in settingup/index into two sections Eliminated Tutorial section now provided by setting up ONAP Change-Id: I2412dcaa03b0c6a34b90e69c950b62f56989fdb8 Issue-ID: DOC-130 Signed-off-by: Rich Bennett --- .../guides/onap-developer/settingup/components.rst | 13 ++ docs/guides/onap-developer/settingup/fullonap.rst | 162 +++++++++++++++++++ docs/guides/onap-developer/settingup/index.rst | 173 ++------------------- 3 files changed, 184 insertions(+), 164 deletions(-) create mode 100644 docs/guides/onap-developer/settingup/components.rst create mode 100644 docs/guides/onap-developer/settingup/fullonap.rst (limited to 'docs/guides/onap-developer/settingup') diff --git a/docs/guides/onap-developer/settingup/components.rst b/docs/guides/onap-developer/settingup/components.rst new file mode 100644 index 000000000..e6aaf5fb7 --- /dev/null +++ b/docs/guides/onap-developer/settingup/components.rst @@ -0,0 +1,13 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + http://creativecommons.org/licenses/by/4.0 + + +========================================= +**Setting Up individual ONAP components** +========================================= +It is possible to deploy individual components. + +The documentation to install the various components is available here: + +TODO Link to installations + diff --git a/docs/guides/onap-developer/settingup/fullonap.rst b/docs/guides/onap-developer/settingup/fullonap.rst new file mode 100644 index 000000000..61921add2 --- /dev/null +++ b/docs/guides/onap-developer/settingup/fullonap.rst @@ -0,0 +1,162 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + http://creativecommons.org/licenses/by/4.0 + Copyright 2017 ONAP + + +.. contents:: + :depth: 2 +.. + + +======================== +**Setting Up Full ONAP** +======================== + +.. _demo-installing-running-onap: + +**Context** +=========== +ONAP may be deployed in different contexts depending on your requirements. The recommended installation for Amsterdam Release is currently based on Open Stack. + +Using the Amsterdam Release installer, ONAP components may be deployed in a single tenant or multiple tenants. One tenant for all the components except DCAE, and another tenant dedicated to the DCAE components. + +The VNFs managed by ONAP may be deployed in different Open Stack tenants or based on top of VMware based infrastructure (cf MultiCloud project). + +Figure 1 + +The current installation is based on the single tenant deployment (all the ONAP components will be hosted in a unique tenant) + + +**Requirements** +================ + +OpenStack +--------- +ONAP installation is validated on `OpenStack Ocata `_ or latter release. + +The following Open Stack components must be deployed in the infrastructure: + - *Cinder* + - *Designate* + - *Glance* + - *Horizon* + - *Keystone* + +To deploy Open Stack, you can use various solutions: + - `OpenStack installer `_ + - `OPNFV Cross Community Continuous Integration - XCI installer `_ + +*Designate* component is usually not deployed using standard OpenStack installers. +Please find a guide to deploy and configure *Designate* + +Footprint +--------- +The ONAP installation requires the following footprint: + - xx VM + - xxx vCPU + - xxx RAM + - xxx Storage + - xxx floating IP + - a public SSH key + - a private SSH key + +Note that floating IP may be private IP. + +Security +-------- +The default installation assumes that the Default security group is configured to enable full access between the ONAP components. +Depending on your environment, we may need to open some security groups (eg when using the portal from your desktop) + +The following YAML file presents the ports exposed by the various components: + +.. code-block:: yaml + + --- + aai: + - 8889 + +TODO Generate the YAML file with installation + +TODO Provide a command to create the security groups + +**Deployment** +============== + +Instantiation +------------- +- To deploy ONAP, use the Heat template and follow the described guidelines in integration project. + +- The Heat template deployment may take time (up to one hour) depending on your hardware environment. + +Test the installation +--------------------- +Every ONAP component offers a HealthCheck REST API. The *Robot Virtual Machine* can be used to test that every components run smoothly. +Run the following command to perform the HealthCheck: + +.. code-block:: bash + + docker exec -it openecompete_container /var/opt/OpenECOMP_ETE/runTags.sh -i health h -d ./html -V /share/config/integration_robot_properties.py -V /share/config/integration_preload_parameters.py -V /share/config/vm_properties.py + +This testsuite will execute 31 tests towards the various ONAP components. + +Detect problems +--------------- +If all the tests are not OK, many causes are possible. +Here is a simple procedure to detect where the problem occurs: + +* Check the OpenStack Virtual Machine logs +* Connect to the Virtual Machine and check that the various containers are running. + +The list of containers are described in the following section. In case some containers are missing, check the docker logs using the following command: + +.. code-block:: bash + + sudo docker ps -a + sudo docker logs + + +**Portal configuration** +======================== +The current ONAP installation is using the onap.org domain. +To use the portal on your desktop, you must configure the following information in your *host* file (located in /etc/host for Linux or /windows/system32/drivers/etc/hosts for Windows): + +.. code-block:: bash + + 104.239.249.17 policy.api.simpledemo.onap.org + 104.130.31.25 portal.api.simpledemo.onap.org + 104.239.249.15 sdc.api.simpledemo.onap.org + 104.130.170.142 vid.api.simpledemo.onap.org + 104.239.249.72 aai.api.simpledemo.onap.org + TODO ADD ui.aai + +You can use the Horizon dashboard to get the IP adresses associated with the Virtual Machines or use the following command line: + +.. code-block:: bash + + openstack server list + +Launch the portal on the http://portal.api.simpledemo.onap.org:8989/ONAPPORTAL/login.htm + +Go to the Portal component user guide. + +Other UI documentation: + - CLAMP + - SDC Portal + - UI Case + + +**Components** +============== + +The following YAML file presents the list of containers for every Virtual Machine + +.. code-block:: yaml + + aai: + - traversal + - be + - fe + appc + - fe + + + diff --git a/docs/guides/onap-developer/settingup/index.rst b/docs/guides/onap-developer/settingup/index.rst index ed20d98c2..3dc8e5ce3 100644 --- a/docs/guides/onap-developer/settingup/index.rst +++ b/docs/guides/onap-developer/settingup/index.rst @@ -1,169 +1,14 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. - http://creativecommons.org/licenses/by/4.0 - Copyright 2017 ONAP +.. http://creativecommons.org/licenses/by/4.0 +.. Copyright 2017 AT&T Intellectual Property. All rights reserved. -.. contents:: - :depth: 2 -.. +Setting Up ONAP +=============== -======================== -**Setting Up Full ONAP** -======================== - - -**Context** -=========== -ONAP may be deployed in different contexts depending on your requirements. The recommended installation for Amsterdam Release is currenly based on OpenStack. - -Using the Amsterdam Release installer, ONAP components may be deployed in a single tenant or multiple tenants. One tenant for all the components except DCAE, and another tenant dedicated to the DCAE components. - -The VNFs managed by ONAP may be deployed in different OpenStack tenants or based on top of VMware based infrastructure (cf MultiCloud project). - -Figure 1 - -The current installation is based on the single tenant deployment (all the ONAP components will be hosted in a unique tenant) - - -**Requirements** -================ - -OpenStack ---------- -ONAP installation is validated on `OpenStack Ocata `_ or latter release. - -The following OpenStack components must be deployed in the infrastructure: - - *Cinder* - - *Designate* - - *Glance* - - *Horizon* - - *Keystone* - -To deploy OpenStack, you can use various solutions: - - `OpenStack installer `_ - - `OPNFV Cross Community Continuous Integration - XCI installer `_ - -*Designate* component is usually not deployed using standard OpenStack installers. -Please find a guide to deploy and configure *Designate* - -Footprint ---------- -The ONAP installation requires the following footprint: - - xx VM - - xxx vCPU - - xxx RAM - - xxx Storage - - xxx floating IP - - a public SSH key - - a private SSH key - -Note that floating IP may be private IP. - -Security --------- -The default installation assumes that the Default security group is configured to enable full access between the ONAP components. -Depending on your environment, we may need to open some security groups (eg when using the portal from your desktop) - -The following YAML file presents the ports exposed by the various components: - -.. code-block:: yaml - - --- - aai: - - 8889 - -TODO Generate the YAML file with installation - -TODO Provide a command to create the security groups - -**Deployment** -============== - -Instantiation -------------- -- To deploy ONAP, use the Heat template and follow the described guidelines in integration project. - -- The Heat template deployment may take time (up to one hour) depending on your hardware environment. - -Test the installation ---------------------- -Every ONAP component offers a HealthCheck REST API. The *Robot Virtual Machine* can be used to test that every components run smoothly. -Run the following command to perform the HealthCheck: - -.. code-block:: bash - - docker exec -it openecompete_container /var/opt/OpenECOMP_ETE/runTags.sh -i health h -d ./html -V /share/config/integration_robot_properties.py -V /share/config/integration_preload_parameters.py -V /share/config/vm_properties.py - -This testsuite will execute 31 tests towards the various ONAP components. - -Detect problems ---------------- -If all the tests are not OK, many causes are possible. -Here is a simple procedure to detect where the problem occurs: - -* Check the OpenStack Virtual Machine logs -* Connect to the Virtual Machine and check that the various containers are runnings. - -The list of containers are described in the following section. In case some containers are missing, check the docker logs using the following command: - -.. code-block:: bash - - sudo docker ps -a - sudo docker logs - - -**Portal configuration** -======================== -The current ONAP installation is using the onap.org domain. -To use the portal on your desktop, you must configure the following information in your *host* file (located in /etc/host for Linux or /windows/system32/drivers/etc/hosts for Windows): - -.. code-block:: bash - - 104.239.249.17 policy.api.simpledemo.onap.org - 104.130.31.25 portal.api.simpledemo.onap.org - 104.239.249.15 sdc.api.simpledemo.onap.org - 104.130.170.142 vid.api.simpledemo.onap.org - 104.239.249.72 aai.api.simpledemo.onap.org - TODO ADD ui.aai - -You can use the Horizon dashboard to get the IP adresses associated with the Virtual Machines or use the following command line: - -.. code-block:: bash - - openstack server list - -Launch the portal on the http://portal.api.simpledemo.onap.org:8989/ONAPPORTAL/login.htm - -Go to the Portal component user guide. - -Other UI documentation: - - CLAMP - - SDC Portal - - UI Case - - -**Components** -============== - -The following YAML file presents the list of containers for every Virtual Machine - -.. code-block:: yaml - - aai: - - traversal - - be - - fe - appc - - fe - - - -======================================== -**Setting Up indiviual ONAP components** -======================================== -It is possible to deploy individual components. - -The documentation to install the various components is available here: - -TODO Link to installations +.. toctree:: + :maxdepth: 1 + :titlesonly: + fullonap.rst + components.rst -- cgit 1.2.3-korg