free5gc / free5gc
- пятница, 29 мая 2020 г. в 00:25:04
Go
Open source 5G core network base on 3GPP R15
There are no gNB and UE for standalone 5GC available in the market yet.
Note: Please use Ubuntu 18.04 or later versions and go 1.12.9 linux/amd64
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 cardRequired 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-genericRequire go language
sudo rm -rf /usr/local/gowget https://dl.google.com/go/go1.12.9.linux-amd64.tar.gz
sudo tar -C /usr/local -zxvf go1.12.9.linux-amd64.tar.gzwget https://dl.google.com/go/go1.12.9.linux-amd64.tar.gz
sudo tar -C /usr/local -zxvf go1.12.9.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
echo 'export GO111MODULE=off' >> ~/.bashrc
source ~/.bashrcRequired packages for control plane
sudo apt -y update
sudo apt -y install mongodb wget git
sudo systemctl start mongodbRequired 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/logrusNetwork Setting
sudo sysctl -w net.ipv4.ip_forward=1
sudo iptables -t nat -A POSTROUTING -o ${DN_INTERFACE} -j MASQUERADEClone free5GC project in $GOPATH/src
cd $GOPATH/src
git clone https://github.com/free5gc/free5gc.git
cd free5gc
git checkout v3.0.2
git submodule sync
git submodule update --init --jobs `nproc`(Optional) If you want to use the nightly version, runs:
cd $GOPATH/src/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`Run the script to install dependent packages
cd $GOPATH/src/free5gc
chmod +x ./install_env.sh
./install_env.sh
Please ignore error messages during the package dependencies installation process.In step 2, the folder name should remain free5gc. Please do not modify it or the compilation would fail.
Compile network function services in $GOPATH/src/free5gc individually, e.g. AMF (redo this step for each NF), or
cd $GOPATH/src/free5gc
go build -o bin/amf -x src/amf/amf.goTo build all network functions in one command
./build.shPlease check Linux kernel version if it is 5.0.0-23-generic
uname -rGet Linux kernel module 5G GTP-U
git clone https://github.com/PrinzOwO/gtp5g.git
cd gtp5g
make
sudo make installBuild from sources
cd $GOPATH/src/free5gc/src/upf
mkdir build
cd build
cmake ..
make -j`nproc`Note: Config is located at $GOPATH/src/free5gc/src/upf/build/config/upfcfg.yaml
Option 1. Run network function service individually, e.g. AMF (redo this for each NF), or
cd $GOPATH/src/free5gc
./bin/amfNote: For N3IWF needs specific configuration in section B
Option 2. Run whole core network with command
./run.sh
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 upRun N3IWF (root privilege is required):
cd $GOPATH/src/free5gc/
sudo ./bin/n3iwfStart Wireshark to capture any interface with pfcp||icmp||gtp filter and run the tests below to simulate the procedures:
cd $GOPATH/src/free5gc
chmod +x ./test.sha. TestRegistration
(In directory: $GOPATH/src/free5gc)
./test.sh TestRegistrationb. TestServiceRequest
./test.sh TestServiceRequestc. TestXnHandover
./test.sh TestXnHandoverd. TestDeregistration
./test.sh TestDeregistratione. TestPDUSessionReleaseRequest
./test.sh TestPDUSessionReleaseRequestf. TestPaging
./test.sh TestPaging
g. TestN2Handover
./test.sh TestN2Handover
h. TestNon3GPP
./test.sh TestNon3GPPi. TestULCL
./test_ulcl.sh -om 3 TestRegistrationFor more details, you can reference to our wiki
Global
AMF
SMF
UPF
PCF