1 # Service Management and Orchestration (SMO)
3 This project focus on a docker-compose deployment solution for SMO/OAM Components.
7 With respect to OAM the SMO implements the O1-interface consumers.
8 According to the O-RAN OAM Architecture and the O-RAN OAM Interface Specification,
9 the SMO implements a NETCONF Client for configuration and a HTTP/REST/VES server
10 for receiving all kind of events in VES format.
12 The setup contains an OpenDaylight based NETCONF client and an ONAP VES Collector.
16 This docker-compose file starts a pre-configured, self-contained SDN-R solution
17 with the following components.
20 ... representing an KeyCloak based identity service for centralized user
21 management. Please note that the implementation does not support IPv6.
22 Therefore, its own network is required called 'DMZ'.
23 In this configuration the external https port is 8463.
25 * **SDN-R** single node instance
27 ... representing the NETCONF consumer on the Service Management and
28 Orchestration framework (SMO) for the O1 interface based on
30 SDN-R comes with is own web-portal the external port is 8463.
34 ... representing the VES (REST) provider at SMO for all kind of events. In this configuration the external https port is 8443.
37 ... representing SMO DMaaP component, includes message-router
42 $ cat /etc/os-release | grep PRETTY_NAME
43 PRETTY_NAME="Ubuntu 20.04.2 LTS"
46 Docker version 20.10.7, build 20.10.7-0ubuntu1~20.04.2
48 $ docker-compose version
49 docker-compose version 1.29.1, build c34c88b2
50 docker-py version: 5.0.0
51 CPython version: 3.7.10
52 OpenSSL version: OpenSSL 1.1.0l 10 Sep 2019
59 Please modify the /etc/hosts of your system.
61 * \<your-system>: is the hostname of the system, where the browser is started
63 * \<deployment-system-ipv4>: is the IP address of the system where the solution will be deployed
65 For development purposes <your-system> and <deployment-system> may reference the same system.
70 127.0.1.1 <your-system>
71 <deployment-system-ipv4> sdnc-web <your-system>
72 <deployment-system-ipv4> identity <your-system>
75 It is beneficial (but not mandatory) adding the following line add the
76 end of your ~/.bashrc file. I will suppress warnings when python script
77 do not verify self signed certificates for HTTPS communication.
80 export PYTHONWARNINGS="ignore:Unverified HTTPS request"
83 Please ensure that you download and copy the required 3GPP OpenAPIs for VES-stndDefined
84 message validation into the folder './solution/operation-and-maintenance/smo/oam/ves-collector/externalRepo'.
86 Please follow the instructions in ./solution/operation-and-maintenance/smo/oam/ves-collector/externalRepo/3gpp/rep/sa5/MnS/blob/Rel16/OpenAPI/README.md.
88 The following tree shows the successfully tested folder structure. It combines different versions of the schemas ('Rel16' and 'SA88-Rel16') using 3GPP branch names.
91 $ tree solution/operation-and-maintenance/smo/oam/ves-collector/externalRepo/
92 solution/operation-and-maintenance/smo/oam/ves-collector/externalRepo/
101 │ │ ├── TS28532_FaultMnS.yaml
102 │ │ ├── TS28532_FileDataReportingMnS.yaml
103 │ │ ├── TS28532_HeartbeatNtf.yaml
104 │ │ ├── TS28532_PerfMnS.yaml
105 │ │ ├── TS28532_ProvMnS.yaml
106 │ │ ├── TS28532_StreamingDataMnS.yaml
107 │ │ ├── TS28536_CoslaNrm.yaml
108 │ │ ├── TS28541_5GcNrm.yaml
109 │ │ ├── TS28541_NrNrm.yaml
110 │ │ ├── TS28541_SliceNrm.yaml
111 │ │ ├── TS28550_PerfMeasJobCtrlMnS.yaml
112 │ │ ├── TS28623_ComDefs.yaml
113 │ │ ├── TS28623_GenericNrm.yaml
114 │ │ ├── TS29512_Npcf_SMPolicyControl.yaml
115 │ │ ├── TS29514_Npcf_PolicyAuthorization.yaml
116 │ │ └── TS29571_CommonData.yaml
120 │ ├── PerDataFileReportMnS.yaml
121 │ ├── PerMeasJobCtlMnS.yaml
122 │ ├── PerThresMonMnS.yaml
123 │ ├── PerfDataStreamingMnS.yaml
128 │ ├── genericNrm.yaml
129 │ ├── heartbeatNtf.yaml
133 │ └── streamingDataMnS.yaml
136 ## Expected Folder Structure
138 The following figure show the expected folder structure for the different
139 docker-compose file and its configurations.
145 │ ├── docker-compose.yml
152 │ ├── docker-compose.yml
161 ├── docker-compose.yml
170 ### Bring Up Solution
174 The following commands should be invoked. More detailed can be found in the
178 docker-compose -f smo/common/docker-compose.yml up -d
179 # wait until the cpu load is low again
180 python smo/common/identity/config.py
182 docker-compose -f smo/oam/docker-compose.yml up -d
183 # wait until the cpu load is low again
185 docker-compose -f network/docker-compose.yml up -d
187 docker restart ntsim-ng-o-du-1122
188 python network/config.py
191 #### Check (adjust if required) environment variables
198 The tested configuration uses the following external https ports:
200 * 8443 for the ves-collector
201 * 8453 for web access to ODLUX (SDNC_WEB_PORT)
202 * 8463 for the keyclock web administrator user interface.
204 #### Startup solution
206 Please note that it is necessary to configure first the identity service,
207 before starting further docker images.
209 The several docker-compose yml files must be started in the right order as listed below:
212 docker-compose -f smo/common/docker-compose.yml up -d
213 python smo/identity/config.py
216 The python script configure the users within the identity service (keycloak).
217 A system user (%USER) is also created with administration rights.
221 docker-compose -f smo/oam/docker-compose.yml up -d
224 Looking into the ONAP SDN-R logs will give you the startup procedure.
230 The startup was successful when you see the following line:
233 Everything OK in Certificate Installation
236 If you see the login page (https://sdnc-web:8453) you are good to go and can start the (simulated) network.
239 docker-compose -f network/docker-compose.yml up -d
242 Usually the first ves:event gets lost. Please restart the O-DU docker container(s) to send a second ves:pnfRegistration.
245 docker-compose -f network/docker-compose.yml restart ntsim-ng-o-du-1122
246 python network/config.py
249 The python script configures the simulated O-DU and O-RU according to O-RAN hybrid architecture.
251 O-DU - NETCONF Call HOME and NETCONF notifications
252 O-RU - ves:pnfRegistration and ves:fault, ves:heartbeat
254 ![ves:pnfRegistration in ODLUX](docs/nstim-ng-connected-after-ves-pnf-registration-in-odlux.png "ves:pnfRegistration in ODLUX")
256 'True' indicated that the settings through SDN-R to the NETCONF server were
259 SDN-R reads the fault events from DMaaP and processes them.
260 Finally the fault events are visible in ODLUX.
262 ![ves:fault in ODLUX](docs/ves-fault-in-odlux.png "ves:fault in ODLUX")
265 ### Log files and karaf console
270 docker exec -it sdnr tail -f /opt/opendaylight/data/log/karaf.log
273 #### ves-collector logs
276 docker logs -f ves-collector
279 ### Customizing Solution
281 '.env' file contains customizing parameters
283 ### Verification Solution
285 #### Access to SDN-R ODLUX
287 ##### Login into SDN-R
289 https://sdnc-web:8453
291 User: admin // see .env file
293 Password: Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U
295 In case of trouble, please update the commands with your customized '.env' file.
297 ### Terminate solution
299 To stop all container please respect the following order
302 docker-compose -f network/docker-compose.yml down
303 docker-compose -f smo/oam/docker-compose.yml down
304 docker-compose -f smo/common/docker-compose.yml down
309 !!! be careful if other stopped containers are on the same system
311 docker system prune -a -f
315 In most cases the .env setting do not fit to the environment and need to be
318 Please make sure that the network settings to not overlap with other networks.