From c58b554d0122466dfc5704894272be84fd5a9a84 Mon Sep 17 00:00:00 2001
From: Carlos Antonio De Lima Filho <carlos.lima.106@ufrn.edu.br>
Date: Sat, 10 Jun 2023 12:46:42 +0000
Subject: [PATCH] Change the README

---
 .../openairinterface-conf/fig/oai_core.png    | Bin 0 -> 55864 bytes
 .../README.md                                 | 167 ++++++++----------
 2 files changed, 73 insertions(+), 94 deletions(-)
 create mode 100644 openairinterface5g/openairinterface-conf/fig/oai_core.png

diff --git a/openairinterface5g/openairinterface-conf/fig/oai_core.png b/openairinterface5g/openairinterface-conf/fig/oai_core.png
new file mode 100644
index 0000000000000000000000000000000000000000..b84bf81434f6e7231c977b6022e05175bc5c89e0
GIT binary patch
literal 55864
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
Ye^D%(B=1y}s{jB107*qoM6N<$f<0%>J^%m!

literal 0
HcmV?d00001

diff --git a/openairinterface5g/openairinterface-install-scripts/README.md b/openairinterface5g/openairinterface-install-scripts/README.md
index 1f44668f7..452f77608 100644
--- a/openairinterface5g/openairinterface-install-scripts/README.md
+++ b/openairinterface5g/openairinterface-install-scripts/README.md
@@ -8,100 +8,79 @@
     2. RAM: 8 GB
     
 ## 5G Core Installation
-### The following steps can be executed by the file oai_5g_core_install.sh
-    1. First step is to download docker, docker-compose, git and network tools. 
-    2. Following you need to download wireshark
-        A. sudo add-apt-repository ppa:wireshark-dev/stable
-        B. sudo apt update
-        C. sudo apt install wireshark
-    3. Git clone the 5GC
-        A. git clone --branch v1.4.0 https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed.git
-        B. Configuration of the packet forwarding
-            - sudo sysctl net.ipv4.conf.all.forwarding=1
-            - sudo iptables -P FORWARD ACCEPT
-    4. Pulling the images from Docker Hub
-        A. docker pull oaisoftwarealliance/oai-amf:v1.4.0
-        B. docker pull oaisoftwarealliance/oai-nrf:v1.4.0
-        C. docker pull oaisoftwarealliance/oai-smf:v1.4.0 
-        D. docker pull oaisoftwarealliance/oai-spgwu-tiny:v1.4.0
-        E. docker pull oaisoftwarealliance/oai-udr:v1.4.0
-        F. docker pull oaisoftwarealliance/oai-udm:v1.4.0
-        G. docker pull oaisoftwarealliance/oai-ausf:v1.4.0
-        H. docker pull oaisoftwarealliance/oai-upf-vpp:v1.4.0
-        I. docker pull oaisoftwarealliance/oai-nssf:v1.4.0
-        J. docker pull oaisoftwarealliance/trf-gen-cn5g:latest
-    5. Tag docker images
-        A. docker image tag oaisoftwarealliance/oai-amf:v1.4.0 oai-amf:v1.4.0
-        B. docker image tag oaisoftwarealliance/oai-nrf:v1.4.0 oai-nrf:v1.4.0
-        C. docker image tag oaisoftwarealliance/oai-smf:v1.4.0 oai-smf:v1.4.0
-        D. docker image tag oaisoftwarealliance/oai-spgwu-tiny:v1.4.0 oai-spgwu-tiny:v1.4.0
-        E. docker image tag oaisoftwarealliance/oai-udr:v1.4.0 oai-udr:v1.4.0
-        F. docker image tag oaisoftwarealliance/oai-udm:v1.4.0 oai-udm:v1.4.0
-        G. docker image tag oaisoftwarealliance/oai-ausf:v1.4.0 oai-ausf:v1.4.0
-        H. docker image tag oaisoftwarealliance/oai-upf-vpp:v1.4.0 oai-upf-vpp:v1.4.0
-        I. docker image tag oaisoftwarealliance/oai-nssf:v1.4.0 oai-nssf:v1.4.0
-        J. docker image tag oaisoftwarealliance/trf-gen-cn5g:latest trf-gen-cn5g:latest
-    6. Synchronizing the tutorials
-        A. Change the directory for ~/oai-cn5g-fed/
-        B. ./scripts/syncComponents.sh
-        C. git submodule deinit --all --force
-        D. git submodule init
-        F. git submodule update        
-    7. Configure the bridge before deploying 5GC.
-        A. docker network create \ --driver=bridge \ --subnet=192.168.70.128/26 \ -o "com.docker.network.bridge.name"="demo-oai" \ demo-oai-public-net
-    8. Deploy the 5GC
-        A. Change the directory for ~/oai-cn5g-fed/docker-compose
-        B. python3 core-network.py --type start-basic --scenario 1
+### General Instruction
+    Important: The following steps can be executed by the file oai_5g_core_install.sh
+    In this task you will install and configure the core in its basic architecture according to the image below:
+    
+![ALT](/openairinterface5g/openairinterface-conf/fig/oai_core.png)  
+
+    Step 1: Install dependencies 
+        sudo apt-get install ca-certificates 
+        sudo apt-get install curl 
+        sudo apt-get install gnupg 
+        sudo apt-get install lsb-release 
+
+    Step 2: Enable packet forwarding
+        sudo sysctl net.ipv4.conf.all.forwarding=1
+        sudo iptables -P FORWARD ACCEPT
+
+    Step 3: Install docker and docker-compose
+        sudo rm /etc/apt/sources.list.d/docker.list*
+        sudo mkdir -p /etc/apt/keyrings 
+        curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
+        sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(. /etc/os-release; echo "$UBUNTU_CODENAME") stable"
+        sudo chmod a+r /etc/apt/keyrings/docker.gpg
+        sudo apt-get update
+        sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
+        sudo curl -L https://github.com/docker/compose/releases/download/1.29.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
+        sudo chmod +x /usr/local/bin/docker-compose
+    
+    Step 4: Pull the images from Docker Hub
+        sudo docker pull oaisoftwarealliance/oai-amf:v1.5.0
+        sudo docker pull oaisoftwarealliance/oai-nrf:v1.5.0
+        sudo docker pull oaisoftwarealliance/oai-smf:v1.5.0
+        sudo docker pull oaisoftwarealliance/oai-udr:v1.5.0
+        sudo docker pull oaisoftwarealliance/oai-udm:v1.5.0
+        sudo docker pull oaisoftwarealliance/oai-ausf:v1.5.0
+        sudo docker pull oaisoftwarealliance/oai-spgwu-tiny:v1.5.0
+        sudo docker pull oaisoftwarealliance/trf-gen-cn5g:latest
 
-## FlexRIC, gNB and UE Installation
-### The following steps can be executed by the file flexRIC_oai_gNB_install.sh
-    1. Install the following dependencies
-        A. sudo apt-get install autotools-dev
-        B. sudo apt-get install automake
-        C. sudo apt-get install libpcre2-dev
-        D. sudo apt-get install pcre2-utils
-        E. sudo apt-get install bison
-        F. sudo apt-get install byacc
-        G. sudo apt install g++
-        H. sudo apt install libsctp-dev python3.8 cmake-curses-gui libpcre2-dev python3-dev    
-    2. Configure swig
-        A. git clone https://github.com/swig/swig.git 
-        B. cd path_to_swig
-        C. ./autogen.sh
-        D. ./configure --prefix=/usr/
-        E. sudo make
-        F. sudo make install
-    3. Install FlexRIC
-        A. git clone https://gitlab.eurecom.fr/mosaic5g/flexric.git ~/flexric
-        B. cd path_to_flexric
-        C. git checkout v1.0.0
-        D. mkdir build
-        E. cd build
-        F. sudo cmake ..
-        G. sudo make
-        H. sudo make install
-    4. Install dependencies for OpenAirInterface 5G
-        A. sudo add-apt-repository ppa:ettusresearch/uhd -y
-        B. sudo apt-get update -y
-        C. sudo apt-get install libuhd-dev uhd-host -y
-        D. sudo apt-get install libuhd4.2.0 -y
-        E. sudo dpkg -i --force-overwrite /var/cache/apt/archives/libuhd4.2.0_4.2.0.1-0ubuntu1~focal1_amd64.deb
-    5. Download the OpenAirInterface 5G repository 
-        A. git clone https://gitlab.eurecom.fr/oai/openairinterface5g.git oai
-    6. Change the openairinterface 5G branch for 2022.41
-        A. cd oai/
-        B. git checkout 2022.41
-    7. Apply FlexRIC patch
-        A. git am <pathtoflexricsrc>/flexric/multiRAT/oai/oai.patch --whitespace=nowarn
-    8. Download the OAI configuration files (CU/DU, OAI UE, and gNB configuration)
-        A. sudo wget -O ~/oai/executables/nr-softmodem.c https://projetos.imd.ufrn.br/reginalab/sdran-openairinterface/-/raw/main/OpenAirInterface/OpenAirInterface-Conf/nr-softmodem.c?inline=false
-        B. sudo wget -O ~/oai/ci-scripts/conf_files/gNB_SA_CU.conf https://projetos.imd.ufrn.br/reginalab/sdran-openairinterface/-/raw/main/OpenAirInterface/OpenAirInterface-Conf/gNB_SA_CU.conf?inline=false
-        C. sudo wget -O ~/oai/ci-scripts/conf_files/gNB_SA_DU.conf https://projetos.imd.ufrn.br/reginalab/sdran-openairinterface/-/raw/main/OpenAirInterface/OpenAirInterface-Conf/gNB_SA_DU.conf?inline=false
-        D. sudo wget -O ~/oai/targets/PROJECTS/GENERIC-NR-5GC/CONF/ue.conf https://projetos.imd.ufrn.br/reginalab/sdran-openairinterface/-/raw/main/OpenAirInterface/OpenAirInterface-Conf/ue.conf?inline=false
+    Step 5: Tag Docker Images
+        sudo docker image tag oaisoftwarealliance/trf-gen-cn5g:latest trf-gen-cn5g:latest
+        sudo docker image tag oaisoftwarealliance/oai-amf:v1.5.0 oai-amf:v1.5.0
+        sudo docker image tag oaisoftwarealliance/oai-nrf:v1.5.0 oai-nrf:v1.5.0
+        sudo docker image tag oaisoftwarealliance/oai-smf:v1.5.0 oai-smf:v1.5.0
+        sudo docker image tag oaisoftwarealliance/oai-udr:v1.5.0 oai-udr:v1.5.0
+        sudo docker image tag oaisoftwarealliance/oai-udm:v1.5.0 oai-udm:v1.5.0
+        sudo docker image tag oaisoftwarealliance/oai-ausf:v1.5.0 oai-ausf:v1.5.0
+        sudo docker image tag oaisoftwarealliance/oai-spgwu-tiny:v1.5.0 oai-spgwu-tiny:v1.5.0
 
-    9. Install the gNB and UE
-        A. source oaienv
-        B. cd cmake_targets
-        C. ./build_oai -I -w USRP -i  #For OAI first time installation. it will install some dependencies
-        D. ./build_oai --gNB --nrUE -c -C -w USRP --ninja --build-lib all
+    Step 6: Clone OpenAirInterface 5G Core repository
+        git clone https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed.git
+        cd oai-cn5g-fed
+        git checkout -f v1.5.0
 
+## RAN and UE installation (Split and Monolithic mode)
+### General Instruction
+    In this task you will install and configure the gNB of the OAI.
+
+    Step 1: Install dependencies
+        sudo add-apt-repository ppa:ettusresearch/uhd
+        sudo apt-get install libuhd-dev uhd-host -y
+        sudo apt-get install libuhd4.2.0 -y
+        sudo apt-get install libuhd4.4.0 -y
+
+    Step 2: Fix problem in the libuhd
+        sudo dpkg -i --force-overwrite /var/cache/apt/archives/libuhd4.2.0_4.2.0.1-0ubuntu1~focal1_amd64.deb
+        sudo dpkg -i --force-overwrite /var/cache/apt/archives/libuhd4.4.0_4.4.0.0-0ubuntu1~focal1_amd64.deb
+
+    Step 3: Clone OpenAirInterface 5G RAN and UE repository
+        git clone https://gitlab.eurecom.fr/oai/openairinterface5g.git
+        cd PATH_TO/openairinterface5g
+        git checkout develop
+    
+    Step 4: Run the installation script
+        source oaienv
+        cd cmake_targets
+        sudo ./build_oai -I -w USRP -i
+        sudo ./build_oai --gNB --nrUE -w USRP
\ No newline at end of file
-- 
GitLab