Table of Contents

• Hardware Tested
• Questions
• Recommended Environment
• Installation
  • A. Pre-requisite
  • B. Install Control Plane Entities
  • C. Install User Plane Function (UPF)
• Run
  • A. Run Core Network
  • B. Run N3IWF (Individually)
  • C. Run all in one with outside RAN
  • D. Deploy with container
• Test
• Release Note

Hardware Tested

There are no gNB and UE for standalone 5GC available in the market yet.

Questions

For questions and support please use the official forum. The issue list of this repo is exclusively for bug reports and feature requests.

Recommended Environment

• Software
  • OS: Ubuntu 18.04
  • gcc 7.3.0
  • Go 1.14.4 linux/amd64
  • kernel version 5.0.0-23-generic (MUST for UPF)

Note: Please use Ubuntu 18.04 and kernel version 5.0.0-23-generic

You can use go version to check your current Go version.

- Hardware
    - CPU: Intel i5 processor
    - RAM: 4GB
    - Hard drive: 160G
    - NIC card: 1Gbps ethernet card

- Hardware recommended
    - CPU: Intel i7 processor
    - RAM: 8GB
    - Hard drive: 160G
    - NIC card: 10Gbps ethernet card

Installation

A. Pre-requisite

0. Required kernel version 5.0.0-23-generic. This request is from the module gtp5g that we has used. Any more details please check here

   # Check kernel version
   $ uname -r
   5.0.0-23-generic

1. Require go language

   • If another version of Go is installed
     • Please remove the previous Go version
       • sudo rm -rf /usr/local/go
     • Install Go 1.14.4

       wget https://dl.google.com/go/go1.14.4.linux-amd64.tar.gz
       sudo tar -C /usr/local -zxvf go1.14.4.linux-amd64.tar.gz

   • Clean installation
     • Install Go 1.14.4

       wget https://dl.google.com/go/go1.14.4.linux-amd64.tar.gz
       sudo tar -C /usr/local -zxvf go1.14.4.linux-amd64.tar.gz
       mkdir -p ~/go/{bin,pkg,src}
       echo 'export GOPATH=$HOME/go' >> ~/.bashrc
       echo 'export GOROOT=/usr/local/go' >> ~/.bashrc
       echo 'export PATH=$PATH:$GOPATH/bin:$GOROOT/bin' >> ~/.bashrc
       source ~/.bashrc

2. Required packages for control plane

   sudo apt -y update
   sudo apt -y install mongodb wget git
   sudo systemctl start mongodb

3. Required packages for user plane

   sudo apt -y update
   sudo apt -y install git gcc cmake autoconf libtool pkg-config libmnl-dev libyaml-dev
   go get -u github.com/sirupsen/logrus

4. Network Setting

   sudo sysctl -w net.ipv4.ip_forward=1
   sudo iptables -t nat -A POSTROUTING -o <dn_interface> -j MASQUERADE
   sudo systemctl stop ufw

B. Install Control Plane Entities

1. Clone free5GC project

   cd ~
   git clone --recursive -b v3.0.4 -j `nproc` https://github.com/free5gc/free5gc.git
   cd free5gc

   (Optional) If you want to use the nightly version, runs:

   cd ~/free5gc
   git checkout master
   git submodule sync
   git submodule update --init --jobs `nproc`
   git submodule foreach git checkout master
   git submodule foreach git pull --jobs `nproc`

2. Run the script to install dependent packages

   cd ~/free5gc
   go mod download

   In step 2, the folder name should remain free5gc. Please do not modify it or the compilation would fail.

3. Compile network function services in free5gc individually, e.g. AMF (redo this step for each NF), or

   cd ~/free5gc
   make amf

   To build all network functions in one command

   cd ~/free5gc
   make all

C. Install User Plane Function (UPF)

1. Please check Linux kernel version if it is 5.0.0-23-generic

   uname -r

   Get Linux kernel module 5G GTP-U

   git clone -b v0.2.0 https://github.com/PrinzOwO/gtp5g.git
   cd gtp5g
   make
   sudo make install

2. Build from sources (skip this step if you run make all previously) via make, or

   cd ~/free5gc
   make upf

   build manually

   cd ~/free5gc/src/upf
   mkdir build
   cd build
   cmake ..
   make -j`nproc`

Note: UPF's config is located at free5gc/src/upf/build/config/upfcfg.yaml

Run

A. Run Core Network

Option 1. Run network function service individually, e.g. AMF (redo this for each NF), or

cd ~/free5gc
./bin/amf

Note: For N3IWF needs specific configuration in section B

Option 2. Run whole core network with command

./run.sh

B. Run N3IWF (Individually)

To run N3IWF, make sure the machine is equipped with three network interfaces. (one is for connecting AMF, another is for connecting UPF, the other is for IKE daemon)

We need to configure each interface with a suitable IP address.

We have to create an interface for IPSec traffic:

# replace <...> to suitable value
sudo ip link add ipsec0 type vti local <IKEBindAddress> remote 0.0.0.0 key <IPSecInterfaceMark>

Assign an address to this interface, then bring it up:

# replace <...> to suitable value
sudo ip address add <IPSecInterfaceAddress/CIDRPrefix> dev ipsec0
sudo ip link set dev ipsec0 up

Run N3IWF (root privilege is required):

cd ~/free5gc/
sudo ./bin/n3iwf

C. Run all in one with outside RAN

Reference to sample config if need to connect the outside RAN with all in one free5GC core network.

D. Deploy with container

Reference to free5gc-compose as the sample for container deployment.

Test

Start Wireshark to capture any interface with pfcp||icmp||gtp filter and run the tests below to simulate the procedures:

cd ~/free5gc
chmod +x ./test.sh

a. TestRegistration

(In directory: ~/free5gc)
./test.sh TestRegistration

b. TestGUTIRegistration

./test.sh TestGUTIRegistration

c. TestServiceRequest

./test.sh TestServiceRequest

d. TestXnHandover

./test.sh TestXnHandover

e. TestDeregistration

./test.sh TestDeregistration

f. TestPDUSessionReleaseRequest

./test.sh TestPDUSessionReleaseRequest

g. TestPaging

./test.sh TestPaging

h. TestN2Handover

./test.sh TestN2Handover

i. TestNon3GPP

./test.sh TestNon3GPP

j. TestReSynchronisation

./test.sh TestReSynchronisation

k. TestULCL

./test_ulcl.sh -om 3 TestRegistration

For more details, you can reference to our wiki

Release Note

Detailed changes for each release are documented in the release notes.