3 This documents describes the deployment of an O-RU Controller which could be used
4 as component for O-DU and/or SMO implementations.
10 The solution was tested on a VM with
16 ### Operating (HOST) System
19 $ cat /etc/os-release | grep PRETTY_NAME
20 PRETTY_NAME="Ubuntu 22.04.2 LTS"
27 Docker version 23.0.1, build a5ee5b1
29 Please follow the required docker daemon configuration as documented in the following README.md:
30 - [./smo/common/docker/README.md](./smo/common/docker/README.md)
35 $ docker compose version
36 Docker Compose version v2.17.2
53 sudo apt install python3-pip
54 pip install jproperties
58 It is beneficial (but not mandatory) adding the following line add the
59 end of your ~/.bashrc file. I will suppress warnings when python script
60 do not verify self signed certificates for HTTPS communication.
63 export PYTHONWARNINGS="ignore:Unverified HTTPS request"
66 ### ETC Host (DNS function)
68 Please modify the /etc/hosts of your system.
70 * \<your-system>: is the hostname of the system, where the browser is started
72 * \<deployment-system-ipv4>: is the IP address of the system where the solution will be deployed
74 For development purposes <your-system> and <deployment-system> may reference the same system.
79 127.0.1.1 <your-system>
81 # SMO OAM development system
82 <deployment-system-ipv4> smo.o-ran-sc.org
83 <deployment-system-ipv4> gateway.smo.o-ran-sc.org
84 <deployment-system-ipv4> identity.smo.o-ran-sc.org
85 <deployment-system-ipv4> messages.smo.o-ran-sc.org
86 <deployment-system-ipv4> odlux.oam.smo.o-ran-sc.org
87 <deployment-system-ipv4> flows.oam.smo.o-ran-sc.org
88 <deployment-system-ipv4> tests.oam.smo.o-ran-sc.org
89 <deployment-system-ipv4> ves-collector.dcn.smo.o-ran-sc.org
90 <deployment-system-ipv4> controller.dcn.smo.o-ran-sc.org
96 The following commands should be invoked. More detailed can be found in the
100 docker compose -f smo/common/docker-compose.yml up -d
101 python smo/common/identity/config.py
102 docker compose -f smo/oam/docker-compose.yml up -d odlux controller
103 docker compose -f network/docker-compose.yml up -d ntsim-ng-o-ru-11221
104 python network/config.py
107 ## Verification Solution
109 ### Login into O-RU-Controller UI
111 https://odlux.oam.smo.o-ran-sc.org
115 Password: // see .env file
117 In case of trouble, please update the commands with your customized '.env' file.
119 ### Connection State of the simulated O-RU
121 In the O-RU Controller UI you should see the simulated O-RU connected as a kind of reference implementation.
123 ![Connection State](./docs/connect.odlux.o-ru-controller.o-ran-sc.org.png)
125 ### Alarm Notification of the simulated O-RU
127 In the O-RU Controller UI you should see the generated alarm notifications of the O-RU as a kind of reference implementation.
129 ![Alarm Notifications](./docs/fault.odlux.o-ru-controller.o-ran-sc.org.png)
131 ## Terminate solution
133 To stop all container please respect the following order
136 docker compose -f network/docker-compose.yml down
137 docker compose -f smo/oam/docker-compose.yml down
138 docker compose -f smo/common/docker-compose.yml down