Merge "Update SettingUP"

3 files changed, 20 insertions, 545 deletions

diff --git a/docs/guides/onap-developer/settingup/index.rst b/docs/guides/onap-developer/settingup/index.rst
index 2b9f8b133..f1724d4c3 100644
--- a/docs/guides/onap-developer/settingup/index.rst
+++ b/docs/guides/onap-developer/settingup/index.rst
@@ -25,17 +25,21 @@ The following is the recommended component version.
   ===========  =========
   Software     Version
   ===========  =========
-  Kubernetes   1.11.5
-  Helm         2.9.1
-  kubectl      1.11.5
-  Docker       17.03.x
+  Kubernetes   1.13.5
+  Helm         2.12.3
+  kubectl      1.13.5
+  Docker       18.09.5
   ===========  =========
 
 The ONAP full installation is validated with the following footprint:
- - 14 VM (1 Rancher, 13 K8s nodes)
-   - 8 vCPU
-   - 16 GB RAM
- - 160 GB Storage
+
+.. csv-table:: Validated installation footprint
+   :widths: 3,5,10
+
+   VM number, VM flavor, VM role
+   12, 16 GB RAM - 8 vCPUs, Running the K8S worker role
+   3, 8 GB RAM - 4 vCPUs, Running the K8S controller role
+   1, 8 GB RAM - 4 vCPUs, Running the shared NFS server for /dockerdata-nfs/
 
 Installation
 ------------
@@ -64,6 +68,14 @@ Alternative way of offline ONAP installation is described here:
 
    ../../../../submodules/oom/offline-installer.git/docs/index.rst
 
+.. note::
+   Prior to deployment of ONAP, there is no need to download manually any Docker container.
+   The OOM deployment takes care to automatically download the Docker containers.
+
+   It is also possible to deploy a subset of ONAP components on a single VM.
+   The VM flavor to be used depends on the number of ONAP components to be
+   deployed.
+
 NodePorts
 ---------
 
@@ -91,21 +103,3 @@ Kubernetes command:
 
   kubectl get svc -n onap -o go-template='{{range .items}}{{range.spec.ports}}{{if .nodePort}}{{.nodePort}}{{.}}{{"\n"}}{{end}}{{end}}{{end}}'
 
-
-.. note::
-   Prior to deployment of ONAP, there is no need to download manually any Docker container.
-   The OOM deployment takes care to automatically download the Docker containers.
-
-   It is also possible to deploy a subset of ONAP components on a single VM.
-   The VM flavor to be used depends on the number of ONAP components to be
-   deployed.
-
-.. note::
-   For test purposes, it is possible to use other installations:
-
-.. toctree::
-   :maxdepth: 1
-   :titlesonly:
-
-   onap_heat.rst
-   onap_individual.rst
diff --git a/docs/guides/onap-developer/settingup/onap_heat.rst b/docs/guides/onap-developer/settingup/onap_heat.rst
deleted file mode 100644
index 250d38ff4..000000000
--- a/docs/guides/onap-developer/settingup/onap_heat.rst
+++ /dev/null
@@ -1,488 +0,0 @@
-.. This work is licensed undera Creative Commons Attribution 4.0
-.. International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. Copyright 2017-2018 ONAP
-
-
-.. contents::
-   :depth: 2
-..
-
-.. index:: Setting Up Full ONAP using Virtual Machines
-
-==============================
-**Setting Up ONAP using Heat**
-==============================
-
-.. _installing-onap-heat:
-
-**Context**
-===========
-ONAP may be deployed in different contexts depending on your requirements.
-The recommended installation for Beijng Release over virtual machines is based
-on OpenStack Heat Template.
-
-The VNFs managed by ONAP may be deployed in different OpenStack tenants or
-based on top of VMware based infrastructure. For details, refer
-:ref:`to MultiCloud project<index-multicloud>`.
-
-The current installation is based on the single tenant deployment (all the ONAP
-components will be hosted in a unique tenant).
-
-.. note::
-   Prior to deployment of ONAP, there is no need to download manually any
-   Docker Container.
-   The Heat deployment takes care to automatically download the Docker
-   Containers.
-
-
-.. _demo-installing-running-onap-requirements:
-
-**Requirements**
-================
-
-OpenStack
----------
-ONAP installation is validated on
-`OpenStack Ocata <https://releases.openstack.org/ocata/>`_ or latter release.
-
-You can use various Cloud providers offering OpenStack based solutions.
-A list of available Cloud providers on the
-`OpenStack marketplace <https://www.openstack.org/marketplace/public-clouds/>`_.
-
-You can use your private Cloud infrastructure.
-
-The following OpenStack components must be deployed in the infrastructure:
- - *Cinder*
- - *Glance*
- - *Heat*
- - *Horizon*
- - *Keystone*
- - *Neutron*
- - *Nova*
-
-To deploy OpenStack, you can use various solutions:
- - `OpenStack installation guide <https://docs.openstack.org/install-guide/>`_
- - `OPNFV Cross Community Continuous Integration - XCI installer <http://docs.opnfv.org/en/latest/infrastructure/xci.html>`_
- - `OpenStack Ocata installation guide <https://docs.openstack.org/ocata/install/>`_
-
-.. tip::
- - Notice the documentation version mentioned in the URL, e.g. ocata/, pike/,
-   latest/ ...
- - The installation is pretty huge, some automated scripts have been created by
-   the community:
-
-  - `OpenStack installation with Ansible (All openstack services) <https://docs.openstack.org/openstack-ansible/latest/>`_
-  - `OpenStack Ocata installation scripts for testing environment(DO NOT install Heat, Designate and Cinder Volume services) <https://github.com/reachsrirams/openstack-scripts>`_
-
-The OpenStack infrastructure must enable internet access and you need to have
-an "External network" already configured properly.
-The External network ID will have to be provided in the Heat environment file.
-
-ONAP components
----------------
-The following table presents the mapping between the created VM and the ONAP
-components, and provides VM information (flavor and image):
-
-    ===================  =================   =======  ============
-    VM name              ONAP project(s)     Flavor   Image
-    ===================  =================   =======  ============
-    onap-aai-inst1       AAI                 xlarge   Ubuntu 16.04
-    onap-aai-inst2       AAI/UI              xlarge   Ubuntu 16.04
-    onap-appc            APPC, CCSDK         large    Ubuntu 16.04
-    onap-clamp           CLAMP               medium   Ubuntu 16.04
-    onap-dns-server      *Internal DNS*      small    Ubuntu 16.04
-    onap-message-router  DMAAP               large    Ubuntu 16.04
-    onap-multi-service   MSB, VF-C, VNFSDK   xlarge   Ubuntu 16.04
-    onap-policy          Policy              xlarge   Ubuntu 16.04
-    onap-portal          Portal, CLI         large    Ubuntu 16.04
-    onap-robot           Integration         medium   Ubuntu 16.04
-    onap-sdc             SDC                 xlarge   Ubuntu 16.04
-    onap-sdnc            SDNC, CCSDK         large    Ubuntu 16.04
-    onap-so              SO                  large    Ubuntu 16.04
-    onap-vid             VID                 medium   Ubuntu 16.04
-    onap-dcae            DCAE, Holmes        xlarge   Ubuntu 16.04
-    onap-music           Music               large    Ubuntu 16.04
-    onap-oof             OOF                 large    Ubuntu 16.04
-    onap-aaf             AAF                 medium   Ubuntu 16.04
-    onap-sms             AAF                 medium   Ubuntu 16.04
-    onap-nbi             External API        small    Ubuntu 16.04
-    ===================  =================   =======  ============
-
-Footprint
----------
-The ONAP installation requires the following footprint:
- - 20 VM
- - 88 vCPU
- - 176 GB RAM
- - 1.76 TB Storage
- - 20 floating IP addresses
-
-.. Note: You should also reserve some resources for the VNFs to be deployed.
-
-Artifacts
----------
-The following artifacts must be deployed on the OpenStack infrastructure:
- - a public SSH key to access the various VM
- - Ubuntu 16.04 image (https://cloud-images.ubuntu.com/releases/16.04/release/)
- - Set of flavors: small, medium, large, xlarge
-
-.. Note: The floating IP may be private IP.
-
-.. Note: Basic flavors can reuse the default flavors as defined by
-   OpenStack
-   <https://docs.openstack.org/horizon/latest/admin/manage-flavors.html>`_
-
-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 list of various services and ports used can be found on the
-`ONAP wiki - ports <https://wiki.onap.org/display/DW/ONAP+Services+List#ONAPServicesList-ONAPServices>`_.
-
-**Deployment**
-==============
-
-Source files
-------------
-
-Both following files must be downloaded and configured to match your
-configuration:
-
-- Template file:
-  https://git.onap.org/demo/plain/heat/ONAP/onap_openstack.yaml?h=casablanca
-- Environment file:
-  https://git.onap.org/demo/plain/heat/ONAP/onap_openstack.env?h=casablanca
-
-The environment file must be customized as described in the following sections.
-
-.. Note Beijing release files
-
-Description
------------
-
-The ONAP Heat template spins up all the components including the DCAE.
-The template, onap_openstack.yaml, comes with an environment file,
-onap_openstack.env, in which all the default values are defined.
-
-The Heat template is composed of two sections: (i) parameters, and (ii)
-resources.
-The parameter section contains the declaration and
-description of the parameters that will be used to spin up ONAP, such as
-public network identifier, URLs of code and artifacts repositories, etc.
-The default values of these parameters can be found in the environment
-file.
-
-The resource section contains the definition of:
-
-- ONAP Private Management Network, which ONAP components use to communicate
-  with each other and with VNFs
-- ONAP Virtual Machines (VMs)
-- Public key pair used to access ONAP VMs
-- Virtual interfaces towards the ONAP Private Management Network
-- Disk volumes
-
-Each VM specification includes Operating System image name, VM size
-(i.e. flavor), VM name, etc. Each VM has two virtual network interfaces:
-one towards the public network and one towards the ONAP Private
-Management network, as described above. Furthermore, each VM runs a
-post-instantiation script that downloads and installs software
-dependencies (e.g. Java JDK, gcc, make, Python, ...) and ONAP software
-packages and Docker containers from remote repositories.
-
-When the Heat template is executed, the OpenStack Heat engine creates
-the resources defined in the Heat template, based on the parameters
-values defined in the environment file.
-
-Environment file
-----------------
-
-Before running Heat, it is necessary to customize the environment file.
-Indeed, some parameters, namely public_net_id, pub_key,
-openstack_tenant_id, openstack_username, and openstack_api_key,
-need to be set depending on the user's environment:
-
-**Global parameters**
-
-::
-
- public_net_id:       PUT YOUR NETWORK ID/NAME HERE
- pub_key:             PUT YOUR PUBLIC KEY HERE
- openstack_tenant_id: PUT YOUR OPENSTACK PROJECT ID HERE
- openstack_username:  PUT YOUR OPENSTACK USERNAME HERE
- openstack_api_key:   PUT YOUR OPENSTACK PASSWORD HERE
- keystone_url:        PUT THE KEYSTONE URL HERE (do not include version number)
-
-openstack_region parameter is set to RegionOne (OpenStack default). If
-your OpenStack is using another Region, please modify this parameter.
-
-public_net_id is the unique identifier (UUID) or name of the public
-network of the cloud provider. To get the public_net_id, use the
-following OpenStack CLI command (ext is the name of the external
-network, change it with the name of the external network of your
-installation)
-
-::
-
- openstack network list  | grep ext |  awk '{print $2}'
-
-pub_key is string value of the public key that will be installed in
-each ONAP VM. To create a public/private key pair in Linux, please
-execute the following instruction:
-
-::
-
- user@ubuntu:~$ ssh-keygen -t rsa
-
-The following operations create the public/private key pair:
-
-::
-
- Generating public/private rsa key pair.
- Enter file in which to save the key (/home/user/.ssh/id_rsa):
- Created directory '/home/user/.ssh'.
- Enter passphrase (empty for no passphrase):
- Enter same passphrase again:
- Your identification has been saved in /home/user/.ssh/id_rsa.
- Your public key has been saved in /home/user/.ssh/id_rsa.pub.
-
-openstack_username, openstack_tenant_id (password), and
-openstack_api_key are user's credentials to access the
-OpenStack-based cloud.
-
-**Images and flavors parameters**
-
-::
-
- ubuntu_1604_image:  PUT THE UBUNTU 16.04 IMAGE NAME HERE
- flavor_small:       PUT THE SMALL FLAVOR NAME HERE
- flavor_medium:      PUT THE MEDIUM FLAVOR NAME HERE
- flavor_large:       PUT THE LARGE FLAVOR NAME HERE
- flavor_xlarge:      PUT THE XLARGE FLAVOR NAME HERE
-
-To get the images in your OpenStack environment, use the following
-OpenStack CLI command:
-
-::
-
-        openstack image list | grep 'ubuntu'
-
-To get the flavor names used in your OpenStack environment, use the
-following OpenStack CLI command:
-
-::
-
-        openstack flavor list
-
-**Proxy parameters**
-
-::
-  http_proxy: PUT YOUR HTTP PROXY ADDRESS (if you don't work behind a proxy put no_proxy)
-  https_proxy: PUT YOUR HTTPS PROXY ADDRESS (if you don't work behind a proxy put no_proxy)
-
-**Network parameters**
-
-::
-
- dns_list: PUT THE ADDRESS OF THE EXTERNAL DNS HERE (e.g. a comma-separated list
- of IP addresses in your /etc/resolv.conf in UNIX-based Operating Systems)
- external_dns: PUT THE FIRST ADDRESS OF THE EXTERNAL DNS LIST HERE
- dns_forwarder: PUT THE IP OF DNS FORWARDER FOR ONAP DEPLOYMENT'S OWN DNS SERVER
- oam_network_cidr: 10.0.0.0/16
-
-You can use the Google Public DNS 8.8.8.8 and 4.4.4.4 address or your internal
-DNS servers.
-
-ONAP installs a DNS server used to resolve IP addresses in the ONAP OAM private
-network.
-
-**DCAE Parameters**
-
-Depending on the set of DCAE compoennts to be deployed, you can select
-
-- R3 MVP - This profile includes a minimum set of DCAE components that will
-  support the vFW/vDNS, vCPE. and vVoLTE use cases. It will deploy the
-  following components: Consul server, Config Binding Service, Postgres
-  database, VES collector, TCA analytics, Holmes rule management, Holmes
-  engine management
-- R3 - This profile also deploys the rest of the DCAE platform. With R3
-  deployment profile, DCAE supports CLAMP and full control loop
-  functionalities. These additional components are: Cloudify Manager,
-  Deployment Handler, Policy Handler, Service Change Handler, Inventory API.
-- R3PLUS - This profile deploys the DCAE R2 stretch goal service components,
-  namely: PNF Registration Handler, SNMP Trap collector, HV-VES Collector,
-  Missing Heartbeat Detection analytics, Universal Mapper
-
-::
-
-  dcae_deployment_profile: PUT DCAE DEPLOYMENT PROFILE (R3MVP, R3, or R3PLUS)
-
-Instantiation
--------------
-
-The ONAP platform can be instantiated via Horizon (OpenStack dashboard)
-or Command Line.
-
-**Instantiation via Horizon:**
-
-- Login to Horizon URL with your personal credentials
-- Click "Stacks" from the "Orchestration" menu
-- Click "Launch Stack"
-- Paste or manually upload the Heat template file (onap_openstack.yaml) in the
-  "Template Source" form
-- Paste or manually upload the Heat environment file (onap_openstack.env) in
-  the "Environment Source" form
-- Click "Next" - Specify a name in the "Stack Name" form
-- Provide the password in the "Password" form
-- Click "Launch"
-
-**Instantiation via Command Line:**
-
-- You need to have the OpenStack Heat service installed:
-
-- Create a file (named i.e. ~/openstack/openrc) that sets all the
-  environmental variables required to access your OpenStack tenant:
-
-::
-
- export OS_AUTH_URL=INSERT THE AUTH URL HERE
- export OS_USERNAME=INSERT YOUR USERNAME HERE
- export OS_TENANT_ID=INSERT YOUR TENANT ID HERE
- export OS_REGION_NAME=INSERT THE REGION HERE
- export OS_PASSWORD=INSERT YOUR PASSWORD HERE
- export OS_USER_DOMAIN_NAME=INSERT YOUR DOMAIN HERE
- export OS_PROJECT_NAME=INSERT YOUR PROJECT NAME HERE
-
--  Run the script from command line:
-
-::
-
- source ~/openstack/openrc
-
--  In order to install the ONAP platform, type:
-
-::
-
- # Old Heat client
-
-::
-
- heat stack-create STACK_NAME -f PATH_TO_HEAT_TEMPLATE(YAML FILE)
- -e PATH_TO_ENV_FILE
-
- OR
-
-::
-
- # New OpenStack client
- openstack stack create -t PATH_TO_HEAT_TEMPLATE(YAML FILE)
- -e PATH_TO_ENV_FILE STACK_NAME
-
-
-.. Note 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
-(*onap-robot*) 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 \
-  -d ./html \
-  -V /share/config/integration_robot_properties.py \
-  -V /share/config/integration_preload_parameters.py \
-  -V /share/config/vm_properties.py
-
-This test suite will execute 40 tests towards the various ONAP components.
-
-After the installation, it is possible to deploy the various use-cases
-described in `ONAP wiki - demos <https://wiki.onap.org/display/DW/Running+the+ONAP+Demos>`_.
-
-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 on the `ONAP wiki - containers <https://wiki.onap.org/display/DW/ONAP+Services+List#ONAPServicesList-ONAPServices>`_.
-In case some containers are missing, check the Docker logs using the following
-command:
-
-.. code-block:: bash
-
- sudo docker ps -a
- sudo docker logs <containerid>
-
-**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 *hosts* file (located in /etc/hosts for Linux or
-/windows/system32/drivers/etc/hosts for Windows):
-
-.. code-block:: bash
-
- <onap-policy_ip>      policy.api.simpledemo.onap.org
- <onap-portal_ip>      portal.api.simpledemo.onap.org
- <onap-sdc_ip>         sdc.api.simpledemo.onap.org
- <onap-vid_ip>         vid.api.simpledemo.onap.org
- <onap-aai-inst1_ip>   aai.api.simpledemo.onap.org
- <onap-aai-inst2_ip>   aai.ui.simpledemo.onap.org
-
-
-You can use the Horizon dashboard to get the IP addresses 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
-
-Various users are predefined as presented in the following table:
-
-  .. csv-table::
-   :header: Role, Login
-   :widths: 20, 20
-
-    Superuser,demo
-    Designer,cs0008
-    Tester,jm0007
-    Governor,gv0001
-    Ops,op0001
-
-The password is *demo123456!*
-
-Go to the `Portal component user guide
-<http://onap.readthedocs.io/en/latest/submodules/portal.git/docs/index.html>`_
-
-Other UI documentation:
- - `CLAMP  <http://onap.readthedocs.io/en/latest/submodules/clamp.git/docs/index.html>`_
- - `SDC <http://onap.readthedocs.io/en/latest/submodules/sdc.git/docs/index.html>`_
- - `UI Use-Case <http://onap.readthedocs.io/en/latest/submodules/usecase-ui.git/docs/index.html>`_
-
-
-**Components**
-==============
-
-The list of various services and ports used can be found on the
-`ONAP wiki - services <https://wiki.onap.org/display/DW/ONAP+Services+List#ONAPServicesList-ONAPServices>`_
-
-.. This work is licensed under a Creative Commons Attribution 4.0
-.. International License.
-..  http://creativecommons.org/licenses/by/4.0
-.. Copyright 2017-2018 ONAP
-
-
-.. contents::
diff --git a/docs/guides/onap-developer/settingup/onap_individual.rst b/docs/guides/onap-developer/settingup/onap_individual.rst
deleted file mode 100644
index f218846af..000000000
--- a/docs/guides/onap-developer/settingup/onap_individual.rst
+++ /dev/null
@@ -1,31 +0,0 @@
-.. This work is licensed undera Creative Commons Attribution 4.0
-.. International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. Copyright 2017-2018 ONAP
-
-.. index:: Setting Up ONAP individual components
-
-
-=========================================
-**Setting Up ONAP individual components**
-=========================================
-
-.. _installing-onap-individual:
-
-**Context**
-===========
-From a developer perspective, ONAP can be installed component per component.
-For details, refer to :ref:`the installation procedure available for each
-component<index-setting-individual-components>`.
-The advanced installation procedure is recommended only for experienced
-developers who desire to focus their attention on a few components and who
-have a deep understanding of dependencies between components.
-This type of installation is not recommended to fully install ONAP.
-
-* The ONAP Source Code is available through Gerrit
-  at https://gerrit.onap.org/r/#/admin/projects or Git at https://git.onap.org/.
-
-* ONAP is packaged within Docker and can be downloaded from Docker Hub at https://hub.docker.com/r/onap.
-
-* ONAP Docker releases are specified by a list of project artifact versions
-  in a :ref:`manifest<doc-release-manifest>`.