docs/installation-guide.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4 .. contents::
   5    :depth: 3
   6    :local:
   7
   8 O-DU High Installation Guide
   9 *****************************
  10
  11 Abstract
  12 ========
  13
  14 This document describes how to install O-DU High, it's dependencies and required system resources.
  15
  16 .. contents::
  17    :depth: 3
  18    :local:
  19
  20 Version history
  21
  22
  23 +--------------------+--------------------+--------------------+--------------------+
  24 | **Date**           | **Ver.**           | **Author**         | **Comment**        |
  25 |                    |                    |                    |                    |
  26 +--------------------+--------------------+--------------------+--------------------+
  27 | 2020-12-04         |  1.0               |  Radisys           |  Cherry Release    |
  28 |                    |                    |                    |                    |
  29 +--------------------+--------------------+--------------------+--------------------+
  30
  31
  32 Introduction
  33 ============
  34
  35 This document describes the hardware and software requirements along with guidelines on how to install O-DU High.
  36
  37 The audience of this document is assumed to have good knowledge in RAN concepts and Linux system.
  38
  39
  40 Preface
  41 =======
  42
  43 O-DU High images can be built using the source code or corresponding docker images can be downloaded.
  44
  45
  46 Hardware requirements
  47 =====================
  48
  49 Following minimum hardware requirements must be met for installation of O-DU High
  50
  51 +--------------------+----------------------------------------------------+
  52 | **HW Aspect**      | **Requirement**                                    |
  53 |                    |                                                    |
  54 +--------------------+----------------------------------------------------+
  55 | **# of servers**   |  1                                                 |
  56 +--------------------+----------------------------------------------------+
  57 | **CPU**            |  4                                                 |
  58 |                    |                                                    |
  59 +--------------------+----------------------------------------------------+
  60 | **RAM**            |  8G                                                |
  61 |                    |                                                    |
  62 +--------------------+----------------------------------------------------+
  63 | **Disk**           |  500G                                              |
  64 |                    |                                                    |
  65 +--------------------+----------------------------------------------------+
  66 | **NICs**           |  1                                                 |
  67 |                    |                                                    |
  68 +--------------------+----------------------------------------------------+
  69
  70
  71 Software installation and deployment
  72 ==========================================
  73
  74 This section describes the installation of the O-DU High on the reference hardware.
  75
  76 Libraries
  77 ----------
  78
  79 Following libraries are required to compile and execute O-DU High:
  80
  81 - GCC
  82    - Ubuntu : sudo apt-get install -y build-essential
  83    - CentOS : sudo yum groups mark install -y “Development Tools”
  84
  85    Ensure the version is 4.6.3 and above using
  86
  87    -    gcc --version
  88
  89 - LKSCTP
  90    - Ubuntu : sudo apt-get install -y libsctp-dev
  91    - CentOS : sudo yum install -y lksctp-tools-devel
  92
  93 - PCAP:
  94    - Ubuntu : sudo apt-get install -y libpcap-dev
  95    - CentOS : sudo yum install -y libpcap-devel
  96
  97 Cloning code
  98 --------------
  99
 100 - Create a folder to clone the O-DU High code into. The folder is hereafter referred to as <O-DU High Directory>.
 101
 102 - Clone code into <O-DU High Directory>
 103
 104   git clone "https://gerrit.o-ran-sc.org/r/o-du/l2"
 105
 106 Compilation
 107 ------------
 108
 109 - Build O-DU High:
 110
 111    - Navigate to Build folder
 112
 113        cd <O-DU High Directory>/l2/build/odu
 114
 115    - Clean O-DU High binary
 116
 117        make clean_odu MACHINE=BIT64 MODE=FDD
 118
 119    - Build O-DU High binary
 120
 121        make odu MACHINE=BIT64 MODE=FDD
 122
 123 - Build CU Stub :
 124
 125    - Navigate to Build folder
 126
 127        cd <O-DU High Directory>/l2/build/odu
 128
 129    - Clean CU Stub binary
 130
 131        make clean_cu NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
 132
 133    - Build CU Stub binary
 134
 135        make cu_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
 136
 137 - Build RIC Stub :
 138
 139    - Navigate to Build folder
 140
 141        cd <O-DU High Directory>/l2/build/odu
 142
 143    - Clean RIC Stub binary
 144
 145        make clean_ric NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
 146
 147    - Build RIC Stub binary
 148
 149        make ric_stub NODE=TEST_STUB MACHINE=BIT64 MODE=FDD
 150
 151
 152 The above generated images can be found at:
 153
 154 - O-DU High - <O-DU High Directory>/l2/bin/odu
 155
 156 - CU Stub   - <O-DU High Directory>/l2/bin/cu_stub
 157
 158 - RIC Stub  - <O-DU High Directory>/l2/bin/ric_stub