Difference between revisions of "OpenAirInterface-CN: Install"

From OnnoWiki
Jump to navigation Jump 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 2 users 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 09: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