Amarisoft

Installation - Callbox/UEsim trx over ip

 

The purpose of this tutorial is to show you how to install Callbox and UEsim software on a single PC with trx ip mode. This mode allows you to use Callbox and UEsim on a single PC without using any SDR card. In this mode, Callbox and UEsim communicate over IP instead of SDR cards.

NOTE :  This option may require a specific license and it is recommended to consult to sales@amarisoft.com for the license.

NOTE :  Overall installation procedure is almost same as regular Callbox software installation or UEsim software installation. The only differences are with some of the options you need to take during the installation process.

 

Table of Contents

 

 

Download the New Release

The trx ip functionality does not require any special software, it is included in the regular installation package. So you can download the installation package (Tarball) from Amarisoft Extranet account as you download your regular installation package as shown below.

Install Callbox Download 01

You can place the downloaded package anywhere you like. In this tutorial, I put it in /root directory as shown below.

NOTE : you may put the file into /tmp if you like, but be aware that the contents of /tmp will be deleted when you power cycle the PC.

Install Callbox Download 02

NOTE :  The contents (components) contained within the downloaded tarball varies with the license options registerred in the extranet download site.

 

Install

Untar the package as shown below

Install Callbox Install 01

You will get the untared directory as shown below. You will see all the software packages for installation in this directory.

Install Callbox Install 02

Go to the untarred directory and list the files in it. You will see the installation shell program and other files required for installation (In this specific case shown above, go do the directory '2021-11-19' to get the contents as shown below.)

NOTE :  The contents (components) contained within this directory would vary with the license options registerred in the extranet download site.

Install Callbox Install 03

Go through the installation procedure as shown below.

[root@jaeku-laptop 2024-03-21]# ./install.sh

Fedora 34 found

*************************************************************

* Installing Amarisoft LTE 2024-03-21 (2024-03-31 17:05:14) *

*************************************************************

 

1) Configuration

  You can exit install script during this step, nothing will be changed

  until next step

  * Do you want to install LTE automatic service ?

    Package screen may be installed. [Yn] y <== Install LTE service

      - Do you want to migrate your config files from current running version ? [Yn] y

      - Do you want to enable LTE automatic service ? [Yn] y

      - Do you want to use NAT for IPv4 ? [Yn] y

      - Do you want to use IPv6 ? [Yn] y

      - Do you want to use NAT for IPv6 ? [Yn] y

      - Do you want to turn hyperthreading off (we strongly recommand it) ? [Yn] y

  * Do you want to install EPC ?

    Package lksctp-tools may be installed. [Yn] y

      - Do you want to migrate your config files from current running version ? [Yn] y

      - Do you want to install IMS ? [Yn] y

  * Do you want to install eNB ?

    Package lksctp-tools may be installed. [Yn] y

      - Do you want to migrate your config files from current running version ? [Yn] y

    - Select TRX radio frontend:

      1) ip

      2) sdr

      3) n2x0

      4) b2x0

      5) x3x0

      6) n3x0

      7) limeSDR

      8) limeMini

      9) s72

      a) example

      > 1 (ip) <== This is a key point. This indicates that you are installing eNB/gNB with trx ip mode

      - Do you want to use MIMO ? [Yn] y

  * Do you want to install N3IWF ?

    Package lksctp-tools may be installed. [yN] n

  * Do you want to install UE simulator ? [Yn] y <== This is another keypoint. Here you are installing UEsim as well in addition to eNB

      - Do you want to migrate your config files from current running version ? [Yn] y

    - Select TRX radio frontend:

      1) ip

      2) sdr

      3) n2x0

      4) b2x0

      5) x3x0

      6) n3x0

      7) limeSDR

      8) limeMini

      9) s72

      a) example

      > 1 (ip) <== This is a key point. This indicates that you are installing UEsim with trx ip mode

      - Do you want to start automatically ? [yN] y

  * Do you want to install Spectrum viewer ? [yN] n

  * Do you want to install LTE probe ? [yN] n

  * Do you want to install LTE scanner ? [yN] n

  * Do you want to install MBMS gateway ?

    Package lksctp-tools may be installed. [yN] n

  * Do you want to install Web interface ?

    Package apache php may be installed.

    and enable your web server. [Yn] y

  * Do you want to install license server ? [yN] n

  * Do you want to install LTE monitoring ?

    Package nodejs ssmtp may be installed. [yN] n

2) Install LTE automatic service

3) Install Web interface

4) Install TRX ip

5) Install EPC

  Configure IMS

  Migrate configuration files

    3 config file(s) imported

6) Install eNB

  Use TRX ip

  Migrate configuration files

    11 config file(s) imported

7) Install UE simulator

  Use TRX ip

  Migrate configuration files

    4 config file(s) imported

8) Finalize LTE automatic service

  Migrate configuration files

    Warning, reference config file ots.default.cfg was modified

      It has been imported as ots.default.cfg.bak, you may report your changes manually

    Warning, ots.default.cfg.bak config file conflicts with new release

      It won't be imported, you may report your changes manually

    No config file(s) imported

  Start service

 

***************************

* Installation successful *

***************************

 

Directory Structure of Installed Release

This is just to check up the result of installation. If you check up the file list in the installation directory (/root) you can see enb/mme/ue/ots/trx_ip directories.

Install Callbox and UEsim trx_ip DirectoryStructure 01

If you go into /root/enb/config, you would see rf_driver directory is mapped to the directory ip.

Install Callbox and UEsim trx_ip DirectoryStructure 02

If you go into the directory 'ip', there is a config.cfg file that is mapping the rf driver to ip. (The details of the config.cfg will be explained in another tutorial)

Install Callbox and UEsim trx_ip DirectoryStructure 03

If you go into /root/ue, you would see rf_driver directory is mapped to the directory ip.

Install Callbox and UEsim trx_ip DirectoryStructure 04

If you go into /root/ue/config,  there is a config.cfg file that is mapping the rf driver to ip. (The details of the config.cfg will be explained in another tutorial)

Install Callbox and UEsim trx_ip DirectoryStructure 05

 

Contents of ots Config

This is just for a reference. Usually you may not need to check on this. You may want to check on this only when screen mode (i.e, the user interface with 'screen -r') does not behave as expected.

Install Callbox and UEsim trx_ip ots config

The contents of the file is as follows.

# General

ERROR_DELAY="5"    # Component restart time in case of error (in seconds)

#AMARISOFT_PATH=""  # Change license file location

#HOSTNAME="My name" # Use this to override system hostname (| are forbidden)

 

# Logs

LOG_FILE="ots.log"

LOG_FILE_SIZE="1M" # Service log file size threshold for rotation

LOG_SIZE="250M" # Components log file size threshold for rotation

LOG_PATH="/var/log/lte/" # Log rotation target path

LOG_PERSISTENT_SIZE="5G" # Maximum size of logs to store in LOG_PATH (if no unit KBytes assumed)

LOG_PERSISTENT_COUNT="2000" # Maximum number of log file to keep in LOG_PATH

LOG_GZIP="0" # Set to positive value to compress logs in LOG_PATH

LOG_POLL_DELAY="10"

LOG_BACKUP_ON_STOP="y" # Set it to n to avoid log backup (to LOG_PATH) on component stop

 

 

# Component configuration

# <COMP> is component ID and must be unique

#

# <COMP>_TYPE: component type (LICENSE MME ENB IMS MBMSGW UE...)

# <COMP>_TITLE: display name

# <COMP>_PATH: Component path. Set it to empty string to disable component

# <COMP>_INIT: arguments for lte_init.sh script

# <COMP>_WIN: Component screen window # (must be unique)

# <COMP>_CONFIG_FILE: config file used by component

# <COMP>_OUTPUT_FILE: define it to dump stdout/stderr to a file

# <COMP>_AUTOSTART: defines if component must be started by service (default is y)

# <COMP>_SCRIPT: defines shell script that will be executed on each component state change

#                Arguments are <COMP> <STATE> [<ERROR>] where state can be:

#                - starting: before executing component binary

#                - started: after component binary has started

#                - error: when any error occurred (In this case the third argument will be filed with error message)

#                - stop: after successful component stop

#                This can be used to perform any action before component start by using the state starting

#                Note that the script is executed synchronously and may delay or block component startup

# <COMP>_START_DELAY: time to wait in seconds before starting component

 

# List of components to start

COMPONENTS=""

 

# Start of section generated by installer

# Wed Apr  3 07:06:32 AM UTC 2024

 

# LTE automatic service config

OTS_PATH="/root/ots"

#OTS_AUTOSTART="y"

#OTS_ADDRESS="" # Set it to force WS address of components from GUI

WWW_PATH="/var/www/html/lte/"

 

# EPC config <=  This is for adding MME to the screen menu :  [0 MME]  1 ENB  2 UE  3 IMS

COMPONENTS+=" MME"

MME_TYPE="MME"

MME_WIN="0"

MME_PATH="/root/mme"

#MME_AUTOSTART="y"

MME_INIT=" -6"

MME_CONFIG_FILE="config/mme.cfg"

 

# IMS config <=  This is for adding IMS to the screen menu :  0 MME  1 ENB  2 UE  [3 IMS]

COMPONENTS+=" IMS"

IMS_TYPE="IMS"

IMS_WIN="3"

IMS_PATH="/root/mme"

#IMS_AUTOSTART="y"

IMS_DEP="MME"

IMS_CONFIG_FILE="config/ims.cfg"

 

# eNB config <=  This is for adding ENB to the screen menu :  0 MME  [1 ENB]  2 UE  3 IMS

COMPONENTS+=" ENB"

ENB_TYPE="ENB"

ENB_WIN="1"

ENB_PATH="/root/enb"

#ENB_AUTOSTART="y"

ENB_INIT=""

ENB_RRH_CHECK="config/rf_driver/rrh_check.sh"

ENB_CONFIG_FILE="config/enb.cfg"

 

# UE simulator config <= This is for adding UE to the screen menu :  0 MME  1 ENB  [2 UE]  3 IMS

COMPONENTS+=" UE"

UE_TYPE="UE"

UE_WIN="2"

UE_PATH="/root/ue"

UE_AUTOSTART="y"

UE_INIT=""

UE_RRH_CHECK="config/rf_driver/rrh_check.sh"

UE_SCRIPT="config/ots-script.sh"

UE_CONFIG_FILE="config/ue.cfg"

 

# System configuration

HT_STATE="off"

 

# End of section generated by installer

 

Checkup Software Run

Once every check up is done, run 'service lte restart' and 'screen -r' just to make it sure the installed software is running without any error.