From 1888a892c8b33b13b207813d3baa095e65c8070e Mon Sep 17 00:00:00 2001 From: Abdelmuhaimen Seaudi Date: Mon, 20 Nov 2017 19:00:17 +0000 Subject: modified: docs/installation.rst issue-id: DOC-202 Change-Id: I60ca3449318d9b35c00902ff1d91eb4eb5e1f859 Signed-off-by: Abdelmuhaimen Seaudi (cherry picked from commit 50ebffd341ff7b0fc4f212ac2e2626fee76b66fe [formerly c8d23dfba07c7072511f25efd061fb4eb350e072]) Former-commit-id: d8dc45d064801140b4e8f25b420c38cb97261925 --- docs/installation.rst | 217 +++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 207 insertions(+), 10 deletions(-) (limited to 'docs/installation.rst') diff --git a/docs/installation.rst b/docs/installation.rst index d7c4e073..dfff7be4 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 ------ -- cgit 1.2.3-korg