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