OAI Install

Installing EPC:

Prerequisites:

One ethernet connection to internet

One ethernet connection to eNB machine. EPC must have IP:192.168.12.62


Virtual Machine Settings:

OS: Ubuntu 18.04.3

Processor: 4 CPUs

RAM: 8GB

Network:

Adapter 1(enp3s0): Bridged Adapter, (whatever connection is going to the internet)

Adapter 4(enp10s0): Bridged Adapter, (whatever connection is going to the eNB machine)


In the network settings within the VM, set IP of the wired connection corresponding to the eNB to 192.168.12.62


All of the following instructions refer to the Guest OS:

Specify FQDN

The text should read the following:

Install git and clone OAI CN Repos

Install Cassandra


Make the following modifications to openair-cn/build/tools/build_helper.cassandra:

Replace: $SUDO $INSTALLER install $OPTION curl oracle-java8-installer

With: $SUDO $INSTALLER install $OPTION curl openjdk-8-jre

Replace: curl https://www.apache.org/dist/cassandra/KEYS | $SUDO apt-key add -

With: curl https://downloads.apache.org/cassandra/KEYS | $SUDO apt-key add -

Stop Cassandra and Prepare for Configuration

Configure and Restart Cassandra


Open /etc/cassandra/cassandra.yaml.

Change the cluster name to “HSS Cluster”

Ensure seeds = “127.0.0.1”

Ensure listen_address = localhost

Ensure rpc_address = localhost

Change endpoint_snitch = GossipingPropertyFileSnitch

Build and Install HSS

Add Users

Add MME

Build and Install MME

Install FMT Library

Install SPGW

Get Certificates

Copy Configuration Files

Set up interfaces for SPGW & MME

Install spdlog

Configuration Files

This is the link to the config files that have run successfully.

https://drive.google.com/file/d/1NjlWduzdtIcMaAy0RJpCc5FCEYDNZ0wI/view?usp=sharing


Running EPC:


In 4 different terminal windows, run the following commands:


Installing eNB:


Prerequisites:

One ethernet connection to internet

One ethernet connection to EPC machine. eNB must have IP:192.168.12.82


We currently recommend running the OAI eNB on bare metal due to complications with use in a virtual machine.


Clone OAI Repo

Select Branch

Build OAI


If you already have a UHD version installed, you will build OAI and link it to the installed UHD version

If you do not have a UHD version installed, you will need to build a UHD version supplied by OAI

Modify Config Files


You will want to modify the config file associated with the profile you wish to run. In this case we will use enb.band7.tm1.25PRB.usrpb210.conf


Make the following changes, using the interface details that is connected to the EPC:

mnc=92 mnc=93

downlink_frequency = 2680000000L; downlink_frequency = 2685000000L;

mme_ip_address = ( { ipv4 = "CI_MME_IP_ADDR"; mme_ip_address = ( { ipv4 = "192.168.12.62";

ENB_IPV4_ADDRESS_FOR_S1_MME = "CI_ENB_IP_ADDR"; ENB_IPV4_ADDRESS_FOR_S1_MME = "192.168.12.82";

ENB_INTERFACE_NAME_FOR_S1U = "eth0"; ENB_INTERFACE_NAME_FOR_S1U = "[interface name]";

ENB_IPV4_ADDRESS_FOR_S1U = "CI_ENB_IP_ADDR"; ENB_IPV4_ADDRESS_FOR_S1U = "192.168.12.82";

ENB_IPV4_ADDRESS_FOR_X2C = "CI_ENB_IP_ADDR"; ENB_IPV4_ADDRESS_FOR_X2C = "192.168.12.82";


If using a network (N or X-series) USRP, add the following line as shown, adding information specific to hardware being used:


max_rxgain = 125;

eNB_instances = [0];

+ sdr_addrs = "type=[x300 or n300],addr=[ip of radio]";


Run OAI eNB

If both the EPC and eNB are running properly, you should see the MME on the EPC system acknowledge the connection to the eNB.


[Pictures to come]