l2-nfapi-simulator/l2-nfapi-simulator-w-S1-same-machine.md

@@ -21,6 +21,9 @@
 5.   [Setup of the Configuration files](#5-setup-of-the-configuration-files)
      1.   [The eNB Configuration file](#51-the-enb-configuration-file)
      2.   [The UE Configuration file](#52-the-ue-configuration-file)
+6.   [Bring Up a second loopback interface](#6-bring-up-a-second-loopback-interface)
+7.   [Build the eNB](#7-build-the-enb)
+8.   [Build the UE](#8-build-the-ue)
 
 # 1. Environment #
 
@@ -112,6 +115,8 @@ You can repeat the operation for as many users you want to test with.
 
 # 5. Setup of the Configuration files #
 
+**CAUTION: both proposed configuration files resides in the ci-scripts realm. You can copy them but you CANNOT push any modification on these 2 files as part of an MR without informing the CI team.**
+
 ## 5.1. The eNB Configuration file ##
 
 ```bash
@@ -179,12 +184,13 @@ Last, the S1 interface shall be properly set.
         ENB_PORT_FOR_X2C                         = 36422; # Spec 36422
 
     };
+```
 
 ## 5.2. The UE Configuration file ##
 
 ```bash
 $ ssh sudousername@machineA
-$ cd enb_folder
+$ cd ue_folder
 # Edit ci-scripts/conf_files/ue.nfapi.conf with your preferred editor
 ```
 
@@ -206,3 +212,62 @@ L1s = (
 );
 ```
 
+# 6. Bring Up a second loopback interface #
+
+A second loopback interface is used to connect the eNB and the UEs.
+
+```bash
+$ ssh sudousername@machineA
+$ sudo ifconfig lo: 127.0.0.2 netmask 255.0.0.0 up
+```
+
+# 7. Build the eNB #
+
+Open a new terminal:
+
+```bash
+$ ssh sudousername@machineA
+$ cd enb_folder
+$ source oaienv
+$ cd cmake_targets
+# If you test less than 16 UEs, type below command.
+$ sudo -E ./build_oai --eNB -t ETHERNET -c
+# If you test more than 16 UEs, type below command and this command also can be used in case of less than 16 UEs.
+$ sudo -E ./build_oai --eNB -t ETHERNET -c --mu
+```
+
+# 8. Build the UE #
+
+Open a second terminal:
+
+```bash
+$ ssh sudousername@machineA
+$ cd ue_folder
+$ source oaienv
+$ cd cmake_targets
+# If you test less than 16 UEs, type below command.
+$ sudo -E ./build_oai --UE -t ETHERNET -c
+# If you test more than 16 UEs, type below command and this command also can be used in case of less than 16 UEs.
+$ sudo -E ./build_oai --UE  -x -t ETHERNET -c --musim
+```
+
+After finishing building UE(s), some files are generated in ue_folder/targets/bin/ and these files are necessary in cmake_targets.
+
+```bash
+$ ssh sudousername@machineA
+$ cd ue_folder/targets/bin/
+$ cp .u* ../../cmake_targets/
+$ cp usim ../../cmake_targets/
+$ cp nvram ../../cmake_targets/
+```
+
+# 9. Initialize the NAS UE Layer #
+
+In the 2nd terminal:
+
+```bash
+$ ssh sudousername@machineA
+$ cd ue_folder/cmake_targets/tools
+$ source init_nas_s1 UE
+```
+