open5gs/docs/_docs/platform/02-centos.md

3.3 KiB

title head_inline
CentOS <style> .blue { color: blue; } </style>

This guide is based on CentOS 8 Distribution. {: .blue}

Getting MongoDB


Create the MongoDB repository file.

$ sudo sh -c 'cat << EOF > /etc/yum.repos.d/mongodb-org-3.4.repo
[mongodb-org-3.4]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/3.4/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.4.asc
EOF'

Install MongoDB with Package Manager.

sudo yum -y install mongodb-org
sudo systemctl start mongod (if '/usr/bin/mongod' is not running)

Setting up TUN device (No persistent after rebooting)


Create the TUN device. Interface name will be ogstun.

$ sudo yum -y install iproute
$ sudo ip tuntap add name ogstun mode tun
$ ip link show

Then, to support IPv6-enabled UEs, you must configure your TUN device to support IPv6.

$ sysctl -n net.ipv6.conf.ogstun.disable_ipv6
1

$ sudo -w net.ipv6.conf.ogstun.disable_ipv6=0

$ sysctl -n net.ipv6.conf.ogstun.disable_ipv6
0

Note: If your TUN device already supports IPv6, you can skip this steps above. {: .notice--warning}

You are now ready to set the IP address on TUN device.

$ sudo ip addr add 10.45.0.1/16 dev ogstun
$ sudo ip addr add cafe::1/64 dev ogstun

Make sure it is set up properly.

$ sudo ip link set ogstun up
$ ip link show

Tip: The script provided in [$GIT_REPO/misc/netconf.sh](https://github.com/{{ site.github_username }}/open5gs/blob/master/misc/netconf.sh) makes it easy to configure the TUN device as follows:
$ sudo ./misc/netconf.sh {: .notice--info}

Building Open5GS


Configure EPEL package.

$ sudo dnf install epel-release

Enable PowerTools.

$ sudo dnf install 'dnf-command(config-manager)'
$ sudo dnf config-manager --set-enabled PowerTools
$ sudo update

Install the depedencies for building the source code.

$ sudo dnf install python3 ninja-build gcc flex bison git lksctp-tools-devel libidn-devel gnutls-devel libgcrypt-devel openssl-devel cyrus-sasl-devel libyaml-devel iproute mongo-c-driver-devel

Install Meson using Python.

$ sudo pip3 install --upgrade pip 
$ sudo pip install meson

Git clone.

$ git clone https://github.com/{{ site.github_username }}/open5gs

To compile with meson:

$ cd open5gs
$ meson build --prefix=`pwd`/install
$ ninja -C build

Check whether the compilation is correct.

$ ninja -C build test

Tip: You can also check the result of ninja -C build test with a tool that captures packets. If you are running wireshark, select the loopback interface and set FILTER to s1ap || gtpv2 || diameter || gtp. You can see the virtually created packets. testsimple.pcapng({{ site.url }}{{ site.baseurl }}/assets/pcapng/testsimple.pcapng) {: .notice--info}

You need to perform the installation process.

$ cd build
$ ninja install

Building WebUI of Open5GS


Node.js is required to build WebUI of Open5GS

$ curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
$ sudo yum -y install nodejs

Install the dependencies to run WebUI

$ cd webui
$ npm install

The WebUI runs as an npm script.

$ npm run dev