Amarisoft

Installation - MBMSGW

 

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@CBC-2023010100 2025-06-13]# ./install.sh

Callbox Classic model found

Fedora 34 found

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

* Installing Amarisoft LTE 2025-06-13 (2025-07-03 12:44:18) *

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

 

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

      - 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) s72

      2) n2x0

      3) b2x0

      4) x3x0

      5) n3x0

      6) limeSDR

      7) limeMini

      8) sdr (default)

      9) ip

      > 8 (sdr)

      - 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] n

  * 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 Satellite utilities ? [yN] y

      - Do you want to start automatically ? [Yn] n

  * Do you want to install MBMS gateway ?

    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 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] y

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

2) Install LTE automatic service

3) Install Web interface

4) Install TRX sdr

5) Install EPC

  Configure IMS

  Migrate configuration files

    103 config file(s) imported

6) Install eNB

  Use TRX sdr

    [TRX] Callbox Classic model found

    [TRX] Fedora 34 found

    [TRX] Skipping BTF generation for /root/trx_sdr-linux-2025-06-13/kernel/sdr.ko due to unavailability of vmlinux

    [TRX] Unload current SDR kernel module

    [TRX] Initialize SDR kernel module

    [TRX] * Install kernel module

    [TRX] * Use mapping: 0 1

    [TRX] Devices: /dev/sdr0 /dev/sdr1

    [TRX] Check firmwares

    [TRX] SDR board utilities version 2025-05-16, Copyright (C) 2012-2025 Amarisoft

    [TRX] Upgrading all sdr devices

    [TRX] --------------------------------

    [TRX] sdr0 SDR50      sdr1 SDR50

    [TRX] UpToDate        UpToDate

    [TRX]

    [TRX] Total time: 2.0 s

  Migrate configuration files

    632 config file(s) imported

7) Install MBMS gateway

8) Install Satellite utilities

9) Install LTE monitoring

  Migrate configuration files

    No config file(s) imported

10) 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

    2 config file(s) imported

  Disable/stop service alsa-state

  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

 

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. You see the MBMSGW is added as a component.

# 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="2M" # Service log file size threshold for rotation

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

LOG_COUNT="2M" # Components log file count 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

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

# <COMP>_OUTPUT_FILE: store stdout/stderr in this file

# For more information, check https://tech-academy.amarisoft.com/lteots.doc

 

# List of components to start

COMPONENTS=""

 

# Start of section generated by installer

# Sat Jul  5 01:00:35 AM UTC 2025

 

# 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

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

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

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"

 

# MBMS gateway config  <== This integrates MBMSGW into screen window

COMPONENTS+=" MBMSGW"

MBMSGW_TYPE="MBMSGW"

MBMSGW_WIN="4"

MBMSGW_PATH="/root/mbms"

#MBMSGW_AUTOSTART="y"

MBMSGW_CONFIG_FILE="config/mbmsgw.cfg"

MBMSGW_INIT="-6"

 

# N3IWF config

COMPONENTS+=" N3IWF"

N3IWF_TYPE="N3IWF"

N3IWF_WIN="5"

N3IWF_PATH="/root/n3iwf"

#N3IWF_AUTOSTART="y"

N3IWF_INIT=""

N3IWF_CONFIG_FILE="config/n3iwf.cfg"

 

# Satellite utilities config

COMPONENTS+=" SAT"

SAT_TYPE="SAT"

SAT_WIN="10"

SAT_PATH="/root/sat"

SAT_AUTOSTART="n"

SAT_ARGS="-m"

SAT_CONFIG_FILE="config/sat-mc.cfg"

 

# LTE monitoring config

MONITOR_PATH="/root/monitor"

#MONITOR_AUTOSTART="y"

MONITOR_CONFIG_FILE="config/monitor.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.

If you see MBMSGW components at the bottom of the screen, it indicates the MBMSGW is properly installed.

Just for basic functionality check, go to MBMSGW screen by hitting Alt+A and 4. Then wait until you see the initial prints out as shown below (NOTE :  you may see only [XXXXXXX mbms]# prompt at the beginning and may need to wait for some time (e.g, 20~30 seconds) before you get the initial print-out)

Just very simple check, run 'help' command and see if you get any result. If you get the proper result with this, it is strong indication that MBMSGW is properly running.