OpenAirInterface-CN: Install: Difference between revisions

From OnnoCenterWiki
Jump to navigationJump to search
Created page with "penAirInterface November 28th 2019: fix from user review September 23rd 2019: minor fix of warnings September 2019, large rework and update to latest eNB June 21st 2019: re..."
 
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
penAirInterface
Sumber: https://open-cells.com/index.php/2019/09/22/all-in-one-openairinterface/
November 28th 2019: fix from user review


September 23rd 2019: minor fix of warnings


September 2019, large rework and update to latest eNB
==Download modifikasi open-cells==


June 21st 2019: replace ubuntu 17.04 by ubuntu 18.04
Download dan ekstrak data-nya,


Sept 7th 2017: small update for more recent eNB git commit version in develop branch
cd ~
wget https://open-cells.com/opencells-mods-20190923.tgz
tar xf opencells-mods-20190923.tgz


Starting condition:
==Download dan patch EPC==
Ubuntu 18.04 all packages upgraded, uhd last commit, OAI last commit


Modifications
Clone OAI EPC:


Latest commits
# maybe go back to home directory (leave openairinterface5g directory)
Fix a issue in mme that crash mme with some phones in the attach-request procedure
git clone https://gitlab.eurecom.fr/oai/openair-cn.git
If you want to fix only this issue, pick files:
cd openair-cn
src/nas/emm/Attach.c
git checkout develop
src/nas/ies/SupportedCodecList.c
in the hereafter tar file
The issue is: mme wrong decoding of smartphone codec list
Full re-test, from disk install of Ubuntu 17.04 to commercial UEs throughput measurement (Android 5 and Android 6)
This document explains how to install and configure OAI EPC+eNB on one single Ubuntu 18.04 64 bits machine connected with a regular UE, routing the UE traffic to internet.


The description uses a USRP B210 board.
Kita akan men-test dengan commit: 724542d0b59797b010af8c5df15af7f669c1e838


We also explain how to simplify, fix existing issues, to make a single computer as a full LTE network: EPC+eNB.
Eurecom gitlab sekarang membutuhkan login, jika kita tidak memilikinya, salinan repositori git ada di:


Known limitations fixed in the hereafter description
openair-cn


GTP UDP ports are in conflict for eNB and SGW
ekstrak tar dengan
Useless link between OAI and the Ubuntu/Linux hostname removed
Several simplifications and precisions to make easier and reliable installations
Install Ubuntu
Prepare a machine: a 4 actual cores, no hyper-threading.
All other configuration in OAI Wiki (C1 states, …) describes is about useless.
Download Ubuntu 18.04 64 bits version iso file
create a usb key to boot on it
install Ubuntu: choose to install Third party SW, and to upgrade all packages while installing
do: apt update; apt upgrade until the machine is up-to-date
install git and configure your identification in git:
sudo apt install git
git config --global user.name "Laurent"
git config --global user.email "laurent.thomas@open-cells.com"
Add the OAI repository as authorized remote system
echo -n | openssl s_client -showcerts -connect gitlab.eurecom.fr:443 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | sudo tee -a /etc/ssl/certs/ca-certificates.crt
if you are upset with sudo password, add this line in /etc/sudoers
xxxxxx ALL=(ALL) NOPASSWD: ALL (xxxxxx is your login name)
sudo will not ask anymore for a password
Install USRP drivers
We prefer to use UHD driver from source:


sudo apt-get install libboost-all-dev libusb-1.0-0-dev python-mako doxygen python-docutils python-requests python3-pip cmake build-essential
tar xf openair-cn.tgz
pip3 install mako numpy
cd openair-cn
git clone git://github.com/EttusResearch/uhd.git
git checkout develop
cd uhd; mkdir host/build; cd host/build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make -j4
sudo make install
sudo ldconfig
sudo /usr/lib/uhd/utils/uhd_images_downloader.py
Download our modifications
download and extract the data:


cd ~
Ini adalah komitmen terakhir untuk OAI EPC pada development tree ini. Active OpenAir EPC sekarang menjadi proyek lain di github. Di sini kita menggunakan EPC lawas ini karena pemasangannya cukup mudah (proyek baru menggunakan Cassandra, BANYAK mesin virtual, OpenVswitch, dan ketergantungan yang lebih kompleks).
wget https://open-cells.com/opencells-mods-20190923.tgz
 
tar xf opencells-mods-20190923.tgz
Apply patch:
Download and patch EPC
 
Clone OAI EPC:
git apply ~/opencells-mods/EPC.patch
 
Versi baru source file juga ada di tar, jika kita ingin menggabungkan dengan versi lain dari OpenAir EPC


# maybe go back to home directory (leave openairinterface5g directory)
Apa yang ada di patch file adalah:
git clone https://gitlab.eurecom.fr/oai/openair-cn.git
cd openair-cn
git checkout develop
We tested with commit: 724542d0b59797b010af8c5df15af7f669c1e838


The Eurecom gitlab require now a login, if you don’t have one, a copy of the git repository is in:openair-cn extract the tar with
* Tambahkan Ubuntu 18.04 untuk kompilasi dan perbaiki beberapa bug
* Hapus link antara  host name Linux dan konfigurasi protokol diameter LTE
* Tambahkan penggunaan alamat input untuk soket input SGW
* memodifikasi interface S6a freediameter untuk memperbaiki parameter OAI yang salah
* Tidak diperlukan tambalan modul kernel: kernel generik Ubuntu 18.04 berfungsi baik dengan OAI
pisahkan instalasi kompiler ASN.1 agar kompatibel dengan komponen OpenAir lainnya pada mesin yang sama (versi ans1c berbeda untuk eNB dan gNB)


tar xf openair-cn.tgz
==Install third party SW untuk EPC==
cd openair-cn
git checkout develop
This is the last commit for OAI EPC on this development tree. Active OpenAir EPC is now another project on github. We use here this legacy EPC because the installation is quite easy (the new project uses Cassandra, al LOT of virtual machines, OpenVswitch and complex dependancies).


Apply the patch:
cd openair-cn; source oaienv; cd scripts
./build_hss -i


git apply ~/opencells-mods/EPC.patch
* Jawab yes untuk install: freeDiameter 1.2.0
The new version of the source files are also in the tar, if you want to merge with another version of OpenAir EPC
* phpmyadmin:
** Kita tidak menggunakan phpmyadmin nanti dalam prosedur ini untuk memperbarui database MySQL
** Kita menghapus instalasi phpmyadmin (tentu saja kita dapat menggunakannya jika kita mau)


What is in the patch file:
Untuk ubuntu 18.04, kami mengatur kembali tingkat keamanan mysql


Add Ubuntu 18.04 for compilation and fix some bugs
sudo mysql -u root << END
Remove link between Linux host name and LTE diameter protocol configuration
USE mysql;
Add usage of the input address for the SGW input socket
UPDATE user SET plugin='mysql_native_password' WHERE User='root';
modify the freediameter S6a interface to fix a wrong OAI parameter
FLUSH PRIVILEGES;
No kernel module patch is required: generic Ubuntu kernel 18.04 works fine with OAI
END
separate ASN.1 compiler installation to be compatible with other OpenAir components on the same machine (ans1c version is different for eNB and gNB)
Install third party SW for EPC
cd openair-cn; source oaienv; cd scripts
./build_hss -i
Answer yes to install: freeDiameter 1.2.0
phpmyadmin:
We don’t use phpmyadmin later in this procedure to update the MySQL database
We removed the installation of phpmyadmin (of course you can use it if you prefer)
For ubuntu 18.04, we set back the legacy mysql security level


sudo mysql -u root << END
sudo systemctl restart mysql.service
USE mysql;
sudo mysql_secure_installation
UPDATE user SET plugin='mysql_native_password' WHERE User='root';
FLUSH PRIVILEGES;
END


sudo systemctl restart mysql.service
Perintah terakhir akan menanyakan beberapa pertanyaan:


sudo mysql_secure_installation
password: set your password (linux is set in our default config files)
The last command will ask a few questions:
VALIDATE PASSWORD PLUGIN: no
Remove anonymous users: yes
Disallow root login remotely: yes
Remove test database and access to it: yes
Reload privilege tables now: yes


password: set your password (linux is set in our default config files)
VALIDATE PASSWORD PLUGIN: no
Remove anonymous users: yes
Disallow root login remotely: yes
Remove test database and access to it: yes
Reload privilege tables now: yes
Install 3PP SW for mme and spgw
Install 3PP SW for mme and spgw
./build_mme -i
 
Do you want to install freeDiameter 1.2.0: no
./build_mme -i
Do you want to install asn1c rev 1516 patched? <y/N>: yes
 
Do you want to install libgtpnl ? <y/N>: yes
Do you want to install freeDiameter 1.2.0: no
wireshark permissions: as you prefer
Do you want to install asn1c rev 1516 patched? <y/N>: yes
Do you want to install libgtpnl ? <y/N>: yes
wireshark permissions: as you prefer
 
  ./build_spgw -i
  ./build_spgw -i
Do you want to install libgtpnl ? <y/N>: no
Compile the EPC nodes
No difficulty found in this phase.


cd openair-cn; source oaienv; cd scripts
Do you want to install libgtpnl ? <y/N>: no
./build_hss
 
./build_mme
==Compile EPC node==
./build_spgw
 
If you face compilation issues, the log files are in openair-cn/build/log
Tidak ada kesulitan yang ditemukan pada fase ini.
 
cd openair-cn; source oaienv; cd scripts
./build_hss
./build_mme
./build_spgw
 
Jika kita menghadapi masalah kompilasi, file log ada di openair-cn/build/log
 
Di file tersebut, cari "error:" string.
 
 
 
==Referensi==
 
* https://open-cells.com/index.php/2019/09/22/all-in-one-openairinterface/
 
 
==Pranala Menarik==


In there files, look for “error:” string.
* [[5G]]

Latest revision as of 02:51, 21 December 2022

Sumber: https://open-cells.com/index.php/2019/09/22/all-in-one-openairinterface/


Download modifikasi open-cells

Download dan ekstrak data-nya,

cd ~
wget https://open-cells.com/opencells-mods-20190923.tgz
tar xf opencells-mods-20190923.tgz

Download dan patch EPC

Clone OAI EPC:

# maybe go back to home directory (leave openairinterface5g directory)
git clone https://gitlab.eurecom.fr/oai/openair-cn.git
cd openair-cn
git checkout develop

Kita akan men-test dengan commit: 724542d0b59797b010af8c5df15af7f669c1e838

Eurecom gitlab sekarang membutuhkan login, jika kita tidak memilikinya, salinan repositori git ada di:

openair-cn

ekstrak tar dengan

tar xf openair-cn.tgz
cd openair-cn
git checkout develop

Ini adalah komitmen terakhir untuk OAI EPC pada development tree ini. Active OpenAir EPC sekarang menjadi proyek lain di github. Di sini kita menggunakan EPC lawas ini karena pemasangannya cukup mudah (proyek baru menggunakan Cassandra, BANYAK mesin virtual, OpenVswitch, dan ketergantungan yang lebih kompleks).

Apply patch:

git apply ~/opencells-mods/EPC.patch

Versi baru source file juga ada di tar, jika kita ingin menggabungkan dengan versi lain dari OpenAir EPC

Apa yang ada di patch file adalah:

  • Tambahkan Ubuntu 18.04 untuk kompilasi dan perbaiki beberapa bug
  • Hapus link antara host name Linux dan konfigurasi protokol diameter LTE
  • Tambahkan penggunaan alamat input untuk soket input SGW
  • memodifikasi interface S6a freediameter untuk memperbaiki parameter OAI yang salah
  • Tidak diperlukan tambalan modul kernel: kernel generik Ubuntu 18.04 berfungsi baik dengan OAI

pisahkan instalasi kompiler ASN.1 agar kompatibel dengan komponen OpenAir lainnya pada mesin yang sama (versi ans1c berbeda untuk eNB dan gNB)

Install third party SW untuk EPC

cd openair-cn; source oaienv; cd scripts
./build_hss -i
  • Jawab yes untuk install: freeDiameter 1.2.0
  • phpmyadmin:
    • Kita tidak menggunakan phpmyadmin nanti dalam prosedur ini untuk memperbarui database MySQL
    • Kita menghapus instalasi phpmyadmin (tentu saja kita dapat menggunakannya jika kita mau)

Untuk ubuntu 18.04, kami mengatur kembali tingkat keamanan mysql

sudo mysql -u root << END
USE mysql;
UPDATE user SET plugin='mysql_native_password' WHERE User='root';
FLUSH PRIVILEGES;
END
sudo systemctl restart mysql.service
sudo mysql_secure_installation

Perintah terakhir akan menanyakan beberapa pertanyaan:

password: set your password (linux is set in our default config files)
VALIDATE PASSWORD PLUGIN: no
Remove anonymous users: yes
Disallow root login remotely: yes
Remove test database and access to it: yes
Reload privilege tables now: yes

Install 3PP SW for mme and spgw

./build_mme -i
Do you want to install freeDiameter 1.2.0: no
Do you want to install asn1c rev 1516 patched? <y/N>: yes
Do you want to install libgtpnl ? <y/N>: yes
wireshark permissions: as you prefer
./build_spgw -i
Do you want to install libgtpnl ? <y/N>: no

Compile EPC node

Tidak ada kesulitan yang ditemukan pada fase ini.

cd openair-cn; source oaienv; cd scripts
./build_hss
./build_mme
./build_spgw

Jika kita menghadapi masalah kompilasi, file log ada di openair-cn/build/log

Di file tersebut, cari "error:" string.


Referensi


Pranala Menarik