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-06-10

8.0.1

Radisys

J release

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

Introduction

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.

Preface

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

Hardware requirements

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

HW Aspect

Requirement

# of servers

1

CPU

4

RAM

8G

Disk

500G

NICs

1

Software installation and deployment

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

Libraries

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 11.4.0 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

Cloning code

  • 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

Setting up Netconf server (Only if O1 interface enabled)

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

Compilation

  • Build O-DU High:

    • Navigate to Build folder

      cd <O-DU High Directory>/l2/build/odu

    • Clean O-DU High binary

      make clean_odu MACHINE=BIT64 MODE=FDD

    • Compile O-DU High binary

      make odu MACHINE=BIT64 MODE=FDD

  • Build CU Stub :

    • Navigate to Build folder

      cd <O-DU High Directory>/l2/build/odu

    • Clean CU Stub binary

      make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD

    • Compile CU Stub binary

      make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD

  • Build RIC Stub :

    • Navigate to Build folder

      cd <O-DU High Directory>/l2/build/odu

    • Clean RIC Stub binary

      make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD

    • Compile RIC Stub binary

      make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD

Compilation with O1 interface enabled

  • Build O-DU High:

    • Navigate to Build folder

      cd <O-DU High Directory>/l2/build/odu

    • Clean O-DU High binary

      make clean_odu MACHINE=BIT64 MODE=FDD O1_ENABLE=YES

    • Compile O-DU High binary

      make odu MACHINE=BIT64 MODE=FDD O1_ENABLE=YES

  • Build CU Stub :

    • Navigate to Build folder

      cd <O-DU High Directory>/l2/build/odu

    • Clean CU Stub binary

      make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES

    • Compile CU Stub binary

      make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES

  • Build RIC Stub :

    • Navigate to Build folder

      cd <O-DU High Directory>/l2/build/odu

    • Clean RIC Stub binary

      make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES

    • Compile RIC Stub binary

      make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD O1_ENABLE=YES

The above generated images can be found at:

  • O-DU High - <O-DU High Directory>/l2/bin/odu

  • CU Stub - <O-DU High Directory>/l2/bin/cu_stub

  • RIC Stub - <O-DU High Directory>/l2/bin/ric_stub