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
100 Following libraries are required to compile and execute O1 module:
103 libssh, libyang, libnetconf2, sysrepo, netopeer2
105 Script is provided in the following folder to install these libraries
109 | cd <O-DU High Directory>/l2/build/o1
110 | sudo ./install_lib.sh
116 - Create a folder to clone the O-DU High code into. The folder is hereafter referred to as <O-DU High Directory>.
118 - Clone code into <O-DU High Directory>
120 git clone "https://gerrit.o-ran-sc.org/r/o-du/l2"
127 - Navigate to Build folder
129 cd <O-DU High Directory>/l2/build/odu
131 - Clean O-DU High binary
133 make clean_odu MACHINE=BIT64 MODE=FDD
136 - Build O-DU High binary
138 make odu MACHINE=BIT64 MODE=FDD
140 To build with O1 interface enabled:
142 make odu MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
146 - Navigate to Build folder
148 cd <O-DU High Directory>/l2/build/odu
150 - Clean CU Stub binary
152 make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
154 - Build CU Stub binary
156 make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
160 - Navigate to Build folder
162 cd <O-DU High Directory>/l2/build/odu
164 - Clean RIC Stub binary
166 make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
168 - Build RIC Stub binary
170 make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
172 - Build O-DU High with O1 interface enabled:
174 - Navigate to o1 Build folder
176 cd <O-DU High Directory>/l2/build/o1
180 make clean_o1 MACHINE=BIT64
184 make o1 MACHINE=BIT64
186 - Navigate to odu Build folder
188 cd <O-DU High Directory>/l2/build/odu
190 - Clean O-DU High binary
192 make clean_odu MACHINE=BIT64 MODE=FDD
194 - Build O-DU High binary
196 make odu MACHINE=BIT64 MODE=FDD O1_ENABLE=YES
200 The above generated images can be found at:
202 - O-DU High - <O-DU High Directory>/l2/bin/odu
204 - CU Stub - <O-DU High Directory>/l2/bin/cu_stub
206 - RIC Stub - <O-DU High Directory>/l2/bin/ric_stub
208 - O1 - <O-DU High Directory>/l2/build/o1/bin/o1