Amarisoft

LTE Web Interface
version 2025-11-19*
This document is based on the latest test release.
Features may not be present in your current installed software. You may check their availability in change history or in your release documentation.
If you require an up to date release, ask for it in a ticket.

Table of Contents

1 Introduction

LTE Web Interface is a HTML5 graphical user interface.
It allows to analyze Amarisoft LTE software logs and get information from the system.
It can communicates using WebSocket for real time analysis.
It also interact with LTE UE simulator to generate and execute scenario.

Using node webkit, it is possible to use it as a standalone application and associate it with your log files in your file browser.

2 Features

3 Requirements

3.1 Software requirements

3.1.1 Web server mode

Mandatory:

Optional:

3.1.2 Standalone mode

Node Webkit must be installed on your system.

4 Installation

4.1 Web server mode

4.1.1 Server side

Simply copy all file to a HTTP server directory.

For apache:

cp -r <directory> /var/www/html/lte

4.1.2 Client

Use your HTTP server URL.

For apache, http://<server name>/lte/

4.1.3 Troubleshoot

If you are not familiar with Linux and web servers, you may need to look on the web for information on how to setup a web server correctly (Depending on your Linux flavour, there are too many possible environment, which is out of the scope of this document).

However, if you use Apache with Fedora, here are the common things you can try:

4.2 Standalone mode

You may use the GUI as a standalone application.
For this, you need Node WebKit to be installed on your machine.

4.2.1 Linux

To install it on Fedora:

sudo dnf install nodejs npm
sudo npm install -g nw --unsafe-perm=true

Then, copy directory wherever you want, and you can use it this way:

<directory>./logview.sh <file1.log> <file2.log> ...

4.2.2 Windows

On windows, follow https://nwjs.io/ to download archive.
Extract it to <nw-dir>.

You may place it to c:\Program Files\nwjs

If you want to place it elsewhere, you will have to edit logview.bat to change path

To open application, you just need to double click on logview.bat file.
You may open it with log file as command line argument.

4.2.3 Wireshark

If wireshark is installed on your system, you will benefit advanced logs for different layers.

On windows system, you may update tshark path by editing TSHARK_WIN32 or TSHARK_LINUX variables in client.js according to your system.

4.3 GUI definition

The GUI is divided into several panels.

img/gui_ltewww_def

5 Manage your clients

To display log and/or interact with Amarisoft software, you need to add a client.
The list of your client is displayed on left panel of the interface.

5.1 Log files

You can display logs generated by an Amarisoft LTE software by clicking on Load file button in client panel and selecting the log file.

A entry will be added on client panel and logs will be parsed and displayed on log panel.

img/gui_ltewww_client

The green tick img/ok means the client is enabled and logs are displayed.
When selecting a client, a list of actions will be available on the top toolbar (See Client action).

5.2 WebSocket

To create a WebSocket client, you first need to enable remote API on Amarisoft software component (MME, eNB, IMS, UE Simulator).
This is done via com_addr parameter. Please refer to the component documentation for more detail.

Then click on Add server button:

img/gui_ltewww_server

Enter name that will appear on client panel and the address you entered as com_addr.

After clicking on update button, the client will try to connect.
If connection is successful, the configuration window will appear so that you configure logs:

img/gui_ltewww_server2

For each layer you can define:

Of course, you can keep default configuration and simply click on Update.

The img/lightning_red icon means the client is not connected whereas img/lightning means the client is connecting and img/lightning_green means the client is connected.

When connected, a new tab will appear in main tab panel and provide you advanced features.

5.3 URL

You can retrieve a log from any URL with this client.
Click on URL button and enter parameters.

The img/lightning_red icon means the log file was not loaded whereas img/lightning_green means it has been successfully parsed.

5.4 Client action

Here are the action you can perform on a client

5.5 Server store

You can store your log files on the Web Server to access it through the interface.
You need to put your log files in store directory on the server.
NB: Subdirectories are allowed.

Then expand the store node in client panel, and you’ll have access to all the files.
Select them and click on enable button (or double click) to display logs.

Note that your HTTP server requires php support.

5.6 Configure your clients

You can change the configuration of URL and WebSocket clients.
Select client line click on configuration button.
Update config as wanted and click on Update button.

6 Log display

6.1 Introduction

When a client is enabled, logs appear on log panel.
You can enable multiple client together to mix logs. This may be useful to mix MME, eNB, IMS and/or UE logs.

img/gui_ltewww_logs

Each line represent a log.

Columns are:

6.2 Navigating

When a log line is selected, use img/left and img/right buttons to highlight previous or next log of same layer:

img/gui_ltewww_nav

Fill search field to search in messages, ID, info and details. Use img/left and img/right buttons to highlight previous or next match:

img/gui_ltewww_search

6.3 Filtering

TBD

6.4 Display physical layer statistics

If your logs have physical layer included, you can display statistics.
Click on Analytics button to open window.

img/gui_ltewww_analytics

On left, you will have the list of radio connections.
You can select one or several by maintaining shift key.

It will display statistics in charts.
Average time parameter allow smoothing curves.

6.5 Display resource block allocation

If your logs have physical layer included, you can display ressource block allocation by clicking img/comp button:

img/gui_ltewww_rb

Use mouse wheel to scale.
Drag and drop to move inside allocations.
Hashed block are not acknowledged packet.
You can select allocated blocks, this will also select associated log in log panel.

6.6 Display constellation and channel response time

If your logs have physical layer included with signal level activated (phy.signal=1), you can display the QAM constellation and the channel response time.
You should take a look at PHY layer logs. When a yellow star is diplayed, click on it and a bottom panel should appear.

img/gui_ltewww_const

6.7 Miscellaneous

6.7.1 Time origin

This field allow logs time to be relative to it.
You can set it manually or by right clicking on a log line and selecting Set time origin

6.7.2 Pause log update

You can click on img/pause to pause log update.
This may be useful when a WebSocket client is constantly adding logs.

7 Change history

7.1 Version 2025-03-14

7.2 Version 2024-12-13

7.3 Version 2024-09-13

7.4 Version 2024-06-14

7.5 Version 2024-03-15

7.6 Version 2023-12-15

7.7 Version 2023-09-08

7.8 Version 2023-06-10

7.9 Version 2023-03-17

7.10 Version 2022-06-17

7.11 Version 2022-03-18

7.12 Version 2021-12-17

8 License

ltewww is copyright (C) 2012-2025 Amarisoft. Its redistribution without authorization is prohibited.

ltewww is available without any express or implied warranty. In no event will Amarisoft be held liable for any damages arising from the use of this software.

For more information on licensing, please refer to license terms.