| 1 | [[Include(WikiToC)]] |
| 2 | |
| 3 | == ONAP/ORAN Tutorial == |
| 4 | |
| 5 | |
| 6 | |
| 7 | === Description === |
| 8 | |
| 9 | === Prerequisites === |
| 10 | In order to access the test bed, create a reservationand have it approved by the reservation service. Access to the resources is granted after the reservation is confirmed. Please follow the process shown on the COSMOS [wiki:GettingStarted getting started] page to get started. |
| 11 | |
| 12 | === Resources required === |
| 13 | One of the servers in any of the [wiki:/Architecture/Domains COSMOS domains]. |
| 14 | |
| 15 | === Tutorial Setup === |
| 16 | For this tutorial, the assumption is that the you made a reservation for sb1.cosmos-lab.org domain. Follow the steps below to gain access to the [wiki:/Architecture/Domains/cosmos_sb1 sandbox 1 console] and set up nodes with appropriate images. |
| 17 | 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account] |
| 18 | 1. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1 |
| 19 | 1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with two SSH sessions. |
| 20 | 1. Make sure all the resources in the domain are turned off: |
| 21 | {{{#!shell |
| 22 | omf tell -a offh -t system:topo:allres |
| 23 | }}} |
| 24 | For this tutorial we will be using the SB1 servers, srv1-lg1 |
| 25 | 1. Load ORAN image '''oran-20220427.ndz''' on srv1-lg1: |
| 26 | {{{#!shell |
| 27 | omf load -i oran-20220427.ndz -t srv1-lg1 -r 60 |
| 28 | }}} |
| 29 | This image is fairly large and will take up to 7 minutes to load. |
| 30 | 1. Turn all the required resources on and check the status |
| 31 | {{{#!shell |
| 32 | omf tell -a on -t srv1-lg1 |
| 33 | }}} |
| 34 | {{{#!shell |
| 35 | omf stat -t system:topo:allres |
| 36 | }}} |
| 37 | 1. ssh to the nodes, use option -Y for using GUI. Alos, please make sure to tunnel ports 30091 and 30205 though the console (or use VPN so you can gain subnet access from your local machine). |
| 38 | |
| 39 | |
| 40 | === Tutorial Execution === |
| 41 | |
| 42 | Check that the services are running by executing the commad: |
| 43 | {{{ |
| 44 | root@srv1-lg1:~# kubectl get pods -n onap && kubectl get pods -n nonrtric |
| 45 | }}} |
| 46 | The output should look like: |
| 47 | {{{ |
| 48 | NAME READY STATUS RESTARTS AGE |
| 49 | onap-dmaap-dr-mariadb-init-config-job--1-hlqc8 0/1 Completed 0 75m |
| 50 | onap-policy-galera-config--1-tqwwf 0/1 Completed 0 70m |
| 51 | onap-policy-clamp-galera-config--1-tnccf 0/1 Completed 0 70m |
| 52 | onap-nengdb-init-config-job--1-xsbs6 0/1 Completed 0 68m |
| 53 | onap-sdnc-dbinit-job--1-62vpb 0/1 Completed 0 68m |
| 54 | onap-dmaap-bc-dmaap-provisioning--1-5dj7p 0/1 Completed 0 75m |
| 55 | onap-sdnc-sdnrdb-init-job--1-rmsmb 0/1 Completed 0 68m |
| 56 | onap-sdnrdb-master-0 1/1 Running 1 (28m ago) 68m |
| 57 | onap-aaf-sms-quorumclient-2 1/1 Running 1 (28m ago) 76m |
| 58 | onap-consul-7f67bc4d4f-qgghd 1/1 Running 1 (28m ago) 77m |
| 59 | onap-consul-server-0 1/1 Running 1 (28m ago) 77m |
| 60 | onap-dbc-pg-primary-74fd9c6b4-fs5kx 1/1 Running 1 (28m ago) 75m |
| 61 | onap-sdnc-dmaap-listener-765d56c76d-qzkqx 0/1 Init:1/2 0 68m |
| 62 | onap-aaf-sms-vault-0 2/2 Running 2 (28m ago) 77m |
| 63 | onap-mariadb-galera-0 2/2 Running 2 (28m ago) 75m |
| 64 | onap-dbc-pg-replica-6c94cf676-4pxxb 1/1 Running 1 (28m ago) 75m |
| 65 | onap-aaf-sms-quorumclient-0 1/1 Running 1 (28m ago) 77m |
| 66 | onap-aaf-sms-quorumclient-1 1/1 Running 1 (28m ago) 76m |
| 67 | onap-aaf-cass-7b5ffc99ff-9m6t2 1/1 Running 1 (28m ago) 77m |
| 68 | onap-policy-mariadb-0 2/2 Running 3 (26m ago) 70m |
| 69 | onap-message-router-zookeeper-0 1/1 Running 1 (28m ago) 75m |
| 70 | onap-sdnc-ansible-server-9dcfc6846-kxnp9 1/1 Running 1 (28m ago) 68m |
| 71 | onap-dcae-healthcheck-8647b8857b-ppdn6 1/1 Running 2 (26m ago) 76m |
| 72 | onap-aaf-service-576849df76-mrdds 1/1 Running 3 (26m ago) 77m |
| 73 | onap-aaf-locate-6786b49d8d-4ngzg 1/1 Running 1 (28m ago) 77m |
| 74 | onap-aaf-fs-844878ff4-vjb9j 1/1 Running 1 (28m ago) 77m |
| 75 | onap-aaf-oauth-d47557fcb-n7lzq 1/1 Running 1 (28m ago) 77m |
| 76 | onap-aaf-cm-84f5df554b-qcc99 1/1 Running 1 (28m ago) 77m |
| 77 | onap-aaf-gui-5948c9d4bd-44mpf 1/1 Running 1 (28m ago) 77m |
| 78 | onap-policy-clamp-cl-pf-ppnt-84fbbcc979-wnmhd 1/1 Running 1 (28m ago) 70m |
| 79 | onap-dmaap-bc-78b9bd844-wzr64 0/1 Init:5/6 1 75m |
| 80 | onap-policy-clamp-cl-http-ppnt-8587f99d74-9kqt6 1/1 Running 1 (28m ago) 70m |
| 81 | onap-sdnrdb-coordinating-only-5f87cb6d74-tgc5p 2/2 Running 2 (28m ago) 68m |
| 82 | onap-policy-clamp-fe-56c59bc9fc-2mr99 1/1 Running 1 (28m ago) 70m |
| 83 | onap-policy-api-64655b4bbd-rlptb 1/1 Running 1 (28m ago) 70m |
| 84 | onap-policy-gui-59b76dd7db-pqw5b 1/1 Running 1 (28m ago) 70m |
| 85 | onap-policy-clamp-cl-k8s-ppnt-6ddb58cfbd-8rcj5 1/1 Running 1 (28m ago) 70m |
| 86 | onap-policy-clamp-be-b8fcc698d-c7fdn 1/1 Running 1 (28m ago) 70m |
| 87 | onap-policy-clamp-cl-runtime-867fd4765-9zn2s 1/1 Running 1 (28m ago) 70m |
| 88 | onap-policy-apex-pdp-0 1/1 Running 1 (28m ago) 70m |
| 89 | onap-aaf-sms-7885fd9f5c-v8xpq 1/1 Running 1 (28m ago) 77m |
| 90 | onap-policy-pap-7dd48d6d69-swbcd 1/1 Running 1 (28m ago) 70m |
| 91 | onap-sdnc-dgbuilder-8d946cb6b-jct5g 1/1 Running 1 (28m ago) 68m |
| 92 | onap-dmaap-dr-prov-6ddbc5595-x9zs7 2/2 Running 2 (28m ago) 75m |
| 93 | onap-a1policymanagement-0 2/2 Running 2 (28m ago) 77m |
| 94 | onap-dmaap-dr-node-0 2/2 Running 2 (28m ago) 75m |
| 95 | onap-sdnc-web-55b974859d-7f72m 1/1 Running 1 (28m ago) 68m |
| 96 | onap-dcae-config-binding-service-f95cf8997-7pqj7 4/4 Running 4 (28m ago) 76m |
| 97 | onap-dcae-ves-collector-7bb58645f6-wjmr7 2/2 Running 2 (28m ago) 76m |
| 98 | onap-dcae-cloudify-manager-85cfdc498b-p9fq9 1/1 Running 1 (28m ago) 76m |
| 99 | onap-sdnc-0 2/2 Running 2 (28m ago) 68m |
| 100 | onap-network-name-gen-699cdbd4b5-f9shp 1/1 Running 13 (21m ago) 68m |
| 101 | onap-aaf-sms-preload--1-xw2z8 0/1 Init:CreateContainerConfigError 2 77m |
| 102 | onap-message-router-kafka-0 0/1 CrashLoopBackOff 8 (3m55s ago) 75m |
| 103 | onap-message-router-0 0/1 CrashLoopBackOff 8 (3m28s ago) 75m |
| 104 | NAME READY STATUS RESTARTS AGE |
| 105 | a1-sim-std-0-7d7d6d5b69-q4tf8 1/1 Running 1 (28m ago) 67m |
| 106 | a1-sim-std-1-6d7b644cbb-vhndk 1/1 Running 1 (28m ago) 67m |
| 107 | a1-sim-std2-0-64cc667968-m6rp6 1/1 Running 1 (28m ago) 67m |
| 108 | a1-sim-osc-1-5bb7478885-25rmb 1/1 Running 1 (28m ago) 67m |
| 109 | topology-6c5cd99d6d-qnrzr 1/1 Running 1 (28m ago) 67m |
| 110 | helmmanager-0 1/1 Running 1 (28m ago) 67m |
| 111 | a1-sim-std2-1-b668b97df-662zs 1/1 Running 1 (28m ago) 67m |
| 112 | rappcatalogueservice-765d8c69fd-zp57s 1/1 Running 1 (28m ago) 67m |
| 113 | dmaapadapterservice-0 1/1 Running 1 (28m ago) 67m |
| 114 | a1-sim-osc-0-547cc8fc84-fmddw 1/1 Running 1 (28m ago) 67m |
| 115 | informationservice-0 1/1 Running 1 (28m ago) 67m |
| 116 | nonrtricgateway-689d9cf595-gltwm 1/1 Running 2 (27m ago) 67m |
| 117 | dmaapmediatorservice-0 1/1 Running 3 (26m ago) 67m |
| 118 | oran-nonrtric-kong-594db9cb8b-pqbhg 2/2 Running 8 (26m ago) 67m |
| 119 | controlpanel-6fb4f88778-rl5gx 1/1 Running 4 (26m ago) 67m |
| 120 | oru-app-cd86cbb85-9wbck 1/1 Running 1 (28m ago) 67m |
| 121 | }}} |
| 122 | |
| 123 | {{{ |
| 124 | #!NewsFlash |
| 125 | |
| 126 | In case you want to build your own ORAN image, start with the ubuntu2004.ndz and remove snapd restriction from it with: |
| 127 | {{{ |
| 128 | sudo rm /etc/apt/preferences.d/snapd |
| 129 | }}} |
| 130 | |
| 131 | Install snapd: |
| 132 | {{{ |
| 133 | sudo apt update |
| 134 | sudo apt install snapd |
| 135 | }}} |
| 136 | |
| 137 | Add to /etc/profile |
| 138 | {{{ |
| 139 | export LC_ALL=C.UTF-8 |
| 140 | export LANG=C.UTF-8 |
| 141 | }}} |
| 142 | |
| 143 | exit the ssh session and come back. Install a local Kubernetes with [https://ubuntu.com/tutorials/install-a-local-kubernetes-with-microk8s MicroK8s]: |
| 144 | {{{ |
| 145 | sudo snap install microk8s --classic |
| 146 | }}} |
| 147 | |
| 148 | Grab the [https://github.com/sebdet/oran-deployment O-RAN installation scripts]: |
| 149 | |
| 150 | {{{ |
| 151 | git clone --recursive https://github.com/sebdet/oran-deployment.git |
| 152 | }}} |
| 153 | |
| 154 | And then install them |
| 155 | {{{ |
| 156 | ./oran-deployment/scripts/layer-0/0-setup-microk8s.sh |
| 157 | ./oran-deployment/scripts/layer-0/0-setup-charts-museum.sh |
| 158 | ./oran-deployment/scripts/layer-0/0-setup-helm3.sh |
| 159 | ./oran-deployment/scripts/layer-1/1-build-all-charts.sh |
| 160 | ./oran-deployment/scripts/layer-2/2-install-oran.sh |
| 161 | }}} |
| 162 | |
| 163 | Check the status of the |
| 164 | |
| 165 | [[NewsFlashEnd]] |