1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
8 O-DU High Installation Guide
9 *****************************
14 This document describes how to install O-DU High, it's dependencies and required system resources.
23 +--------------------+--------------------+--------------------+--------------------+
24 | **Date** | **Ver.** | **Author** | **Comment** |
26 +--------------------+--------------------+--------------------+--------------------+
27 | 2020-12-04 | 1.0.1 | HCL Technologies | Cherry Release |
29 +--------------------+--------------------+--------------------+--------------------+
30 | 2020-12-04 | 1.0 | Radisys | Cherry Release |
32 +--------------------+--------------------+--------------------+--------------------+
38 This document describes the hardware and software requirements along with guidelines on how to install O-DU High.
40 The audience of this document is assumed to have good knowledge in RAN concepts and Linux system.
46 O-DU High images can be built using the source code or corresponding docker images can be downloaded.
52 Following minimum hardware requirements must be met for installation of O-DU High
54 +--------------------+----------------------------------------------------+
55 | **HW Aspect** | **Requirement** |
57 +--------------------+----------------------------------------------------+
58 | **# of servers** | 1 |
59 +--------------------+----------------------------------------------------+
62 +--------------------+----------------------------------------------------+
65 +--------------------+----------------------------------------------------+
68 +--------------------+----------------------------------------------------+
71 +--------------------+----------------------------------------------------+
74 Software installation and deployment
75 ==========================================
77 This section describes the installation of the O-DU High on the reference hardware.
82 Following libraries are required to compile and execute O-DU High:
85 - Ubuntu : sudo apt-get install -y build-essential
86 - CentOS : sudo yum groups mark install -y “Development Tools”
88 Ensure the version is 4.6.3 and above using
93 - Ubuntu : sudo apt-get install -y libsctp-dev
94 - CentOS : sudo yum install -y lksctp-tools-devel
97 - Ubuntu : sudo apt-get install -y libpcap-dev
98 - CentOS : sudo yum install -y libpcap-devel
105 - Create a folder to clone the O-DU High code into. The folder is hereafter referred to as <O-DU High Directory>.
107 - Clone code into <O-DU High Directory>
109 git clone "https://gerrit.o-ran-sc.org/r/o-du/l2"
112 Setting up Netconf server
113 -------------------------
115 Following steps are required to compile and run ODU with O1 interface enabled.
116 This requires SMO components (OAM and VES collector) to be running.
118 - Create a new netconf user
120 Switch to root user or use sudo and run following commands
123 | cd <O-DU High Directory>/l2/build/scripts
124 | sudo ./add_netconf_user.sh
126 - Install Netconf libraries:
128 libssh, libyang, libnetconf2, sysrepo, netopeer2
130 Script is provided in the following folder to install these libraries
133 | cd <O-DU High Directory>/l2/build/scripts
134 | sudo ./install_lib_O1.sh -c
136 - Install the YANG modules and load initial configuration
138 - Navigate to config folder and update the desired initial configuration
141 | cd <O-DU High Directory>/l2/build/config
143 | Open the startup_config.xml and edit the desired IP and Port for CU, DU and RIC.
144 | Open the nacm_config.xml and edit the desired user name to provide the access to that user.
145 | Open the netconf_server_ipv6.xml and edit the desired netconf server configuration.
146 | Open the vesConfig.json and edit the details of VES collector.
147 | Open the netconfConfig.json and edit the details of Netopeer server.
148 | Install the yang modules and load initial configuration.
151 | cd <O-DU High Directory>/l2/build/scripts
152 | sudo ./load_yang.sh
154 - Start Netopeer2-server:
157 | cd <O-DU High Directory>/l2/build/scripts
158 | sudo ./netopeer-server.sh start
166 - Navigate to Build folder
168 cd <O-DU High Directory>/l2/build/odu
170 - Clean O-DU High binary
172 make clean_odu MACHINE=BIT64 MODE=FDD
175 - Compile O-DU High binary
177 make odu MACHINE=BIT64 MODE=FDD
182 - Navigate to Build folder
184 cd <O-DU High Directory>/l2/build/odu
186 - Clean CU Stub binary
188 make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
190 - Compile CU Stub binary
192 make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
196 - Navigate to Build folder
198 cd <O-DU High Directory>/l2/build/odu
200 - Clean RIC Stub binary
202 make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
204 - Compile RIC Stub binary
206 make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
209 Compilation with O1 interface enabled
210 --------------------------------------
214 - Navigate to Build folder
216 cd <O-DU High Directory>/l2/build/odu
218 - Clean O-DU High binary
220 make clean_odu MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
223 - Compile O-DU High binary
225 make odu MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
230 - Navigate to Build folder
232 cd <O-DU High Directory>/l2/build/odu
234 - Clean CU Stub binary
236 make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
238 - Compile CU Stub binary
240 make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
244 - Navigate to Build folder
246 cd <O-DU High Directory>/l2/build/odu
248 - Clean RIC Stub binary
250 make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
252 - Compile RIC Stub binary
254 make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
258 The above generated images can be found at:
260 - O-DU High - <O-DU High Directory>/l2/bin/odu
262 - CU Stub - <O-DU High Directory>/l2/bin/cu_stub
264 - RIC Stub - <O-DU High Directory>/l2/bin/ric_stub