3.6 KiB
title | head_inline |
---|---|
FreeBSD | <style> .blue { color: blue; } </style> |
This guide is based on FreeBSD Relase 11.1. {: .blue}
Getting MongoDB
Install MongoDB with package manager.
$ sudo pkg install mongodb
Run MongoDB server.
$ mkdir -p ./data/db
$ mongod --dbpath ./data/db
Setting up TUN device (No persistent after rebooting)
Configure the TUN device.
$ sudo ifconfig lo0 alias 127.0.0.2 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.3 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.4 netmask 255.255.255.255
$ sudo ifconfig lo0 alias 127.0.0.5 netmask 255.255.255.255
Enable IP forwarding
$ sudo sysctl -w net.inet.ip.forwarding=1
Tip: The script provided in [$GIT_REPO/support/network/restart.sh](https://github.com/{{ site.github_username }}/nextepc/blob/master/support/network/restart.sh) makes it easy to configure the TUN device as follows:
$ sudo ./support/network/restart.sh
{: .notice--info}
Building NextEPC
Install the depedencies for building the source code.
$ sudo pkg install git gcc bison gsed pkgconf autoconf automake libtool mongo-c-driver gnutls libgcrypt libidn libyaml
Git clone with --recursive
option.
➜ open5gs git clone --recursive https://github.com/{{ site.github_username }}/nextepc
To compile with autotools:
➜ open5gs cd nextepc
➜ nextepc git:(master) ✗ autoreconf -iv
➜ nextepc git:(master) ✗ ./configure --prefix=`pwd`/install
➜ nextepc git:(master) ✗ make -j `nproc`
Check whether the compilation is correct.
Note: This should require sudo due to access /dev/tun0
.
{: .notice--danger}
➜ nextepc git:(master) ✗ sudo make check
You need to perform the installation process.
➜ nextepc git:(master) ✗ make install
Check whether the installation is correct.
Note: This should require sudo due to access /dev/tun0
.
{: .notice--danger}
acetcom@nextepc:~/nextepc$ sudo ./test/testcomplex
s1setup_test : SUCCESS
attach_test : SUCCESS
volte_test : SUCCESS
handover_test : SUCCESS
All tests passed.
Tip: You can also check the result of ./test/testcomplex
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. testcomplex.pcapng({{ site.url }}{{ site.baseurl }}/assets/pcapng/testcomplex.pcapng)
{: .notice--info}
For developers, it provides nextepc-epcd
daemon that includes both MME, SGW, PGW, HSS, and PCRF.
Note: This should require sudo due to access /dev/tun0
.
{: .notice--danger}
acetcom@nextepc:~/nextepc$ sudo ./nextepc-epcd
04/06 23:13:03.367: [core] INFO: NextEPC daemon start (main.c:169)
PID[6404]: '/home/acetcom/Documents/git/open5gs/nextepc/install/var/run/nextepc-epcd/pid'
File Logging: '/home/acetcom/Documents/git/open5gs/nextepc/install/var/log/nextepc/nextepc.log'
MongoDB URI: 'mongodb://localhost/nextepc'
Configuration: '/home/acetcom/Documents/git/open5gs/nextepc/install/etc/nextepc/nextepc.conf'
04/06 23:13:03.369: [core] INFO: PCRF try to initialize (epc.c:37)
...
Building WebUI of NextEPC
Node.js is required to build WebUI of NextEPC
$ sudo pkg install node
Install the dependencies to run WebUI
➜ nextepc git:(master) ✗ cd webui
➜ webui git:(master) ✗ npm install
The WebUI runs as an npm script.
➜ webui git:(master) ✗ npm run dev