vrr/open5gs
2
0
Fork 0
mirror of https://github.com/open5gs/open5gs.git synced 2026-04-30 12:29:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Rename Project to Open5GS

Browse source 
- Change BuildTool to Meson
 - Many BUGS Fixed
This commit is contained in:
Sukchan Lee 2019-10-27 17:41:14 +09:00
parent cb447af93a
commit 142763c280
919 changed files with 30459 additions and 6284 deletions
Download patch file Download diff file Expand all files Collapse all files

48
docs/_docs/platform/01-debian-ubuntu.md
View file

@ -2,26 +2,16 @@
title: Build on Ubuntu/Debian
---
### TUN device permissions
---
To run nextepc with least privilege, the TUN device privilege should be a `crw-rw-rw-`(666). Otherwise, you need to run nextepc daemon as root. If the permission is not `crw-rw-rw-`(666), you may need to install [udev](https://mirrors.edge.kernel.org/pub/linux/utils/kernel/hotplug/udev/udev.html) package.
### Using Meson
Install the depedencies for using Meson.
```bash
$ ls -al /dev/net/tun
crw-rw---- 1 root 28 10, 200 Feb 11 05:13 /dev/net/tun
$ sudo apt install udev
$ sudo systemctl start systemd-udevd (if '/lib/systemd/systemd-udevd' is not running)
$ ls -al /dev/net/tun
crw-rw-rw- 1 root 28 10, 200 Feb 11 05:13 /dev/net/tun
$ sudo apt install python3 python3-pip python3-setuptools python3-wheel ninja-build
```
Nevertheless, if the permission do not change, you can run nextepc with root privileges or change the permission using [chmod](https://www.gnu.org/software/coreutils/manual/html_node/chmod-invocation.html) as follows:
Install Meson using Python
```bash
$ sudo chmod 666 /dev/net/tun
$ pip3 install --user meson
```
### Making TUN Permanent
@ -29,21 +19,21 @@ $ sudo chmod 666 /dev/net/tun
Write a configuration file for the TUN deivce.
```bash
$ sudo sh -c "cat << EOF > /etc/systemd/network/99-nextepc.netdev
$ sudo sh -c "cat << EOF > /etc/systemd/network/99-open5gs.netdev
[NetDev]
Name=pgwtun
Name=ogstun
Kind=tun
EOF"
```
Create a TUN device. The interface name will be `pgwtun`.
Create a TUN device. The interface name will be `ogstun`.
```bash
$ sudo systemctl enable systemd-networkd
$ sudo systemctl restart systemd-networkd
$ sudo apt install net-tools
$ ifconfig pgwtun
pgwtun: flags=4241<UP,POINTOPOINT,NOARP,MULTICAST> mtu 1500
$ ifconfig ogstun
ogstun: flags=4241<UP,POINTOPOINT,NOARP,MULTICAST> mtu 1500
inet6 fe80::e86e:86d8:ea24:f8ee prefixlen 64 scopeid 0x20<link>
unspec 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 txqueuelen 500 (UNSPEC)
RX packets 0 bytes 0 (0.0 B)
@ -55,13 +45,13 @@ pgwtun: flags=4241<UP,POINTOPOINT,NOARP,MULTICAST> mtu 1500
Then, to support IPv6-enabled UEs, you must configure your TUN device to support IPv6.
```bash
$ sysctl -n net.ipv6.conf.pgwtun.disable_ipv6
$ sysctl -n net.ipv6.conf.ogstun.disable_ipv6
1
$ sudo sh -c "echo 'net.ipv6.conf.pgwtun.disable_ipv6=0' > /etc/sysctl.d/30-nextepc.conf"
$ sudo sysctl -p /etc/sysctl.d/30-nextepc.conf
$ sudo sh -c "echo 'net.ipv6.conf.ogstun.disable_ipv6=0' > /etc/sysctl.d/30-open5gs.conf"
$ sudo sysctl -p /etc/sysctl.d/30-open5gs.conf
$ sysctl -n net.ipv6.conf.pgwtun.disable_ipv6
$ sysctl -n net.ipv6.conf.ogstun.disable_ipv6
0
```
@ -72,9 +62,9 @@ $ sysctl -n net.ipv6.conf.pgwtun.disable_ipv6
You are now ready to set the IP address on TUN device.
```bash
$ sudo sh -c "cat << EOF > /etc/systemd/network/99-nextepc.network
$ sudo sh -c "cat << EOF > /etc/systemd/network/99-open5gs.network
[Match]
Name=pgwtun
Name=ogstun
[Network]
Address=45.45.0.1/16
Address=cafe::1/64
@ -91,8 +81,8 @@ Make sure it is set up properly.
```bash
$ ifconfig pgwtun
pgwtun: flags=4305<UP,POINTOPOINT,RUNNING,NOARP,MULTICAST> mtu 1500
$ ifconfig ogstun
ogstun: flags=4305<UP,POINTOPOINT,RUNNING,NOARP,MULTICAST> mtu 1500
inet 45.45.0.1 netmask 255.255.0.0 destination 45.45.0.1
inet6 cafe::1 prefixlen 64 scopeid 0x0<global>
inet6 fe80::e86e:86d8:ea24:f8ee prefixlen 64 scopeid 0x20<link>
@ -103,6 +93,6 @@ pgwtun: flags=4305<UP,POINTOPOINT,RUNNING,NOARP,MULTICAST> mtu 1500
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
```
**Note:** On *Linux*, you should run `nextepc-pgwd` first to correctly verify the IP address of TUN device. Otherwise, the TUN device's IP address is not displayed by the [ifconfig](http://net-tools.sourceforge.net/man/ifconfig.8.html) command.
**Note:** On *Linux*, you should run `open5gs-pgwd` first to correctly verify the IP address of TUN device. Otherwise, the TUN device's IP address is not displayed by the [ifconfig](http://net-tools.sourceforge.net/man/ifconfig.8.html) command.
{: .notice--warning}