O-DU High Installation Guide

This document describes how to install O-DU High, it’s dependencies and required system resources.

Version history 

Date	Ver.	Author	Comment
2023-12-14	7.0.1	Radisys	I release
2023-06-13	6.0.1	Radisys	H release
2022-12-15	5.0.1	Radisys, HCL Technologies Ltd.	G release
2022-06-16	4.0.0	Radisys, HCL Technologies Ltd.	F release
2022-01-14	3.0.0	Radisys, HCL Technologies Ltd.	e-release
2021-07-07	2.0.0	Radisys, HCL Technologies Ltd.	D Release
2020-12-04	1.0.1	HCL Technologies Ltd.	Cherry Release
2020-12-04	1.0	Radisys	Cherry Release

This document describes the hardware and software requirements along with guidelines on how to install O-DU High.

The audience of this document is assumed to have good knowledge in RAN concepts and Linux system.

O-DU High images can be built using the source code or corresponding docker images can be downloaded.

Following minimum hardware requirements must be met for installation of O-DU High

This section describes the installation of the O-DU High on the reference hardware.

Following libraries are required to compile and execute O-DU High:

GCC
- Ubuntu : sudo apt-get install -y build-essential
- CentOS : sudo yum groups mark install -y “Development Tools”
Ensure the version is 4.6.3 and above using
- gcc –version
LKSCTP
- Ubuntu : sudo apt-get install -y libsctp-dev
- CentOS : sudo yum install -y lksctp-tools-devel
PCAP:
- Ubuntu : sudo apt-get install -y libpcap-dev
- CentOS : sudo yum install -y libpcap-devel
libxml2
- Ubuntu : sudo apt-get install -y libxml2-dev
- CentOS : sudo yum install -y libxml2

Create a folder to clone the O-DU High code into. The folder is hereafter referred to as <O-DU High Directory>.
Clone code into <O-DU High Directory>

git clone “https://gerrit.o-ran-sc.org/r/o-du/l2”

Following steps are required to compile and run ODU with O1 interface enabled.

Create a new netconf user
Switch to root user or use sudo and run following commands
- Ubuntu :
  
  cd <O-DU High Directory>/l2/build/scripts
  
  sudo ./add_netconf_user.sh
Install Netconf libraries:
libssh, libyang, libnetconf2, sysrepo, netopeer2

Script is provided in the following folder to install these libraries
- Ubuntu :
  
  cd <O-DU High Directory>/l2/build/scripts
  
  sudo ./install_lib_O1.sh -c
Install the YANG modules and load initial configuration
- Navigate to config folder and update the desired initial configuration
  
  cd <O-DU High Directory>/l2/build/config
  
  Open the startup_config.xml and edit the desired IP and Port for CU, DU and RIC.
  
  Open the nacm_config.xml and edit the desired user name to provide the access to that user.
  
  Open the netconf_server_ipv6.xml and edit the desired netconf server configuration.
  
  Open the oamVesConfig.json and edit the details of OAM VES collector.
  
  Open the smoVesConfig.json and edit the details of SMO VES collector.
  
  Open the netconfConfig.json and edit the details of Netopeer server.
Install the yang modules and load initial configuration.
- Ubuntu :
$cd <O-DU High Directory>/l2/build/scripts

$sudo ./load_yang.sh
Start Netopeer2-server:
- Ubuntu :
  
  cd <O-DU High Directory>/l2/build/scripts
  
  sudo ./netopeer-server.sh start
In case standard defined VES format is to be enabled (this step is optional):

cd l2/src/o1/ves

Enable the Macro “StdDef” in file VesUtils.h

#define StdDef

The above generated images can be found at: