@@ -4,15 +4,17 @@ In this tutorial, we will describe how to connect a commercial off-the-self UE (
...
@@ -4,15 +4,17 @@ In this tutorial, we will describe how to connect a commercial off-the-self UE (
* the OAI eNB functionality is extented so that OAI eNB is able to interface via Ethernet a RRH
* the OAI eNB functionality is extented so that OAI eNB is able to interface via Ethernet a RRH
* a new software entity is introduced, namely the OAI RRH GW which acts as an abstraction between radio front end equipment (e.g. USRPB210, BLADERF and LMSSDR) and the OAI eNB
* a new software entity is introduced, namely the OAI RRH GW which acts as an abstraction between radio front end equipment (e.g. USRPB210, BLADERF and LMSSDR) and the OAI eNB
The present tutorial describes how to deploy and run OAI EPC, OAI eNB and OAI RRH GW on different hosts.
The present tutorial describes how to deploy and run OAI EPC, OAI eNB and OAI RRH GW on different hosts as depicted in the following figure:
At this point, we have to note that the OAI RRH GW in its simplest form is defaulted to a single RRH which in this tutorial is a USRP-B210-based RRH.
At this point, we have to note that the OAI RRH GW in its simplest form is defaulted to a single RRH which in this tutorial is a USRP-B210-based RRH.
The entire procedure is divided into the following stages:
The entire procedure is divided into the following stages:
1. Install and configure OAI EPC and HSS on a host. At the end of this stage, EPC should be able to connect to HSS.
1. Install and configure OAI EPC and HSS on a host. At the end of this stage, EPC should be able to connect to HSS.
2. Install and configure OAI RRH GW on a host. At the end of this stage, RRH GW should be an up and running server waiting for incoming eNB connections.
2. Install and configure OAI RRH GW on a host. At the end of this stage, RRH GW should be an up and running server waiting for incoming eNB connections.
3. Install and configure OAI eNB on a host. At the end of this stage, eNB should be able to initially be connected to the EPC+HSS and later on initiate a connection with the RRH GW.
3. Install and configure OAI eNB on a host. At the end of this stage, eNB should be able to firstly be connected to the EPC+HSS and later on initiate a connection with the RRH GW.
4. Configure UE (e.g., smartphone service mode, USIM card) and register the user on HSS database. At the end of this stage, UE should be able to attach and connect to eNB.
4. Configure UE (e.g., smartphone service mode, USIM card) and register the user on HSS database. At the end of this stage, UE should be able to attach and connect to eNB.
5. Configure networking settings between eNB and UE. At the end of this stage, they should be able to ping each other and `iperf` can be run to test the throughput.
Checklist prior to OAI installation:
Checklist prior to OAI installation:
...
@@ -39,7 +41,7 @@ First, we will download source codes from the link below as an example. See [Get
...
@@ -39,7 +41,7 @@ First, we will download source codes from the link below as an example. See [Get
We assume that you have following directory:
We assume that you have following directory:
*openair-cn : The location of openair-cn git repository
openair-cn : The location of openair-cn git repository
"labuser.111.111" is a sample FQDN, where "labuser" is your hostname, and "111.111" is your realm. You can replace "111.111" with other combination.
"labuser.111.111" is a sample FQDN, where "labuser" is your hostname, and "111.111" is your realm. You can replace "111.111" with other combination.
#### Step 3: Run automated script for openair-cn
#### Step 3: Run automated scripts for openair-cn
```shell
```shell
./build_epc -i#(Need to run only once to install missing packages)
./build_epc -i#(Need to run only once to install missing packages)
./build_hss -i#(Need to run only once to install missing packages)
./build_hss -i#(Need to run only once to install missing packages)
```
```
During the building process, you will be asked to set the password for MySQL "root" user. You are recommended to use "linux", since this is the default password used by OAI; otherwise, you will have to edit some configuration file so that HSS is able to access MySQL database.
The detailed instructions for EPC are located in: **YOUR_openair-cn_DIRECTORY/DOCS/EPC_User_Guide.pdf**
The detailed instructions for EPC are located in: **YOUR_openair-cn_DIRECTORY/DOCS/EPC_User_Guide.pdf**
Look at [AutoBuild](AutoBuild) for more details.
Look at [AutoBuild](AutoBuild) for more details.
### 1.2 Configuration
### 1.2 Configuration and execution
#### 1.2.1 eNB and EPC+HSS on different hosts
#### Step 1: Edit the EPC configuration file: `~/openair-cn/BUILD/EPC/epc.conf.in`
Next, we explain the setup for running eNB and EPC+HSS on two different hosts. Assume the IP addresses of eNB and EPC+HSS are 192.168.100.102 and 192.168.100.103. Figure 2 is an example which specifies the network topology.
Next, we explain the setup for running eNB and EPC+HSS on two different hosts. Assume the IP addresses of eNB and EPC+HSS are 192.168.100.102 and 192.168.100.103. Figure 2 is an example which specifies the network topology.
Figure 2. eNB, EPC (MME+S/PGW) and HSS on different hosts.
Then, make sure the networking parameters are properly specified in eNB and EPC configuraiton files. In eNB configuration file (`~/openairinterface5g/targets/PROJECT/GENERIC-LTE-EPC/CONF/enb.band7.tm1.usrpb210.epc.remote.conf`),
During the building process, you will be asked to set the password for MySQL "root" user. You are recommended to use "linux", since this is the default password used by OAI; otherwise, you will have to edit some configuration file so that HSS is able to access MySQL database.
You can print out the help message to see what these options mean using the command "./build_oai -h". A short summary is as follows.
You can print out the help message to see what these options mean using the command "./build_oai -h". A short summary is as follows.
* -I: installs required packages.
* -I: installs required packages.
...
@@ -262,9 +235,37 @@ __Notes:__
...
@@ -262,9 +235,37 @@ __Notes:__
Look at [AutoBuild](AutoBuild) for more details.
Look at [AutoBuild](AutoBuild) for more details.
### 3.2 Configuration
### 3.2 Configuration and execution
#### Step 1: Edit the eNB configuration file (`~/openairinterface5g/targets/PROJECT/GENERIC-LTE-EPC/CONF/enb.band7.tm1.usrpb210.epc.remote.conf`),
where mme_ip_address is network interface's IP address of your EPC/HSS, and NETWORK_INTERFACE is your eNB related network interface information.
#### Step 2: Run eNB
##### Compile & Run eNB:
##### Compile & Run eNB:
...
@@ -340,7 +341,7 @@ Save the apn profile and then select it.
...
@@ -340,7 +341,7 @@ Save the apn profile and then select it.
For this LTE Dongle you don't have to give at commands in order to configure it but you can do it from the graphical interface that it is on the url 192.168.8.1. You have to go to Profile Management and add a new APN profile (see the picture below)
For this LTE Dongle you don't have to give at commands in order to configure it but you can do it from the graphical interface that it is on the url 192.168.8.1. You have to go to Profile Management and add a new APN profile (see the picture below)
