modified: docs/installation.rst
issue-id: DOC-202
Change-Id: I60ca3449318d9b35c00902ff1d91eb4eb5e1f859
Signed-off-by: Abdelmuhaimen Seaudi <abdelmuhaimen.seaudi@orange.com>
Former-commit-id: c8d23dfba07c7072511f25efd061fb4eb350e072
diff --git a/docs/installation.rst b/docs/installation.rst
index d7c4e07..dfff7be 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -1,20 +1,217 @@
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
-Installation
+Introduction
============
+The purpose of this document is to explain how to build an ONAP SDNC Instance on vanilla Openstack deployment.
+The document begins with creation of a network, and a VM.
+Then, the document explains how to run the installation scripts on the VM.
+Finally, the document shows how to check that the SDNC installation was completed successfully.
+This document and logs were created on 14 November, 2017.
-.. note::
- * This section is used to describe how a software component is acquired and installed.
+Infrastructure setup on OpenStack
+---------------------------------
+Create the network, we call it “ONAP-net”:
- * This section is typically: provided for a platform-component and application; and
- referenced in user guides.
+::
- * This note must be removed after content has been added.
+ cloud@olc-ubuntu2:~$ neutron net-create onap-net
+ neutron CLI is deprecated and will be removed in the future. Use openstack CLI instead.
+ Created a new network:
+ +-----------------+--------------------------------------+
+ | Field | Value |
+ +-----------------+--------------------------------------+
+ | admin_state_up | True |
+ | id | 662650f0-d178-4745-b4fe-dd2cb735160c |
+ | name | onap-net |
+ | router:external | False |
+ | shared | False |
+ | status | ACTIVE |
+ | subnets | |
+ | tenant_id | 324b90de6e9a4ad88e93a100c2cedd5d |
+ +-----------------+--------------------------------------+
+ cloud@olc-ubuntu2:~$
-Environment
------------
+Create the subnet, “ONAP-subnet”:
+
+::
+
+ cloud@olc-ubuntu2:~$ neutron subnet-create --name onap-subnet onap-net 10.0.0.0/16
+ neutron CLI is deprecated and will be removed in the future. Use openstack CLI instead.
+ Created a new subnet:
+ +-------------------+----------------------------------------------+
+ | Field | Value |
+ +-------------------+----------------------------------------------+
+ | allocation_pools | {"start": "10.0.0.2", "end": "10.0.255.254"} |
+ | cidr | 10.0.0.0/16 |
+ | dns_nameservers | |
+ | enable_dhcp | True |
+ | gateway_ip | 10.0.0.1 |
+ | host_routes | |
+ | id | 574df42f-15e9-4761-a4c5-e48d64f04b99 |
+ | ip_version | 4 |
+ | ipv6_address_mode | |
+ | ipv6_ra_mode | |
+ | name | onap-subnet |
+ | network_id | 662650f0-d178-4745-b4fe-dd2cb735160c |
+ | tenant_id | 324b90de6e9a4ad88e93a100c2cedd5d |
+ +-------------------+----------------------------------------------+
+ cloud@olc-ubuntu2:~$
+
+Boot an Ubuntu 14.04 instance, using the correct flavor name according to your Openstack :
+
+::
+
+ cloud@olc-ubuntu2:~$ nova boot --flavor n2.cw.standard-4 --image "Ubuntu 14.04" --key-name olc-
+ key2 --nic net-name=onap-net,v4-fixed-ip=10.0.7.1 vm1-sdnc
+ +--------------------------------------+-----------------------------------------------------+
+ | Property | Value |
+ +--------------------------------------+-----------------------------------------------------+
+ | OS-DCF:diskConfig | MANUAL |
+ | OS-EXT-AZ:availability_zone | |
+ | OS-EXT-STS:power_state | 0 |
+ | OS-EXT-STS:task_state | scheduling |
+ | OS-EXT-STS:vm_state | building |
+ | OS-SRV-USG:launched_at | - |
+ | OS-SRV-USG:terminated_at | - |
+ | accessIPv4 | |
+ | accessIPv6 | |
+ | config_drive | |
+ | created | 2017-11-14T15:48:37Z |
+ | flavor | n2.cw.standard-4 (44) |
+ | hostId | |
+ | id | 596e2b1f-ff09-4c8e-b3e8-fc06566306cf |
+ | image | Ubuntu 14.04 (ac9d6735-7c2b-4ff1-90e9-b45225fd80a9) |
+ | key_name | olc-key2 |
+ | metadata | {} |
+ | name | vm1-sdnc |
+ | os-extended-volumes:volumes_attached | [] |
+ | progress | 0 |
+ | security_groups | default |
+ | status | BUILD |
+ | tenant_id | 324b90de6e9a4ad88e93a100c2cedd5d |
+ | updated | 2017-11-14T15:48:38Z |
+ | user_id | 24c673ecc97f4b42887a195654d6a0b9 |
+ +--------------------------------------+-----------------------------------------------------+
+ cloud@olc-ubuntu2:~$
+
+Create a floating IP and associate to the SDNC VM so that it can access internet to download needed files:
+
+::
+
+ cloud@olc-ubuntu2:~$ neutron floatingip-create public
+ neutron CLI is deprecated and will be removed in the future. Use openstack CLI instead.
+ Created a new floatingip:
+ +---------------------+--------------------------------------+
+ | Field | Value |
+ +---------------------+--------------------------------------+
+ | fixed_ip_address | |
+ | floating_ip_address | 84.39.47.153 |
+ | floating_network_id | b5dd7532-1533-4b9c-8bf9-e66631a9be1d |
+ | id | eac0124f-9c92-47e5-a694-53355c06c6b2 |
+ | port_id | |
+ | router_id | |
+ | status | ACTIVE |
+ | tenant_id | 324b90de6e9a4ad88e93a100c2cedd5d |
+ +---------------------+--------------------------------------+
+ cloud@olc-ubuntu2:~$
+ cloud@olc-ubuntu2:~$ neutron port-list
+ neutron CLI is deprecated and will be removed in the future. Use openstack CLI instead.
+ +--------------------------------------+--------------------------------------+-------------------+-------------------------------------------------------------------------------------+
+ | id | name | mac_address | fixed_ips |
+ +--------------------------------------+--------------------------------------+-------------------+-------------------------------------------------------------------------------------+
+ | 5d8e8f30-a13a-417d-b5b4-f4038224364b | 5d8e8f30-a13a-417d-b5b4-f4038224364b | 02:5d:8e:8f:30:a1 | {"subnet_id": "574df42f-15e9-4761-a4c5-e48d64f04b99", "ip_address": "10.0.7.1"} |
+ +--------------------------------------+--------------------------------------+-------------------+-------------------------------------------------------------------------------------+
+ cloud@olc-ubuntu2:~$
+ cloud@olc-ubuntu2:~$ neutron floatingip-associate eac0124f-9c92-47e5-a694-53355c06c6b25d8e8f30-a13a-417d-b5b4-f4038224364b
+ neutron CLI is deprecated and will be removed in the future. Use openstack CLI instead.
+ Associated floating IP eac0124f-9c92-47e5-a694-53355c06c6b2
+ cloud@olc-ubuntu2:~$
+
+Add the security group to the VM in order to open needed ports for SDNC like port 22, 3000, 8282 etc ...:
+
+::
+
+ cloud@olc-ubuntu2:~$ nova add-secgroup vm1-sdnc olc-onap
+ cloud@olc-ubuntu2:~$
+
+Installing SDNC
+---------------
+
+Connect to the new VM and change to user "root", and run the following commands to start the installation (the full logs are listed in the attached text file):
+
+::
+
+ cloud@vm1-sdnc:~$ sudo -i
+ root@vm1-sdnc:~# mkdir -p /opt/config
+ root@vm1-sdnc:~#
+ root@vm1-sdnc:~# echo "https://nexus.onap.org/content/sites/raw" > /opt/config/nexus_repo.txt
+ root@vm1-sdnc:~# echo "nexus3.onap.org:10001" > /opt/config/nexus_docker_repo.txt
+ root@vm1-sdnc:~# echo "docker" > /opt/config/nexus_username.txt
+ root@vm1-sdnc:~# echo "docker" > /opt/config/nexus_password.txt
+ root@vm1-sdnc:~# echo "1.1.0-SNAPSHOT" > /opt/config/artifacts_version.txt
+ root@vm1-sdnc:~# echo "10.0.100.1" > /opt/config/dns_ip_addr.txt
+ root@vm1-sdnc:~# wget https://git.onap.org/integration/plain/version-manifest/src/main/resources/docker-manifest.csv
+ root@vm1-sdnc:~# DOCKER_SDNC_VERSION=$(grep onap/sdnc-image docker-manifest.csv | awk '{v=$1; gsub(".*/*,","",$1); print ($1) }')
+ root@vm1-sdnc:~# echo $DOCKER_SDNC_VERSION > /opt/config/docker_version.txt
+ root@vm1-sdnc:~# echo "master" > /opt/config/gerrit_branch.txt
+ root@vm1-sdnc:~# echo "openstack" > /opt/config/cloud_env.txt
+ root@vm1-sdnc:~# echo "8.8.8.8" > /opt/config/external_dns.txt
+ root@vm1-sdnc:~# echo "http://gerrit.onap.org/r/sdnc/oam.git" > /opt/config/remote_repo.txt
+ root@vm1-sdnc:~# DOCKER_BUILDER_VERSION=$(grep dgbuilder docker-manifest.csv | awk '{v=$1; gsub(".*/*,","",$1); print ($1) }')
+ root@vm1-sdnc:~# echo $DOCKER_BUILDER_VERSION > /opt/config/dgbuilder_version.txt
+ root@vm1-sdnc:~# curl -k https://nexus.onap.org/content/sites/raw/org.onap.demo/boot/1.1.0-
+ SNAPSHOT/sdnc_install.sh -o /opt/sdnc_install.sh
+ % Total % Received % Xferd Average Speed Time Time Time Current
+ Dload Upload Total Spent Left Speed
+ 100 3701 100 3701 0 0 5196 0 --:--:-- --:--:-- --:--:-- 5190
+ root@vm1-sdnc:~# cd /opt
+ root@vm1-sdnc:/opt# chmod +x sdnc_install.sh
+ root@vm1-sdnc:/opt# ./sdnc_install.sh
+ cp: cannot stat ‘/home/ubuntu/.ssh/authorized_keys’: No such file or directory
+ Get:1 http://security.ubuntu.com trusty-security InRelease [65.9 kB]
+ … output truncated …
+
+The following install logs shows the containers are coming up, meaning a successful deployment of the SDNC:
+
+::
+
+ ... truncated output ...
+ Status: Downloaded newer image for mysql/mysql-server:5.6
+ Creating sdnc_db_container
+ Creating sdnc_controller_container
+ Creating sdnc_portal_container
+ Creating sdnc_dgbuilder_container
+ Creating sdnc_dmaaplistener_container
+ Creating sdnc_ueblistener_container
+ root@vm1-sdnc:/opt#
+
+Check that the containers are up and running:
+
+::
+
+ cloud@vm1-sdnc:~$ sudo docker container list
+ CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
+ 30fd20166145 onap/sdnc-dmaap-listener-image:latest "/opt/onap/sdnc/dm..." 25 minutes ago Up 25 minutes sdnc_dmaaplistener_container
+ 484220f3b38a onap/sdnc-ueb-listener-image:latest "/opt/onap/sdnc/ue..." 25 minutes ago Up 25 minutes sdnc_ueblistener_container
+ 674ad3ff7f24 onap/ccsdk-dgbuilder-image:latest "/bin/bash -c 'cd ..." 25 minutes ago Up 25 minutes 0.0.0.0:3000->3100/tcp sdnc_dgbuilder_container
+ d2a915c8e2e5 onap/admportal-sdnc-image:latest "/bin/bash -c 'cd ..." 25 minutes ago Up 25 minutes 0.0.0.0:8843->8843/tcp sdnc_portal_container
+ a65b7fb486e7 onap/sdnc-image:latest "/opt/onap/sdnc/bi..." 25 minutes ago Up 25 minutes 0.0.0.0:8201->8101/tcp, 0.0.0.0:8282->8181/tcp sdnc_controller_container
+ 2b9b2f5a79f8 mysql/mysql-server:5.6 "/entrypoint.sh my..." 25 minutes ago Up 25 minutes (healthy) 0.0.0.0:32768->3306/tcp sdnc_db_container
+ cloud@vm1-sdnc:~$
+
+Login into APIDOC Explorer and check that you can see Swagger UI interface with all the APIs:
+
+::
+
+ APIDOC Explorer URL: http://{SDNC-IP}:8282/apidoc/explorer/index.html
+ Username: admin
+ Password: Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U
+
+Login into DG Builder and check that you can see the GUI:
+
+::
+
+ DG Builder URL: http://dguser:test123@{SDNC-IP}:3000
-Steps
------