Admin Help
Admin Help
DN192692940
Issue 15A
Approved on 2022-01-21
Nokia is committed to diversity and inclusion. We are continuously reviewing our customer
documentation and consulting with standards bodies to ensure that terminology is inclusive
and aligned with the industry. Our future customer documentation will be updated
accordingly.
This document includes Nokia proprietary and condential information, which may not be
distributed or disclosed to any third parties without the prior written consent of Nokia. This
document is intended for use by Nokia’s customers (“You”/”Your”) in connection with a
product purchased or licensed from any company within Nokia Group of Companies. Use this
document as agreed. You agree to notify Nokia of any errors you may nd in this document;
however, should you elect to use this document for any purpose(s) for which it is not
intended, You understand and warrant that any determinations You may make or actions
You may take will be based upon Your independent judgment and analysis of the content of
this document.
Nokia reserves the right to make changes to this document without notice. At all times, the
controlling version is the one available on Nokia’s site.
NO WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
ANY WARRANTY OF AVAILABILITY, ACCURACY, RELIABILITY, TITLE, NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, IS MADE IN RELATION TO THE
CONTENT OF THIS DOCUMENT. IN NO EVENT WILL NOKIA BE LIABLE FOR ANY DAMAGES,
INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR
CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT,
REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA THAT MAY ARISE
FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT, EVEN IN THE CASE OF
ERRORS IN OR OMISSIONS FROM THIS DOCUMENT OR ITS CONTENT.
© 2022 Nokia.
Table of Contents
List of Figures
Figure 1 Authentication process prior to SRAN 21A/5G21A ................................................. 17
Figure 2 Authentication process from SRAN 21A/5G21A onwards ...................................... 17
Figure 3 WebEM user interface overview ................................................................................. 18
Figure 4 Top menu layout depending on the window size .................................................... 20
Figure 5 Operations history ....................................................................................................... 22
Figure 6 Access to User Account Management view .............................................................. 23
Figure 7 Local User Account Management view ...................................................................... 23
Figure 8 Service Account Management view ........................................................................... 25
Figure 9 Example of notification about another user having logged in or out ................... 26
Figure 10 Example of notification about errors ...................................................................... 26
Figure 11 Example of notification about user action status ................................................ 26
Figure 12 WebEM Timeline tab ................................................................................................... 28
Figure 13 History load option .................................................................................................... 28
Figure 14 Objects tab in the Site Runtime View ...................................................................... 31
Figure 15 Objects tab in the Parameter Editor view .............................................................. 31
Figure 16 An example of Details panel in Detailed Site View ................................................ 33
Figure 17 Start-up view .............................................................................................................. 36
Figure 18 Site View ...................................................................................................................... 37
Figure 19 Site action options ..................................................................................................... 39
Figure 20 Detailed Site View ...................................................................................................... 40
Figure 21 System module marked as primary ......................................................................... 42
Figure 22 Site action options ..................................................................................................... 42
Figure 23 Cells tab ....................................................................................................................... 44
Figure 24 Carrier Aggregation tab view .................................................................................... 45
Figure 25 Site Report view ......................................................................................................... 47
Figure 26 Configuration Management section ........................................................................ 48
Figure 27 Commissioning Wizard tab in an offline mode, without a loaded SCF .............. 50
Figure 28 An example of commissioning step in the Commissioning Wizard step-by step
view ................................................................................................................................... 51
Figure 29 An example of site topology created with Commissioning Wizard ..................... 51
Figure 30 Location of Add Configuration button ................................................................... 52
Figure 31 Example: connection between RF1 and OPT1 ports planned, selecting RF port for
OPT2 ................................................................................................................................ 54
Figure 32 Example: selecting signaling type for a cell carrier ............................................... 54
Figure 33 Sections in the Commissioning Wizard step-by-step view .................................. 55
Figure 34 Cancel Changes .......................................................................................................... 56
Figure 35 Parameter Editor tab ................................................................................................. 57
Figure 36 Conflicting commissioning data message .............................................................. 60
Figure 37 Compare Objects window ......................................................................................... 63
Figure 38 PnP report example ................................................................................................... 65
Figure 39 Set power state field is disabled due to switch schedule already applied in
hardware .......................................................................................................................... 73
Figure 40 Backup Tunnel view .................................................................................................... 76
Figure 41 Netconf Radio Management view ............................................................................ 79
Figure 42 Table view .................................................................................................................... 81
Figure 43 Plot view ...................................................................................................................... 81
Figure 44 KPI Dashboard ............................................................................................................ 83
Figure 45 Beam Set Realization Software view ....................................................................... 89
Figure 46 Example of a port mirroring configuration ............................................................. 95
Figure 47 Ethernet Port Mirroring view .................................................................................... 96
Figure 48 Capture point options for IP traffic capturing ...................................................... 96
Figure 49 NR Downlink tab view .............................................................................................. 102
Figure 50 NR Uplink tab view ................................................................................................... 104
Figure 51 NR Performance tab for a PUSCH test ................................................................. 106
Figure 52 NR Performance tab for a PUCCH test ................................................................. 107
Figure 53 NR Performance tab for a PRACH test ................................................................. 107
Figure 54 LTE Downlink tab view ............................................................................................. 108
Figure 55 LTE Uplink tab view .................................................................................................. 108
Figure 56 WCDMA Downlink tab view ...................................................................................... 109
Figure 57 WCDMA Uplink tab view ........................................................................................... 109
Figure 58 Checking critical link events .................................................................................... 115
Figure 59 GSM Traffic Trace view ............................................................................................ 120
Figure 60 WebEM common configuration .............................................................................. 121
Figure 61 PDH Loopback .......................................................................................................... 122
Figure 62 Calibrate EPIMC FHS ................................................................................................ 125
Figure 63 BTS Log Level view .................................................................................................. 127
Figure 64 Example of adding the --ignore-certificate-errors flag to the browser properties
(Windows OS) ................................................................................................................ 130
Figure 65 Example of adding the --ignore-certificate-errors flag to the browser properties
(Debian OS) ................................................................................................................... 130
Figure 66 Logging in to WebEM ............................................................................................... 131
Figure 67 Connecting to the BTS ............................................................................................ 132
Figure 68 Downloading history ................................................................................................ 132
Figure 69 The Open ims2 file button ..................................................................................... 133
Figure 70 Overview of the connection of a handheld device to the BTS .......................... 134
Figure 71 Configuring AP - Operation Mode ......................................................................... 136
Figure 72 Configuring AP - Network Name ............................................................................ 136
Figure 73 Configuring AP - Network Setting ......................................................................... 136
Figure 74 Modifying the address in the web browser .......................................................... 138
Figure 75 Saving the BTS configuration ................................................................................. 139
Figure 76 Selecting Snapshot .................................................................................................. 140
Figure 77 Selecting snapshot coverage ................................................................................. 141
List of Tables
Table 1 Features related to WebEM ........................................................................................ 156
Table 2 Information available in Centralized RET Management ........................................ 162
Summary of changes
A list of changes between document issues. You can navigate through the respective
changed topics.
Connection to NMS has been separated into downlink connection from NMS and uplink
connection to NMS.
Additional information on scheduled and remote ON or OFF power ports switching and
reset has been added.
Note about this view not being visible for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Commissioning Wizard
Figure: Sections in the Commissioning Wizard step-by-step view has been updated.
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Note about clearing the parameter valued in the device has been added.
KPI Dashboard
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
RF Monitoring
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
NR Performance
Terminal
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Snapshot
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
PPP Interfaces
Note about this view not being supported for MNL Product variant planned
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
PDH Loopback
Note about this view not being supported forMNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Sanity Checker
Note about this view not being supported for MNL Product variant planned
(productVariantPlanned) set to 5gClassicalBTS.
Note about the BTS Data Collection User not being supported in 5G has been
added.
Navigation Panel
RF Diagnostic Test
Note about cells not supported for RTWP measurements has been added.
1. Introduction to WebEM
WebEM overview, requirements and functionality
WebEM overview
Web Element Manager (WebEM) is a web-based application for maintaining and
commissioning a BTS. WebEM can be used both in an online (direct connection to the BTS)
and offline mode (saved WebEM application) for configuration creation, modification and
troubleshooting purposes.
English is the only language supported by WebEM. However there are some parameters that
can be inserted in local language:
Note:
For example, for numerical values of the parameters the decimal separator is a dot
and we don't use comma as a delimiter in numbers larger than 999.
Using WebEM doesn't interfere with the usage of other element managers although it's not
recommended to have more than one type of element manager connected to the site at
the same time.
WebEM is used starting with the LTE 19, SRAN 17A and 5G19A (for classical gNB) releases.
Note:
Requirements
To connect to the BTS, type in the BTS management plane IP address (or LMP IP address in
case of a local connection), using one of the supported internet browsers:
Chrome (recommended)
Mozilla Firefox
Note:
When using Chrome you need to disable the Throttle Javascript timers in
the background flag. Otherwise, WebEM disconnects from BTS when a web browser
or WebEM tab is not active. This leads to interrupting ongoing operations.
Note:
Firefox can slow down or even crash due to the following events:
WebEM can be launched from any PC that can run the Chrome or Firefox browser; however
for better performance, the following specification is required:
The minimum screen resolution: 1366x768 pixels (1920x1080 is recommended)
CPU: 2 GHz 32-bit (x86) or 64-bit (x64)
RAM: 4 GB
Note:
Depending on the browser type or version, loading WebEM from the browser cache
may cause the application not to load successfully. In such a case, it is required to
either clear the browser cache or refresh the page disregarding the cache (Ctrl+F5).
Functionality
As long as WebEM remains launched and connected to the BTS, the updates are constantly
collected in predefined periods in WebEM.
Note:
Due to the defined period of data synchronization between WebEM and the BTS,
WebEM may not be able to display all of the BTS status information.
WebEM introduces a new type of file, the Info Model Snapshot file (IMS2). IMS includes a full
BTS runtime data for a certain period of time. IMS2 files can be saved manually from WebEM,
or they can be automatically retrieved by WebEM when a BTS snapshot is collected.
The save location of files downloaded from WebEM (for example SCF, IMS2, or snapshot
files) depends on the browser settings.
The CB005784: Protection of WebEM Against HTTP Flood Attack feature introduces the
following changes to WebEM:
A full application is downloaded only after a successful logging in.
After successfully logging in, WebEM creates a new connection.
Logging in is done through an HTTPS-based interface.
An offline version of WebEM can only be downloaded after logging in.
WebEM sends a notification when a BTS receives more HTTP requests than the
predefined limit.
WebEM delivery to Support portal - only Admin.html is delivered.
Top menu
The main navigation tool of the WebEM application. It allows switching between different
views of the working pane. For more information, see Top menu.
Connection
It allows to connect to and disconnect from the BTS, open saved IMS2 or snapshot files, and
see the actual status of the BTS connection.
It displays real-time information on the BTS, such as BTS ID, BTS name, the total number of
alarms, BTS software version, BTS time zone, technologies configured on the site along with
their statuses. For more information, see Site Status bar.
Shortcuts
It allows to switch between the most commonly used views. From the left:
Site View
Commissioning Wizard
Parameter Editor
BTS Counters
Snapshots
User management
It displays details on the current session and allows you to log out and open User Account
Management.
Options
Navigation Panel
It contains information on the timeline, available objects, and so on, depending on the actual
view in the Working Panel. For more information, see Navigation Panel.
Working Panel
This is the main WebEM working area. For more information, see Working Panel.
Details Panel
It displays e details of items selected in the Working Panel. For more information, see
Details panel.
Top menu
The top menu is the main navigation tool of the WebEM application, allowing the user to
switch between different views of the Working Panel. Clicking on the menu item displays
the structured menu of the topic. Clicking on the tab from the structured menu navigates
you to the selected view.
The layout of top menu changes from icons to text depending on the window size of a
browser.
Figure 4: Top menu layout depending on the window size
The Options button opens a drop-down list with the following tabs: Settings, Sessions
list, Operations history, Download help, Download application logs,
About, and Download application.
Settings
In the Settings window, the user can define the lock time of idle screen and enable a
debug log collection.
Note:
The maximum allowed value of the Lock screen when idle for (min)
parameter is defined by the WebEM session logout timer parameter.
Session list
The Session list menu item displays a table with information about sessions (ID, Profile,
Secured connection, Session type, Read-only, IP address, session ID). Note that there is a
limit for open sessions - regardless of the user type, up to ten sessions can be open.
Operations history
The Operations history menu item opens an additional panel with information on
executed operations and their statuses. WebEM tracks and displays the user activity that
occurred during a single WebEM session.
Operations triggered in the background by WebEM functionalities are also listed in the
Operations history even if they weren't triggered by the user.
Download help
The Download help option allows you to download WebEM User Guide (admin-help.pdf
file).
Note:
If WebEM runs in an offline mode (no connection to the BTS), it's not possible to
download logs and the Help file.
About
The About option displays the main information about the WebEM application:
Full name
Version
Supported browser version
Build
Download application
The Download application button triggers the download of an offline WebEM version.
Access to User Account Management view: Top menu ► Username icon ► User
Account Management
Note:
Depending on the user type, the following fields are available when editing user accounts:
User role - currently selected user role
User name - editable only for BTS System Administrator
Alias - not a mandatory field, rules for creating aliases are displayed when the user
enters the input field
New password - rules for creating passwords are displayed if this field is active
Confirm password
Account activate state - used to define whether the selected user role is active or
not
There are always four accounts available in the BTS (one per role). Local accounts can be set
as active.
The Save button saves the account's state in the network plan.
Service accounts are used by the technical support personnel in response to service
requests made by the operator. The BTS can be accessed for servicing locally or remotely
over the Secure Shell (SSH) protocol, using credential-based authentication (username and
password).
User name: The user name of the service account for which the password is to be
changed.
Old password: the old password must be entered in order to change the existing one;
the rules for creating a password are displayed if this field is active.
New password: The new password must be entered in order to change the existing one.
Confirm password
User action status (started, accepted, or succeeded) - this type of notification has a
green background. Types of user actions:
Block/unblock cells, site
Lock/unlock radios, baseband modules
Reset site
Software activation, rollback
Test triggered
Figure 11: Example of notification about user action status
The Site Status bar is located between the top menu and Working Panel.
It allows you to connect to and disconnect from the BTS, open saved IMS2 or snapshot files,
and see the actual status of the BTS connection.
BTS ID.
Site name.
The number of active alarms.
Active software version.
Time zone.
Configured technologies (GSM, WCDMA, LTE, NR) and their status; The reset button is
used to reset a specific technology.
NOTICE:
An RAT reset is not supported for TD-LTE massive MIMO deployed on ABIC. Using this
button triggers a cell malfunction.
Resetting a whole technology causes a reset of the cells and carriers for that technology as
well as a loss of the connection to the controller. It has no impact on the system modules
and the rest of the technologies, which continue providing services.
Navigation panel is located on the left side of the tool. The icon hides the panel, while the
icon displays it again. Depending on the Working Panel view, the Navigation Panel
consists of three interchangeable tabs: Timeline, Objects, and Steps.
Timeline
The Timeline tab lists updates received from the BTS site. After logging in to WebEM, the
IM Snapshot Collected message appears and WebEM downloads changes done on BTS.
This tab also allows you to select and display data for a specific time frame. Each timestamp
includes detailed information about the BTS state at that certain point in time. Timestamps
are displayed in the BTS timezone. As long as the connection between WebEM and BTS is
established, the Timeline list is updated with new entries, which can be saved to Info
Model Snapshot (IMS2) file at any time. In an offline mode, when the IMS2 file is loaded, the
list shows all available (saved) entries.
This functionality is useful for troubleshooting. For example, if a problem occurs on site at a
certain time and then disappears, you can choose the right timestamp and see what
happened at that particular time. You can also navigate through the timeline to see what
caused the problem to disappear.
It is possible to load a list of changes that occurred before the connection to the BTS. The
history load option appears after the first connection to the BTS, but only when the BTS is
synchronized. Clicking the Yes button starts the history load process.
If a timestamp is marked in red, it indicates that a fault occurred during a given period of
time. A timestamp in which the alarm ceases to exist is also marked in red. When a BTS is
reset, the timestamp contains the label [RST].
The buttons located at the top of the Timeline panel provide you the following
functionalities:
Focus on the newest entry - focus on the most recent state (only while connected
to the BTS)
Save IMS2
Save IMS2 from range
Merge timeline - merge all visible entries into a single one
Based on the affected object names, it's possible to to filter the timestamps that are visible
by using Expression filter located at the top of Navigation Panel.
Selecting a timestamp displays the BTS state from that time point.
Changing the view, for example by using either the top menu or tabs, does not affect the
items displayed in the Timeline tab.
Objects
The Objects tab is active for different views. Depending on the view, the Object tab
shows:
An object list of the site elements: hardware and cells. An object selected from the list is
highlighted in the Working Panel. Filtering objects is possible by using the Object
name text field in the Navigation Panel.
The configuration plan in a tree format. It is possible to see multiple configuration plans
at a time, and the one that is currently used is presented in the designated section
Current BTS configuration. The Load SCF button (located in the Working
Panel) allows you to load a configuration from a previously prepared SCF. Newly loaded
configurations are added at the bottom, they are available locally and are visible in the
Planned BTS configuration section.
A list of configuration plans. An object selected from the list is highlighted in the
Working Panel, along with detailed information about the configuration.
A list of objects with alarms assigned to them, while in the Alarms view.
A list of counters and measurements in the Performance Management view.
Active and loaded configurations can be modified freely while changes to the BTS take
effect only after using the Activate Plan option in the Parameter Editor view.
Selecting an object while in the Parameter Editor view shows the parameters associated
with that object.
Selecting an object while in the Definition Errors view shows skipped parameters,
structure errors, definition errors, and missing object.
Steps
The Steps tab appears only when viewing the Commissioning Wizard tab. It shows the
configuration plan in a tree format. Clicking on any object opens the Configuration
Wizard step-by-step view.
The Details panel is located on the right side of the tool. To open the Details, panel
click on the icon.
The Details panel displays detailed information about items selected in the Working
Panel. Items displayed in the Details view vary depending on the selected item. The
Details panel may contain several tabs.
The Details panel can be hidden by using the hide icon and shown again by using the
details button .
Working panel is the main WebEM working area. The functionalities that are available in the
Working Panel depend on the view. Detailed descriptions of those functionalities are
presented in their respective sections:
BTS Start-up View is automatically opened when, during a WebEM start-up, the
following conditions are fulfilled:
the BTS has the correct commissioning file loaded
the BTS start-up is ongoing
there is no cell in the On Air state yet
This view does not open if all cells are in a failed state.
The statuses displayed in BTS Start-up View are grayed-out when they don't apply for
the current BTS.
The BTS Start-up View consists of four main areas, each comprising the information
listed:
Transport
Downlink connection from network and service management (NMS)
Uplink connection to NMS
Connection to base station controller (BSC)
Connection to radio network controller (RNC)
Connection to mobility management entity (MME)
Connection to 5G Core (for 5G Classical BTS in SA mode only)
Connection to CU (for 5G Cloud BTS only, in both non-standalone and standalone
mode)
The number of authentication management fields (AMFs) in the BTS configuration
(available only if the 5GC000740 feature is activated)
The number of connected AMFs (available only if the 5GC000740 feature is activated).
Configuration
Data conversion
Note:
Data conversion covers both BTS migration (for example from the LTE-only BTS
to the SBTS) and typical parameter conversions done during the software
upgrade.
Configuration validation
Hardware
Status of baseband (BB) modules detection
The number of BB modules in the BTS configuration
The number of detected BB modules in the BTS configuration
The number of failed BB modules in the BTS configuration
The number of detected BB modules not included in the BTS configuration
Status of radio modules detection
The number of radio modules in the BTS configuration
The number of detected radio modules in the BTS configuration
The number of failed radio modules in the BTS configuration
The number of detected radio modules not included in the configuration
Status of detected radio modules
Status of transport module detection
Cells
Start-up status of 2G cells
The number of 2G cells in the BTS configuration
The number of 2G cells in the On Air state
The number of 2G cells for which the start-up failed
Start-up status of 3G cells
The number of 3G cells in the BTS configuration
The number of 3G cells in the On Air state
The number of 3G cells for which the start-up failed
Start-up status of 4G cells
The number of 4G cells in the BTS configuration
The number of 4G cells in the On Air state
The number of 4G cells for which the start-up failed
Start-up status of NR cells
The number of NR cells in the BTS configuration
The number of NR cells in the On Air state
The number of NR cells for which the start-up failed
Note:
WebEM must be refreshed after every BTS power reset in order to update its Site
Runtime View.
Access to Site View: BTS Status ► Site Runtime View ► Site View
Shortcut keys: S + V
Site View shows the hardware available on the site as well as the configured cells.
Note:
If a cell is not in the On Air state, the information about the highlighted path between
the cell and the hardware that served it can be incomplete.
You can select elements shown in Site View using the following filters:
Hardware
Show all
SMODs/BBMODs
External SMODs
Radio ports
The Export as image icon allows you to save the site view in PNG format.
In configurations with two FSMF system modules, the modules are displayed in two separate
cabinets, since this is how the modules are physically located. In configurations with two
ASIA or ASIAA system modules, the modules are displayed in one cabinet.
In Site View, some alarms may be displayed. If an alarm is raised in a particular unit or cell,
it is indicated by the alarm icon (the color of the icon represents the severity of the
alarm). In case of multiple alarms, the alarm icon on a particular unit indicates only the
highest severity, although there may be other alarms as well. To see the list of alarms for a
unit, select it, go to the Details panel, and open the Faults tab. To see even more details
about an alarm, use the icon to go to the Active Alarms tab (Alarm Management).
The list of alarms is also visible on a tooltip for that alarm.
Selecting any of the elements displays more details, such as basic information (for example,
state and name) and related parameters and faults, when the Details panel is expanded.
When applicable, some items can be reset, blocked, or unblocked using the appropriate
At the top of the view, there are site action options used to block or unblock the selected
RAT, reset the site, or block and unblock the site. Note that the unblock site function causes
the entire BTS to reset.
Figure 19: Site action options
CAUTION!
Blocking the radio does not turn the power off. Switch off the radio before making any
physical changes to the equipment.
Clicking the Launch ASiR Web EM button opens a new browser window with the ASiR
element manager. This option is available only when the BTS is working in an LTE-only mode
and the FEATCADM Activate support for ASi (actAsi) parameter value is set to
true.
Access to Detailed Site View: BTS Status ► Site Runtime View ► Detailed
Site View
Detailed Site View shows the hardware available on the site and configured cells as
well as physical and logical links between them (including the ports that are used).
Connections between site elements and antenna line devices (ALDs) can be filtered from the
upper menu. Note that the displayed fiber lengths might differ from the actual lengths.
Available filters:
Cell carriers:
Show cells carriers
ALDs:
Show all
Show MHAs
Show RETs
Show RAEs
ALD links:
Show all
Show configuration links
Show data links
Show DC links
Show RET/RAE unit associations
All elements can also be sorted. FHSs, RMODs and ALDs can be sorted by:
Configuration ID
Product name
HW type (only for ALD)
State
Configuration ID
Band
State
Note:
The Detailed Site View tab in Web Element Manager does not properly reflect
fronthaul cable ports (OPT1, OPT2) actually used by the radios. For example, for
AEQD/AEQA/AEHA a physical cable is connected to an OPT_IF2 port, but the Detailed
Site View tab shows the cable to be connected to port OPT_IF1. This visual mismatch
does not cause additional alarms nor impacts BTS functional operation.
The Export as image icon allows you to save the site view in PNG format.
Selecting the cabinet allows you to see its details, such as basic information, related
parameters and faults, when the Details panel is expanded. The Show physical
cabinet button opens a pop-up view displaying the hardware available in the cabinet
(including hardware names and port names). Clicking anywhere outside the pop-up window
closes it.
In configurations with two FSMF system modules, the modules are displayed in two separate
cabinets since this is how the modules are physically located. In configurations with two ASIA
or ASIAA system modules, the modules are displayed in one cabinet.
Selecting any of the modules, physical connectors, antenna connectors, cells, or carriers
allows you to see their details, such as basic information (state, name, and so on), and
related parameters and faults, when the Details panel is expanded. The Show Channel
Relation button highlights links and other objects connected to a selected object. If a
channel is selected, all the hardware through which data is routed or elements creating that
channel are highlighted. If the selected object is a unit, the button shows the relation
between all channels creating or routing data towards or away from it. If a cell is selected,
the button shows the channel relation for this cell.
The Diagnostics button opens the diagnostics for the selected transport unit. When
applicable, radios, cells, or GSM TRXs can be reset, blocked/unblocked or locked/unlocked,
using the appropriate buttons from the Details panel. The icon notifies about ongoing
procedures for objects. A list of procedures is on a tooltip of this icon. A blocked object is
indicated by the icon.
At the top of the view, there are site action options used to block or unblock the selected
RAT, reset the site, or block and unblock the site. Note that the unblock site function causes
the entire BTS to reset.
Figure 22: Site action options
CAUTION!
Locking the radio does not turn the DC power off. Switch off the radio before making
any physical changes to the equipment.
In case any inband or guard-band IoT cells are configured on the BTS, these are represented
in Runtime View next to the hosting FDD-LTE cell.
Clicking the Launch ASiR Web EM button opens a new browser window with the ASiR
element manager. This option is available only when the BTS is working in an LTE-only mode
and the FEATCADM Activate support for ASi (actAsi) parameter value is set to
true.
The Cells tab lists the cells currently configured on the site along with basic information
about them. Full information about each cell is displayed in the Details panel after
selecting a cell.
Cells' statuses:
Online - displayed in green.
Degraded - displayed in orange.
Offline - displayed in grey.
Failed - displayed in red.
Configuration ID
Band
State
To apply the issues filter, use the Issues button. To apply the NR/LTE/WCDMA/GSM filter,
use the NR,LTE, WCDMA, or GSM button.
Cells can also be filtered manually, based on their name, ID, state, and so on, by using the
text filter. Selecting any cell shows its details, such as basic information (state, name, and so
on) and related parameters, and faults when the Details panel is expanded.
If an alarm is raised in a particular unit or cell, it is indicated by the alarm icon (the color
of the icon represents the severity of the alarm). In case of multiple alarms, the alarm icon
on a particular unit indicates only the highest severity, although there may be other alarms
as well. To see the list of alarms for a unit, select it, go to the Details panel, and open the
Faults tab. To see even more details about an alarm, use the icon to go to the Active
Alarms tab (Alarm Management). The list of alarms is also visible on a tooltip for that
alarm.
If a cell is locked, it is indicated by the lock icon . The icon marks a cell working in a
saving energy mode.
Note:
The Carrier Aggregation tab displays the BTS cells that WebEM is connected to as well
as cells from other BTSs configured as supporting cells. The information about cells that are
involved as supporting cells is taken from the configuration. Cells can be filtered by BTS
name or cell name. To display cells form a specific carrier aggregation group use the CA
Group Only button.
Access to Data Streams by Carrier view: BTS Status ► Data Streams ► Data
Streams by Carrier
Access to Data Streams by Cell view: BTS Status ► Data Streams ► Data
Streams by Cell
The Data Streams section represents a physical and logical relation between physical
and logical system units required to signal processing. As a result of the process, the BTS
site can deliver the service to the user. The Data Streams view presents:
Amount of functional data streams
Status of processing signals
Relations between hardware units assigned to processing signals
Basic identification information about detected hardware units
Availability status of hardware units
Operability status of functioning data streams
If an alarm is raised in a particular unit or cell, it is indicated by the alarm icon (the color
of the icon represents the severity of the alarm). In case of multiple alarms, the alarm icon
on a particular unit indicates only the highest severity, although there may be other alarms
as well. To see the list of alarms for a unit, select it, go to the Details panel, and open the
Faults tab. To see even more details about an alarm, use the icon to go to the Active
Alarms tab (Alarm Management). The list of alarms is also visible on a tooltip for that
alarm.
Blocked objects are marked with the icon and locked objects are marked with the lock
icon .
This section informs about hardware and cells, for example: product code, serial number,
status, antenna usage info, TRX or channel information, and so on.
Site configuration file (SCF)
This section allows you to display an SCF in a separate browser window.
NIDD version
This section provides information about the NIDD version in use.
SW Release version
This section informs about the software versions in use.
Frequency history
This section informs about the time, source, average clock control value, tuning,
difference, rejected samples, and average number of GNSS satellites.
The Save Report button allows you to save a report together with the SCF.
5. Configuration tab
Configuration provides a set of different views which let you load, edit, and save
configurations as well as manage certificates, reset configuration, and manage remote
electrical tilts (RETs).
the static hardware properties. If the validation is triggered in the online mode, then the
validation of static hardware properties is done against the detected hardware on the
site, mapped to the objects from the configuration plan. In case the validation is
triggered in the offline mode (without the IMS2 file loaded), then the validation of static
hardware properties is done against the planned product codes from the configuration
plan. When the IMS2 file is loaded to the offline WebEM, the validation is done against the
hardware from the IMS2 file, simulating the online mode.
Validate with Detected Hardware (available only in Hardware Errors view) -
retriggers the validation of the configuration plan against the parameter relationships
related to the detected hardware.
Activate Plan - opens a pop-up window where clicking the Execute button sends the
configuration to the BTS. To send the plan to the BTS, but not activate it, choose the
Download plan without activation option before using the Execute button.
Fix errors - the button appears only in the Parameter Editor tab and is active as
long as there are any definition errors. It allows you to fix errors by assigning default
values to parameters, if they have any.
Save report - the button is active after plan activation. Clicking the button starts
downloading a ZIP file with XML and TXT files inside. These files contain information
about the BTS state at the moment of the commissioning.
Save BTS configuration - allows you to save the currently edited configuration as
an SCF.
Note:
Commissioning Wizard allows you to have fully operational BTSs in the network by
creating new configurations as well as editing the existing ones, including inactive
configurations, on the BTS or loaded from an SCF. It is also possible to use Commissioning
Wizard in an offline mode (with or without a previously loaded IMS2 file).
Note:
When all system modules, baseband modules, and radio modules as well as the
detected cables between them are commissioned, it is not possible to change the
existing CABLINKs or manually create a new one. In this case, the cables in the
configuration must fully correspond to the detected cables only.
Configuration can be performed via two channels: Commissioning Wizard site view and
Commissioning Wizard step-by-step view. The site view (topology view) enables you to
create basic modules and logical items (like cells) and establish connections between them.
The step-by-step view (configuration wizard) allows you to create the same configurations
as in the site view, but, additionally, more advanced parameters can be defined here.
To access the step-by-step view, go to Navigation Panel, Steps tab, and click on a
selected step.
Figure 27: Commissioning Wizard tab in an offline mode, without a loaded SCF
Figure 28: An example of commissioning step in the Commissioning Wizard step-by step
view
Commissioning Wizard reports it as an error and gives you a chance to fix it.
Note:
In an online mode, WebEM detects existing hardware on a specific BTS site. The
detected units are not automatically added to a configuration. To add an object to a
configuration, use the button, visible on a particular unit. If an object has already
been added, the button is no longer visible. To add all the default (mandatory)
objects, use the Commission All button.
Figure 30: Location of Add Configuration button
To add a new hardware item or cell, use the icon. To change any item in an existing
configuration, use the icon. The icon opens the Commissioning Wizard step-by-step
view on the page corresponding with the item.
The icon is used to remove an item. This option is not available when a hardware unit is
detected and commissioned.
The icon visible in a cell object is used to add carriers. When used, the available antenna
connections are highlighted in order to assign the carrier.
The icon allows you to change the MIMO mode for WCDMA and LTE cells.
To change the position of system or baseband module in the cabinet, use the or icon,
respectively.
Physical and logical links can be created in the Commissioning Wizard site view. Clicking on
any of the connectors starts the process of creating connections between units (LOGLINKs
and CABLINKs). Green highlighted parts are available to establish connection, while the red
highlighted button stops the connection process. Choosing the green button creates a
connection. Click on the connector to remove the connection from the plan. A
CABLINK can be removed from the configuration by clicking the x icon at baseband module's
side, but it is not possible to remove it from the radio module side when the cable is
connected to the ? port. Clicking the x at the baseband module side removes a given
CABLINK from the configuration (check in Parameter Editor), but the link remains visible
in the runtime configuration in the Commissioning Wizard view. When planning logical
connections between cells and radio modules, click on the add carriers icon (in a cell) and
select the green highlighted connector to define the signal direction (TX/RX) on the radio
module.
Dark blue line - the link is detected, commissioned, and online, degraded, or failed.
Orange line - the link is configured in WebEM, but it is not mapped to any detected
runtime object.
Light blue line - the link is not commissioned, only detected (online, degraded, or failed).
Figure 31: Example: connection between RF1 and OPT1 ports planned, selecting RF port for
OPT2
Connections, as well as physical and logical items, can be modified and removed at any time
if the configuration is not activated. Note that, in case of a removal, all the related
parameter settings already edited are lost.
Note:
When all system modules, baseband modules, and radio modules as well as the
detected cables between them are commissioned, it is not possible to change the
existing CABLINKs or manually create a new one. In this case, the cables in the
configuration must fully correspond to the detected cables only.
To navigate through the wizard, use the Back and Next buttons. It is possible to freely
navigate through the steps.
To add a new object to the configuration, use a dedicated button, for example, the Add
Cell button. Those buttons are visible only where there is possible to add an object or
element. To add a new element to the object, use the button located in the table. Those
buttons are visible only where there is possible to add an object or element.
The Done button closes the window and saves the changes.
Note:
The Done button does not send the configuration to the BTS. The configuration must
be validated and then activated through the Activate Plan button in order to be
applied on the site.
Cancel closes the window without saving. After canceling, the Cancel Changes pop-up
window appears. Uncheck the option Perform revalidation after cancelling, if
needed, and click Yes to proceed.
Figure 34: Cancel Changes
Note:
For more information on commissioning a site using the configuration wizard, see
Creating SCF using WebEM in Single RAN Operating Documentation/5G and Single RAN
System/Commissioning and Configuring SBTS/Commissioning SBTS.
You can use Parameter Editor to manage objects and parameters in a controlled way; it
allows you to set only the parameter values of a correct data type (for example, string or
number) and inside a correct range. Nevertheless, it doesn't enforce hardware-specific
limitations, so it allows you to set values not appropriate for a given hardware.
Parameters are used to configure and control the BTS site; they are grouped into managed
object (MO) classes:
Set by system parameters cannot be changed by the user.
Mandatory parameters are required for a BTS to work properly. When omitted, a message
about a missing or invalid parameter is displayed.
Optional parameters are used to further configure the system.
WebEM provides functionalities necessary to easily find and edit necessary parameters as
well as view parameter details.
Filtering parameters can be done in real time, using either of the following methods:
The Search all text field - search by parameter name or abbreviated name through all the
existing parameters
The following filtering options, available only for visible parameters:
Filter in parameter status column, by mandatory and optional parameters, and also by
modified, invalid, existing, and non-existing parameters
Parameter name column text field
Abbreviation column text field
For example, selecting modified and invalid options parameters displays only parameters
that have been modified with incorrect values.
To add a parameter, enter Planned Value for the selected parameter. The new
parameter is added after activating a configuration plan.
Parameters are displayed in a table view in an alphabetical order. The first column shows
parameter status:
- Parameters that were modified; the new value is sent to the BTS after using the
Activate plan option.
- Parameters marked for deletion; the parameters are deleted after using the
Activate plan option.
- Parameter value is invalid.
- Parameter is mandatory.
If the runtime configuration is loaded, the actual values from the BTS are shown in the
Actual Value column.
The Actions column can be used to perform certain actions on a given parameter:
- Add an element or structure.
- Remove en element.
- Delete a parameter.
- Set the Planned Value to the Actual Value. If there is no Actual Value or the
SCF is used, this action deletes the value.
- Set the parameter to its default value.
Using the (details) button expands the Details panel, displaying detailed information on
the selected parameter, including validation errors (if any). The (hide) button closes the
pane.
Some BTS management operations, which can be performed by configuring certain NIDD
objects and for which WebEM doesn't provide any dedicated views or functionalities, can be
executed from WebEM by creating or configuring the desired NIDD objects and parameters
in Parameter Editor and then validating and activating the planned configuration plan.
In the Frozen mode, you can implement all the changes to the configuration before
conflicting changes in the system are applied. After sending the changes to the system in
the Frozen mode, a partial activation takes place, and the plan is activated on the BTS side.
It is not possible to switch from the Frozen mode to the Normal mode without losing all the
implemented configuration changes. It is not possible to enter the Frozen mode manually
(this mode can only be entered when WebEM notices conflicting changes).
Validation is used to detect errors such as incorrect or missing parameter values, conflicting
parameter values, or parameter sets not matching configuration rules.
The same filtering and configuration options as in Parameter Editor are available in
there.
Whenever parameter information is loaded (either from the current configuration or the
SCF), validation is performed automatically in order to detect configuration errors such as
not allowed or conflicting parameter values. Validation results are displayed in the
Definition Errors, Relation Errors, and Hardware Errors tabs.
Relation and hardware errors can be categorized into errors and warnings, based on their
severity level. Warnings don't prevent provisioning a plan to a BTS. It's possible, although not
recommended, to activate a plan with relation or hardware errors. In such cases, Nokia does
not take responsibility for any plan activation failures.
Validation errors, if any, are grouped into three categories and displayed separately:
Definition Errors groups errors such as unknown parameter or MO names, missing
mandatory parameters or mandatory values, incorrect values. When definition errors
occur, plan activation is not possible. Parameter values can be modified directly from this
view.
Relation Errors groups errors related to relationships between parameters or
parameter sets. For example, when a certain parameter value conflicts with another.
Hardware Errors groups errors related to the planned or actual hardware
configuration. For example, when hardware-related parameter values do not match the
hardware used on the site (such as the serial number, unit name, and so on).
Note:
WebEM gives the user tips on how to repair errors according to validation rules of
parameter description language (PDL).
It is possible, but not recommended, to activate a plan with relation or hardware errors.
Nokia does not take responsibility for a plan activation failure in case the plan is activated
with relation or hardware errors.
Note:
If there are no errors, but the plan activation fails during the activation of delta
configuration, it can be caused by making simultaneous changes to related
parameters under the TNLSVC managed object. It can be solved by sending those
changes to the BTS in separate delta configuration plans. For example, the plan fails if:
1. In the current configuration, FLOWCL IP interface reference (ipIfDN) is set
to MRBTS-1/TNLSVC-1/TNL-1/IPNO-1/IPIF-1 and FSTSCH IP interface
reference (ipIfDN) isn't set.
2. In a delta configuration plan, FLOWCL IP interface reference (ipIfDN) is
changed to MRBTS-1/TNLSVC-1/TNL-1/IPNO-1/IPIF-2, and FSTSCH IP
interface reference (ipIfDN) is set to
MRBTS-1/TNLSVC-1/TNL-1/IPNO-1/IPIF-1.
To solve this issue, you can send the changes in two separate delta configuration
plans:
Note:
In this view, only parameters are compared. Parameter structures are not included in
the comparison.
If the Show differences check-box is marked, only parameters with different values are
visible.
The Copy from Right to Left and Copy from Left to Right buttons allow
copying values of all compared parameters from one configuration plan to the other. To
copy a single parameter, use the < or > button in the Merge column. To revert a parameter
to its previous value, click the icon.
Identification
Clicking the Clear and Restart button clears all autoconnection parameters and
restarts the process. This option is available only during autoconnection when there is no
site configuration file (SCF) or network configuration file (NCF) manually activated on the
BTS.
This view allows you to load the file with the PnP parameter values or enter them manually.
You can also export parameters to an XML file.
Clicking the Clear and Restart button clears all autoconnection parameters and
restarts the process. This option is available only during autoconnection when there is no
site configuration file (SCF) or network configuration file (NCF) manually activated on the
BTS.
The Revert button restores the parameter values to the ones stored in the info model.
The Certificate Authority (CA) maintains a list of all signed certificates as well as a list of
revoked certificates (CRL). A certificate is unsafe until it is signed, as only a signed certificate
cannot be modified. A certificate management protocol (CMP) server must be configured to
manage certificates automatically.
When a BTS certificate is changed, the browser may fail to validate the SSL certificate. In
that case, WebEM cannot set up a new HTTPs connection, which may result in, for example, a
file transmission failure. Refresh the web page and manually accept the certificate to solve
this issue.
The BTS Certificates tab shows information about certificates on the BTS in a table
format:
You can use to collapse all the information in the table or to expand all. The Delete
button is used to delete the selected certificate from the table (the BTS trust chain cannot
be deleted).
To install a new certificate, select the BTS trust chain and additional CA certificates by using
the Browse button. Passwords must be provided if required (depending on the type). Use
the Install button to install the selected certificates.
The Automatic Management tab displays the certificate management protocol (CMP)
server information. This tab is available only if the CMP server is supported.
Reference number - CMP server reference number value. Clicking the Import button
opens the file selector.
Pre-shared key - CMP server pre-shared key value. Clicking the Import button opens the
file selector.
Click the CMP Key Update button to trigger the CMP key update request. This button is
disabled when the CMP server address or port is not configured, or there are unsaved
changes. CMP Key Update is disabled also when the BTS certificate has expired, or there is
no BTS certificate installed.
Click the Initialize Certificates button to trigger the CMP initialization request.
This button is disabled when the CMP server address or port is not configured, when there
are unsaved changes, or when there is no CA certificate in the BTS certificate chain and a CA
subject name has not been configured.
Clicking the Update Revocation List button triggers the CRL initialization request.
CRL issuer - name of the CRL issuer
Updated - when the CRL has been updated
You can use to collapse all the information in the table or to expand it all. Clicking the
Restore Vendor Certificates button restores vendor certificates in use in the BTS.
The button is disabled if there are no vendor certificates. For more details about a particular
certificate, expand the Details panel.
Note:
CBRS Certificates
CBRS Certificate Revocation Lists
Note:
These tabs are available for configuration with an AirScale system module. FSMF is not
supported.
This view provides the possibility to install CBRS certificates and display the ones that are
already installed. To perform this operation, click the Browse button next to CBRS vendor
chain, select the proper file, and click Open. Repeat the steps for Additional CA
certificates if required. Click Install.
This view also allows you to generate a CSR, copy, or save CSR.
The BTS Certificates tab shows the following information for revoked CBRS certificates
in a table format:
Issuer
Updated GMT +01:00
Next updated GMT +01:00
Revoked certificates
Distribution point
Type
Failure reason
The Execute Reset button located in this tab allows to reset configuration. Reset can be
performed with removal of security credentials and/or operator certificates.
The configuration reset clears the configuration on both partitions (active and passive). This
means that the BTS is not commissioned after the rollback or fallback procedure if the
configuration reset was performed.
The Centralized RET Management tab allows you to change the configuration RET unit
directly, without the need to go to Commissioning Wizard and activate a plan. The main
functionality of this view is changing values of angles and calibration.
Note:
When RET becomes not operational while the Centralized RET Management view
is open, WebEM clears all recently modified parameters for not operational RET.
Additionally, RET configuration changes can also be made by uploading a configuration file
(BIN file) to the device. These files contain configurations of all angles as well as additional
information about RET. Settings can be sent to a BTS by using the Send button. The action
state is visible in one of the columns in this tab. When an action is completed, new angles are
displayed along with possible errors. For more details, parameters, faults, or options about
the selected antenna line device or RET, open the Details panel.
Note:
You can't clear the parameter values in the device (except for RETU User Note 1
(userNote1) and RETU User Note 2 (userNote2)).
The configured parameter value is updated in the commissioning file only if the
parameter is commissioned for the antenna line device (ALD).
A pre-shared key can be typed into a field or imported using the Import... button. The
imported file must be in the XML or TXT format.
The Centralized RAE Management tab allows the user to manage the remote antenna
extension (RAE) device selected from the list. The user can set the values of:
Frequency
Beamwidths (vertical and horizontal)
Angles (downtilt and azimuth)
Weight factors
These values can be set automatically by using the Get Beamwidths, Get Angles and
Get Weight Factors buttons.
Note:
The Get Beamwidths button is enabled when Frequency is set. To enable Get
Angles, Frequency, and Beamwidths must be selected. The Get Weight
Factors button becomes active when all the other parameters have been set.
The Update Weight Factor File... button opens a file browser to select the weight
factor file.
The Restore Factory Defaults... button restores the weight factors for the selected
unit.
In the Centralized RAE Management tab, there is a list of files with RAE parameters.
The user can save these files by clicking the Save button.
Note:
When the port schedule is already applied in hardware, you can't change the port
status.
Figure 39: Set power state field is disabled due to switch schedule already applied in
hardware
Scheduled ON or OFF switching of the FPFH PDU power ports using WebEM
Note:
To schedule power on for all day, you must set On Time and Off Time to 00:00.
Note:
Note:
When the current port power state is off, you can't select reset check-box.
Note:
Set power state and reset port are mutually exclusive and cannot be performed at
the same time.
Enable or disable the maintenance mode of a specific port of the FPFH PDU. The
maintenance mode is used when the on-site operator has to change the power port
settings. While a power port is in the maintenance mode, its state can be changed only
from the front panel of the FPFH, thus preventing any remote settings changes which can
be harmful to the operator.
Configuration of the FPFH PDU power ports using WebEM, with options for disconnect
voltage, reconnect voltage, disconnect current, and time constraints.
Product name
Serial number
Product code
Network settings
Input voltage (refreshed every five seconds)
Temperature (refreshed every five seconds)
Additional information on FPFH PDU output ports, parameters visible in the Details panel:
Output port ID
Output voltage (refreshed every five seconds)
Current intensity of a specific FPFH PDU output port (refreshed every five seconds)
On or off state
Maintenance mode settings
Disconnect voltage, reconnect voltage, disconnect current intensity
In case BTS cannot establish Internet Key Exchange security associations (SA) and/or IPsec
SA, or an established one becomes non-operational, it enters into an IPsec Emergency
Bypass probing state. During the probing state the following operations are performed:
BTS continuously tries to re-establish non-operational SAs.
BTS periodically attempts to reach an operator-controlled server to check permissions
for switching off IPsec. You can configure the IP address of the control server and how
often BTS accesses it.
In this view, you can disable the Emergency Bypass mode by clicking Exit Active State.
Using this view, you can create the configuration of an alternative IPsec tunnel.
A backup IPsec tunnel is an alternative tunnel for the same traffic but connected to a
different, secondary security gateway. Thanks to this solution, the traffic isn't interrupted
when the primary gateway isn't reachable (due to network or site-related problems). The
BTS supports configuration of the following tunnels for the same type of traffic:
Primary tunnel
Secondary tunnel
Secondary public safety tunnel
Only one tunnel is active and carries traffic at a time. Multiple primary and secondary tunnel
pairs are supported (for traffic separation).
The manual tunnel switch can be done by clicking the Tunnel Switch button. Depending
on the configuration, the switchback happens either manually using management command
or automatically. Clicking Change Switchback Mode redirects you to Parameter
Editor, where this can be configured for all groups.
This view also allows you to perform a tunnel switch. A switchover of a particular tunnel
doesn't impact other tunnels.
With this tab, you can configure only the BTS transport parameters by using an NCF and
establish an M-plane connection. This gives you a possibility to configure other parameters
remotely later on.
Access to the NCF Parameter Editor view: Top Menu ► Configuration ► NCF
Configuration ► NCF Parameter editor
NCF Parameter Editor allows managing generic transport parameters and objects. It
can be used to create or load an NCF, which lists transport parameters necessary for an M-
plane connection.
A filter in parameter status column, by mandatory and optional parameters, and also by
modified, invalid, existing, and non-existing parameters
Parameter name
Abbreviation
To add a parameter, enter Planned Value for the selected parameter. The new
parameter is added after activating a configuration plan.
Parameters are displayed in a table view. The first column shows parameter status:
- Parameters that were modified; the new value is sent to the BTS after using the
Activate Plan option.
- Parameters marked for deletion; the parameters are deleted after using the
Activate Plan option.
- Parameter value is invalid.
- Parameter is mandatory.
If the runtime configuration is loaded, the real values from the BTS are shown in the Actual
Value column.
The Actions column can be used to perform certain actions on a given parameter:
- Add a structure.
- Remove the structure.
- Mark the parameter for deletion.
- Set the Planned Value to the Actual Value. If there is no Actual Value or the
SCF is used, this action deletes the value.
- Set the parameter to its default value.
Using the (details) button expands the Details panel, displaying detailed information on
the selected parameter, including validation errors (if any). The (hide) button closes the
pane.
For more information on loading and creating NCF, see Single RAN Operating
Documentation/5G and Single RAN System/Commissioning and Configuring
SBTS/Commissioning SBTS/Creating the NCF using WebEM and Uploading NCF to BTS.
Before activating an NCF it must be validated. If any errors occur, they are displayed in the
Definition Errors or Relation Errors tab.
Definition Errors lists errors such as unknown parameter or MO names, missing
mandatory parameters or mandatory values, incorrect values.
Relation Errors lists errors related to relationships between parameters or
parameter sets; for example, when a certain parameter value conflicts with another.
When definition errors or relation errors occur, plan activation is not possible. Parameter
values can be modified directly from this view. Whenever parameter information is loaded
(either from the current configuration or the NCF, validation is performed automatically in
order to detect configuration errors such as not allowed or conflicting parameter values.
6. Performance tab
The Performance tab provides a set of views to monitor BTS-related counters and
measurements.
After selecting an object from Navigation Panel ► Objects, related counters and
their values are displayed in either table view or plot view. You can use the Table/Plot
View button to switch between the two. The counters are listed in the Details pane, each
counter with a different color assigned. The detailed value is displayed once you click on the
chart. Up to 20 items can be displayed at the same time. The data is displayed for the time
intervals specified in a Display data for drop-down list.
Note:
A 5G radio with an integrated antenna does not require voltage standing wave ratio
(VSWR) measurements.
The date and time from a performance measurement (BTS) are used for BTS counters and
transport (TRS) counters. Real-time measurements are displayed in the BTS time.
When IMS2 is used, only real-time measurements are available. When a snapshot is used, PM
files are also available, and the data from all PM files from the snapshot is displayed.
Items in Navigation Panel can be filtered by name. Users can also manually select
counters and save a filter as an XML file, by using the Export filter button in
Navigation Panel. To load a saved filter, click Import filter.
The Save Snapshot option allows you to save the currently visible diagram as a PNG file
(only in a graph view).
You can export BTS counters by using the Export to CSV button.
In an offline mode, when data is loaded from a snapshot, the BTS Counters and
Transport Counters tabs by default show the latest value and saved data in a chart
view.
Note:
The Real-time Measurements tab shows the energy consumption based on the
power that goes through the module's power supply unit (PSU). In dual-rack
configurations with the first sub-rack powered directly by the PSU and the second
sub-rack powered through backplane, the complete energy consumption of the whole
dual-rack configuration is shown in the field related to the PSU-poweredsub-rack (and
zero value is reported for the backplane-powered sub-rack).
Note:
KPIs are displayed for objects selected in Navigation Panel ► Objects. You can group
the information in the KPI Dashboard view by objects or KPI name. KPIs can be filtered with
the KPI filter, ordered either by name or by related object, and searched by name. The list of
all KPIs can be collapsed and expanded. The Details panel displays details for all the
selected KPIs.
7. Alarms in WebEM
Alarm Management allows you to see details on active BTS faults as well as fault history.
You can access the Active Alarms view by clicking the Alarms Total Number icon in
the BTS site status bar.
Alarm Management is divided into three tabs: Active Alarms showing the actual (real-
time) data about BTS faults, Alarm History showing the historical data, and Fault
Toggling History, which allows you to suppress alarms that are raised and cleared in a
short period of time. All three tabs are configured and navigated in exactly the same way.
Note:
The alarms in the Alarm History tab are available only when history is loaded in
Navigation Panel. For more information, see the Navigation Panel topic.
The alarms are displayed in a table where you can find the following alarm information:
Severity
Appeared – time of the alarm occurrence
Alarm ID
Alarm name
Fault ID
Fault name
Alarming object – configuration object causing alarm. Runtime object is used only for
faults where configuration objects doesn't exist.
Number of impacted cells
Details of a selected alarm, such as time of appearance, description, and instructions on how
to deal with the fault, are visible in the Details panel.
The Show Source function in the Details panel navigates you to Site View or
Detailed Site View and selects alarm causing object if it happens to be visible in a
given view.
The Objects tab in Navigation Panel can be used to filter alarms by the related
managed object.
Historical information goes back to a maximum of 24 hours or the last BTS reset.
Additionally, the information presented in the table can be arranged by selecting a column
and saving to a CSV file by using the Save button: .
Note:
The time of alarm raising and cancellation may differ between WebEM and logs,
because of latency in data propagation. Timestamp is made when notification arrives
to WebEM, not when notification is created.
This tab allows you to update and use the BTS site software, the radio frequency module
(RFM) plugin software, and the antenna line device (ALD) software. The contents of the
software package are defined in a master file (a software package ZIP file). A software
update may need to be performed to add some new features to better support customer
needs, to remove bugs, or to guarantee compatibility with other element types due to their
own software upgrade. You can view the current software versions in the Software
Version tab.
CAUTION!
Do not disconnect any unit, power supply, or WebEM during the software update
procedure. Any interference during the software update procedure may damage the
hardware.
Note:
If a software update is ongoing, changing the WebEM view does not stop the
operation.
Note:
The passive, active, and planned software versions are displayed at the top of the view.
Click the Rollback... button to change between active and passive software versions (to
revert to the previously used software version). The button is disabled if an update or a
rollback is ongoing or passive software is not available.
Click Backup BTS Site Configuration to save the site configuration file to a local
drive.
The BTS site software can be updated either from a local drive or a remote server by
selecting the appropriate software source option. In case of a local drive, the local file must
be selected using the Browse button. In case of a remote server, a URL address to the file
location must be provided. Once the software ZIP file is selected, it is loaded to WebEM,
where you can see the software details.
Save SW History Report is used to save the recorded software history to a TXT file.
Clicking the Start button uploads the selected and loaded software package to the BTS.
Selecting the Activate software after update check-box takes the selected version
into use, otherwise the new software version is listed as planned. This action results in a BTS
restart. After the restart, a new software version is used and marked as active, and the
previously used version is marked as passive. The progress and elapsed time of the software
update progress is displayed. The Cancel button allows you to cancel a software download.
The software update time depends on the file size. The update progress shows the transfer
status of files. A notification is displayed after completion.
If Activate software after update is left unchecked, the new software is still
downloaded to the BTS site,but the site does not restart. To activate the software later, go
through the update procedure again with Activate software after update checked.
This time WebEM does not download the files that already exist on the BTS site.
Save SW Update Report is used to save the latest update report to a TXT file.
Note:
You must refresh the browser and reconnect WebEM after the software change
procedure. During this procedure, the connection to the BTS is lost, and it's not
reestablished automatically. This is a result of a given WebEM version being
incompatible with the new BTS software.
This tab allows you to create ALD software based on detected ALDs or by updating the
existing ALD software. It is possible to restore hardware info with or without a serial number
by using a drop-down list. The Import Existing File... button allows you to upload a
ZIP or XML file.
SW file - in this column you can select a software file, using the icon
Manufacturer
Product code - this column also allows for ascending or descending arrangement
Serial number
HW version
Target SW version
SW update options - you can choose one option from a drop-down list: Normal,
Restricted, or Forced
Additional information on hardware, detected by the BTS, such as name, type, and current
software version, is displayed in the Details panel.
This tab allows you to create and configure the BSR package. The Import file button
allows you to upload a ZIP or XML file.
SW file - in this column you can select a software file, using the icon
RU variant - the name of radio unit
Tapering profile - The value can be set to COVERAGE, CAPACITY, HSPLIT, VSPLIT, or left
empty.
BSR ID - The BSR ID should begin with 0 and contain other four digits in the file name. For
example, 01230.
Custom beam set name - the customized BSR package name without a file extension
You can also remove unused BSR software by means of the Delete button.
9. Diagnostic tab
The Diagnostic view allows you to set and execute tests, as well as use a terminal and
create reports.
Status
Access to the Synchronization view: Diagnostic ► Synchronization.
Status displays the actual (real-time) details on the synchronization source and time
servers. It also shows the details of synchronization source status, such as synchronization
hub, synchronous Ethernet, and Timing over Packet (ToP) status as well as GNSS satellite
information.
The Details panel displays the Synchronization hub and Timing over Packet
details.
Tuning
Fast tuning can be used if the BTS clock must be adjusted or the user wants to synchronize
the BTS clock quickly. To start fast tuning, select the Fast option and click the Tune button.
Note:
Tuning the BTS clock manually is used for the following purposes:
To read the current digital-to-analog converter (DAC) word from the BTS or to change
the current DAC word on the BTS.
To browse the history information about the difference between a BTS clock and external
clock frequency to find out about frequency stability or accuracy.
If the BTS determines that the reference signal quality during fast tuning is insufficient, fast
tuning is interrupted, and the BTS continues with normal tuning.
The Get History button allows you to view the history information about the difference
between the BTS clock and the external clock frequency to find out about frequency stability
or accuracy. It is also possible to save and print the history information, using the respective
buttons.
Note:
There can be entries with the date 01.01.2004 in the frequency history file. This date
is shown if the Network Time Protocol (NTP) time has not been available.
Test Clocks
Test Clocks tab allows you to test the output signal of the test clock in the sync out
connector of the BTS. It is also possible to enable or disable the output signal of frame clock
and to select which frame clock is used. The clock signal is used for synchronizing external RF
measuring equipment and must be disabled during a normal BTS operation.
The current status of the 10-MHz test clock is visible at the top of the view. Use the Enable
checkbox to enable or disable the test and select which frame clock is to be used with the
Output list. The Send button saves the settings.
Press Start to display the test result. To stop testing, press Stop.
Note that a test failure doesn't always mean there is no connection. Various scenarios must
be taken into consideration. Therefore, make sure to select the correct source address.
The RF Diagnostic Test view contains two tabs: Test Setup and Test Result.
RF Diagnostic Test is supported for rel. 2 and newer hardware. For more information
on hardware release, see Single RAN Reference Documentation/5G and SRAN Supported
Configurations/SBTS Supported Configurations or gNB Supported Configurations
Test Setup
To execute the test, select the technology and which cells are to be tested (all or an
individual cell) and define thresholds for the BTS:
RF Power Error High Threshold (dB)
RF Power Error Low Threshold (dB)
RTWP High Threshold (dBm)
RTWP Low Threshold (dBm)
TX Antenna VSWR High Threshold
High RSSI Threshold (only for NR cells)
Low RSSI Threshold (only for NR cells)
Note:
If the RAT (LTE or NR) under test is On Air, check the Activate remote RF diagnostic
test check-box.
Note:
To define thresholds for bands, click the + icon and enter the required parameters (Band
class, Total RF power high threshold, Total RF power low threshold). To delete thresholds for
bands, use the x icon.
The Save threshold button sends the configured threshold to the BTS.
Use Start Test to initiate the test. The progress and results are displayed in the Test
Result tab once they are available.
Test Result
The Test Result tab contains a table with general test information and a table with a
detailed result for each antenna. Test results are displayed for selected cells. The list of cells
is in the Local cell ID table and can be filtered by local cell ID. Test results can be saved
for one cell (Save Cell Results) or for all cells (Save All Results). Results are saved
in a TXT file.
Note:
Only commissioned EAC lines can be tested with EAC Functionality Test.
Faults are used to test external fault lines, if EAC is configured. Select the lines to be
tested in the Selected to test column, and the results are updated when available.
Using the Save Results button allows you to save the results to a TXT file.
Controls are used to test the external control lines. Change the state of the output line
and click Send to send the changes to the BTS. After the BTS has changed the state of the
external control line, check the state of the supervised external device. You can update test
results in the Test result column. Using the Save Results button allows you to save
the results to a TXT file.
The port mirroring function enables you to perform on-site mirroring (tracing, sniffing) of
Ethernet traffic. You can use Ethernet port mirroring for the Ethernet traffic on physical
Ethernet interfaces of the BTS. If a BTS-integrated, QoS-aware switch is present, you can
use it also on an internal Ethernet interface.
Figure 46: Example of a port mirroring configuration
To enable Ethernet port mirroring, check the checkbox Enable Ethernet port
mirroring. Configure the managed object class of Ethernet link for the destination port.
To do that, go to Parameter Editor and configure
MRBTS ► TNLSVC ► TNL ► ETHSVC ► ETHLK managed object. Go back to Ethernet
Port Mirroring, click Add Mirror group and set direction, source, and destination for
the mirroring. Clicking the Send button applies the changes to the configuration plan and
triggers its validation and activation. No BTS reset is required.
To capture traffic at a transport network interface level, select one of the capture point
options. For more information, see Figure: Capture point options for IP traffic capturing
Clicking on Start initiates the capture. The status and duration are displayed. The Stop
button stops the process. The BTS automatically stops traffic capturing after 24 hours if the
user does not stop it. The captured data is saved on the BTS and is generated as a file only if
the user clicks the Generate and Download File button.
SFP is a physically compact connector design that consists of a housing fitted on a host
board and a pluggable transceiver. It is developed for use in a high-speed data transfer,
including both copper-based and fiber-optic systems.
The SFP Monitoring tab shows current (real-time) information about the connection
between radio modules and system modules in a current configuration. Selecting any of the
listed SFPs displays further information in the Details panel.
Note:
In the case of FOSP SFP type (supplier WTD or Accelink, supplier part code
RTXM228-402-C39), the nominal transmission rate is reported to be 10G. However,
the actual nominal transmission rate is 9.8G.
Note:
Note:
The Antenna Line Online Monitoring view allows you to monitor online antenna line
characteristics such as:
The values of voltage standing wave ratio (VSWR) for the TX-capable antenna lines
The values of received total wideband power (RWTP) for LTE and WCDMA
The values of received signal strength indicator (RSSI) for GSM
To start monitoring, select the antenna line and click the Start button. The Stop button
stops the monitoring. The obtained results can be exported to a CSV file.
Note:
If the VSWR value is 0, it means that VSWR measurements are unavailable or that the
BTS can't read VSWR measurements at the moment.
9.9 RF Monitoring
This view allows you to monitor the spectrum in order to detect radio frequency
interference (RFI) and radio disturbance in the peripheral radio frequency (RF) path.
Note:
PIM Desensitization
Distance to PIM
RF Scan
Passive intermodulation (PIM) Desensitization is a test that verifies if PIM has any impact on
the uplink channel for a particular antenna. To perform the test, it is necessary to specify
which antenna is to be tested. The following information on test configuration is displayed:
Local cell
Frequency band
Bandwidth
Frequency/EARFCN
Power
This test can be performed for the LTE and WCDMA technologies. The BTS configuration
used for the test can be exported into a ZIP file. Use the Start button to launch the test.
The test results are saved to a local drive. For detailed instructions on viewing the test
results, see Viewing RF monitoring results.
DTP is a test that helps localize the actual place where PIM is happening on an antenna line.
To perform the test, it is necessary to specify which antenna is to be tested. It is possible to
configure additional test settings:
Velocity factor
Cable length
Local cell
Power
This test can be performed for LTE and WCDMA technologies. Use the Start button to
launch the test. The test results are saved to a local drive. For detailed instructions on
viewing the test results, see Single RAN Operating Documentation/Single RAN
Features/SRAN Operability Features/ RF performance measurements and monitoring/Viewing
RF monitoring results.
9.9.3 RF Scan
This tab allows you to perform RF scanning.
It's possible to trigger a scan to detect RF interference. There are several attributes that
must be configured to perform a scan:
Antenna
Capture type
Local cell
This test can be performed for the LTE and WCDMA technologies. Use the Start button to
launch the test. The test results are saved to a local drive. For detailed instructions on
viewing the test results, see Viewing RF monitoring results.
The Test Models views allow running downlink and uplink test models for LTE and WCDMA
cells.
It also allows for running transmission and loop tests for GSM.
The tests are available only if the BTS is in Test Dedicated State.
9.10.1 NR Downlink
The NR Downlink tab allows you to perform NR downlink tests.
Clicking Start Test begins the test, and Stop stops the test. The results are displayed for
each cell and can be saved to a file. The Details panel presents the status of each started
test.
For TDD measurements, you can change Beam pattern ID during the test, using the
Change Beam button. For more information on beamforming, see Single RAN Operating
Documentation/5G Features/5G19 RAN Feature Descriptions and Instructions/5G19 Radio
Resource Management and Telecom Features/5GC000533: Digital Beamforming for CPRI
Based RUs.
Note:
For FR1(cmW) 32T32R or 64T64R radio units, set the Beam pattern ID value from
1 to 950.
For FR1(cmW) 8T8R radio units, set the Beam pattern ID value:
For more information on supported external antennas, see Single RAN Operating
Documentation/5G Features/5G19B RAN Feature Descriptions and Instructions/5G19B
Radio Resource Management and Telecom Features/5GC001849: Support of 8T8R 8
Port BF Antenna with Calibration Port below 6 GHz.
Measurement time
RSSI
Throughput %
Received bits
Unreceived bits
Defective bits
Received blocks
Unreceived blocks
Defective blocks
9.10.2 NR Uplink
The NR Uplink tab allows you to perform NR uplink tests.
Clicking Start Test begins the test, and Stop stops the test. The results are displayed for
each cell and can be saved to a file. The Details panel presents the status of each started
test.
For TDD measurements, you can change Beam pattern ID during the test, using the
Change Beam button. For more information on beamforming, see Single RAN Operating
Documentation/5G Features/5G19 RAN Feature Descriptions and Instructions/5G19 Radio
Resource Management and Telecom Features/5GC000533: Digital Beamforming for CPRI
Based RUs.
Note:
For FR1(cmW) 32T32R or 64T64R radio units, set the Beam pattern ID value from
1 to 950.
For FR1(cmW) 8T8R radio units, set the Beam pattern ID value:
For more information on supported external antennas, see Single RAN Operating
Documentation/5G Features/5G19B RAN Feature Descriptions and Instructions/5G19B
Radio Resource Management and Telecom Features/5GC001849: Support of 8T8R 8
Port BF Antenna with Calibration Port below 6 GHz.
Measurement time
RSSI
Throughput %
Received bits
Unreceived bits
Defective bits
Received blocks
Unreceived blocks
Defective blocks
9.10.3 NR Performance
This tab allows you to test physical uplink shared channel (PUSCH), physical uplink control
channel (PUCCH), and physical random access channel (PRACH).
The results are divided into two sections: cumulative results and single test run results. You
can save the results to a file using Save Test Results.
For TDD measurements, you can change Beam pattern ID during the test, using the
Change Beam button. For more information on beamforming, see Single RAN Operating
Documentation/5G Features/5G19 RAN Feature Descriptions and Instructions/5G19 Radio
Resource Management and Telecom Features/5GC000533: Digital Beamforming for CPRI
Based RUs.
Note:
For FR1(cmW) 32T32R or 64T64R radio units, set the Beam pattern ID value from
1 to 950.
For FR1(cmW) 8T8R radio units, set the Beam pattern ID value:
For more information on supported external antennas, see Single RAN Operating
Documentation/5G Features/5G19B RAN Feature Descriptions and Instructions/5G19B
Radio Resource Management and Telecom Features/5GC001849: Support of 8T8R 8
Port BF Antenna with Calibration Port below 6 GHz.
To perform a test, select the cells for each test, as well as the test model and the physical
cell ID (PCI).
Note:
The test is not available for LTE NB-IoT cells due to the same PCI as the LTE cell (see
3GPP 36.141).
Clicking Start begins the test, and Stop stops the test. The results are displayed for each
cell and can be saved to a file. The Details panel presents the status of each started test.
To perform a test, select cells for each test, as well as the test model, reporting time interval
and resource block offset. Clicking Start begins the test, and Stop stops the test. The
results are displayed for each cell and can be saved to a file. The Details panel presents
the status of each started test.
To perform a test, select the cells for each test, as well as the test model, write the primary
scrambling code, and select the number of dedicated physical channel (DPCH). Clicking
Start begins the test, and Stop stops the test. The results are displayed for each cell and
can be saved to a file. The Details panel presents the status of each started test.
To perform a test, select the cells for each test and write the primary scrambling code.
Clicking Start begins the test, and Stop stops the test. The results are displayed for each
cell and can be saved to a file. The Details panel presents the status of each started test.
Access to the GSM BCCH Transmission view: Diagnostics ► Test Models ► GSM
BCCH Transmission
To perform a test, select the TRX number for each test, as well as the absolute radio
frequency number (ARFN). Choose the rest of test parameters. Clicking Start begins the
test, and Stop stops the test. The results are displayed for each cell and can be saved to a
file. The Details panel presents the status of each started test.
Access to GSM Loop Test view: Diagnostics ► Test Models ► GSM Loop Test
To perform a test, set up the test parameters and click Start. Clicking Stop stops the test.
The results are displayed for each cell and can be saved to a file. The Details panel
presents the status of each started test.
9.11 Terminal
The description of Terminal view
Note:
Terminal is a text console allowing you to execute text commands. The output of
Terminal is cleared on each reload or view change. It is possible to save the output to a
TXT file by using the output-to-file command. Using the help command lists all the
available commands, while using the help <command> displays help information on a given
command. Press the Tab key while typing a command to autocomplete it.
Note:
9.12 Snapshot
The Snapshot tab is used to save a BTS snapshot.
Snapshot is a functionality that can be used for troubleshooting and training purposes. It
enables you to troubleshoot an issue with a site or to simulate a BTS site for training
purposes. The snapshot file can be saved in the connected mode, and it lists the current
status of such elements as: used hardware configuration, logs, alarms, and hardware and
software version information. Unlike the IMS2 file, a snapshot contains only the latest
information, without the history.
NOTICE:
The Snapshot view allows you to download technical log files from the BTS. This tab
contains a Collect snapshot button and snapshot collection settings. The snapshot
collection settings allow you to:
select LTE cells.
select snapshot coverage:
all log files
most important log files
health check (when MNL Product variant planned (productVariantPlanned)
isn't set to 5gClassicalBTS)
select the target location - local or remote.
input filter keyword (optional).
include a reason for a report (optional).
Statuses of downloaded files are visible in the table at the bottom of the site. In order to
cancel a technical report procedure, press the Cancel button. When the file collection is
completed, the snapshot is saved in the selected location.
For more information on taking snapshots, see Taking snapshots with WebEM.
To perform tests such as LTE Uplink, LTE Downlink, WCDMA Uplink and WCDMA Downlink, the
Execute procedure must be run first. It causes the site to reset to test-dedicated state.
While in test-dedicated state, the site is treated as Blocked.
Note:
If any of the commissioned hardware is not detected, BTS cannot enter Test
Dedicated State.
While the site is in test-dedicated state, the icon is displayed in the BTS site information
area.
The purpose of the measurements in the TWAMP Metric view is to have an estimation of
the quality and performance of the IP-based mobile backhaul for each QoS class
independently, indicated by DiffServ Code points.
The results of the measurements are available in this tab if the hardware supports the RTT
measurements and if it is configured using Commissioning Wizard or Parameter
Editor.
Note:
Link monitoring
WebEM shows information on:
Latest events
Event type
Event subtype
Event time
Event code
Source address
Destination address
Event statistics
Event type
Last remote interval events
Total remote events
Total remote type length values (TLVs)
OAM/non-OAM statistics
The number of received OAM protocol data units (OAMPDUs)
Non-OAMPDUs frames transmitted
Non-OAMPDUs frames received
There are four types of link events defined in the standard for a degraded Ethernet
connection:
Errored Symbol Period Event
Errored Frame Event
Errored Frame Period Event
Errored Frame Second Summary Event
Loopback
This function is used for testing purposes in which the remote peer loops all received non-
OAM Protocol Data Units (non-OAMPDUs). If the loopback mode is activated, and it doesn't
receive a disable command, the BTS returns to the normal working state after a timeout is
reached.
Note:
Note:
To start Loopback or Link Trace, click the corresponding button in the Action column.
Note:
The PPP Interfaces view allows you to view the Point-to-Point Protocol (PPP) single-link
and multi-link configuration and status.
In the case of PPP multi-link view, details of all PPP links forming PPP multi-link configuration
can be checked.
9.18 IP Routing
The IP Routing view allows you to display information about static routes, routing
policies, and so on.
This tab provides information about static routes and forwarding tables for selected routing
tables. The data is presented using two tables: Static routes and Forwarding table.
IP MTU
Trigger ID
The Change Static Routes button redirects you to an object class in Parameter
Editor responsible for static route configuration.
The Change Routing Policies button redirects you to an object class in Parameter
Editor responsible for routing policy configuration.
Note:
A policy order number of any new or old policy cannot be changed to an existing policy
order number.
To start the test, enter Source IP address, Destination IP address, and DSCP. In
return, WebEM displays Path Maximum Transmission Unit and Local Maximum
Transmission Unit.
Note:
The GSM Traffic Trace view displays a graphical representation of active or idle
timeslots for a GSM cell or sector at a given time. To display data for all TRXs under a
specific cell or a single TRX, choose the correct object in Navigation Panel (the Objects
tab). GSM traffic trace data for each displayed TRX is presented in the form of a graphical
representation of eight numbered timeslots. Each timeslot is colored according to the type
of traffic.
Data collection starts after selecting the cell, or the sector or the TRX. To refresh the
results, click the Refresh button. It is possible to enable Auto refresh by checking a
dedicated checkbox. Select the Auto refresh time interval from a drop-down list.
Access to the Debug Tracing view: Top Menu ► Diagnostic ► Debug Tracing
The Debug Tracing view allows you to eliminate mixing traffic on the same port, which
could have caused performance and security issues.
Note:
To enable the PDH Loopback function, select the interface and loop configuration, and
then click Send. You can also set time out.
To start the sanity check, use the Start Sanity Check button.
Note:
The PIMC functionality is based on the PIMC engine. The hardware and software of the
engine monitor the downlink signals coming from the Nokia AirScale system module and
compute a PIM model in real time. The PIMC engine intercepts the uplink signals coming
from radio modules, synchronizes any PIM interference using the PIM model, and subtracts
the PIM noise or interference according to the identified model. This reduces the uplink PIM
interference, and a cleaner signal is sent to the system module.
You can change the status of Ethernet port feature, using the Disable or Enable button.
If the feature is enabled, the sensitive internal traffic is separated from external traffic.
Access to the R&D Service Port view: Top Menu ► Procedures ► R&D Service
Port
You can change the status of R&D service port, using the Disable or Enable button.
SSH.
Access to the Service Account SSH view: Top Menu ► Procedures ► Service
Account SSH
You can change the status of Service Account SSH, using the Disable or Enable button.
Using the Synchronize To Fronthaul Devices button triggers a BTS SSH password
and synchronization of SSH login configuration settings from the system module to
FHS/AFAA.
Using the Synchronize To Radio Modules button triggers synchronization of BTS SSH
password and SSH login configuration settings from the system module to radio modules. In
a dual-core configuration, all radios connected to different system modules are
synchronized at the same time. If the radio is shared, only the synchronization from primary
system module is possible.
The Change BTS R&D Parameters tab allows you to set the following components:
Index of SwSystem component
R&D setting type:
Factory defaults
Dynamic changes
Persistent changes
Persistent over one reset changes
R&D parameters in JSON format
10.6 IM Snapshot
The IM Snapshot tab allows you to download info model (IM) snapshots.
The IM Snapshot tab contains the Execute button. Clicking this button starts the IM
snapshot download procedure. The location where the file is saved depends on the browser
settings.
Note:
The BTS logs are a part of the collected snapshot data. This tab allows you to adjust the
level of saved data. You can choose minimum, normal, or full level of logs.
More detailed logs are used for troubleshooting purposes. When there are no issues, less
detailed logs save space on the BTS.
Note:
Before using the full BTS log level, contact Nokia Technical Support.
In this view, you can determine if the selected BTS log level is valid permanently or until the
site reset.
Figure 63: BTS Log Level view
Note:
In an offline mode, changing the BTS log level is unavailable, so this tab is empty.
11. Instructions
This section provides a list of step-by-step instructions on how to perform the most
common BTS-related activities (such as commissioning, software update, parameter
editing, running diagnostics) while using WebEM.
Before launching WebEM for the first time, open the browser properties and add the --
ignore-certificate-errors flag.
Procedure
1 Start the browser.
The IP address must be the M-plane address of the BTS or (if locally connected) the
local management port (LMP) address. A connection using this address is possible only
when the BTS is correctly configured.
Note:
The M-plane address is specific to the BTS. LMP addresses used for a local
connection:
For the primary core: https://192.168.255.129
For the secondary core: https://192.168.255.119
3 Log in to the web browser using local account credentials or Centralized User
Accounts.
Step example
Figure 66: Logging in to WebEM
Step example
Figure 67: Connecting to the BTS
Result
The connection to the BTS is established, and information related to the site is displayed.
During the connection, it is possible to download a history of events that occurred in a
limited time period before the connection was established, by using the download history
option.
Launching the WebEM tool offline is performed using the HTML file. This file can be
downloaded when the WebEM tool is launched, using an online BTS (see Launching the
WebEM tool when connected to the BTS (online)). When the WebEM tool is running in the
Chrome browser, click CTRL+S or Mouse Right Click+Save as... to save the HTML
file. WebEM offline is not connected to the BTS. WebEM offline can be used, for example, to
prepare a site configuration, save it, and later, when connected to the BTS, send it to the
BTS.
To view the IMS2 file or snapshot in WebEM, proceed with the following:
Procedure
1 Launch a previously saved HTML file in the Chrome browser.
2 Click Open ims2 file and navigate to the IMS2 or snapshot file, and then click
Open or drag and drop the file to WebEM.
Step example
Figure 69: The Open ims2 file button
Equipment preconditions
Procedure
1 Connect the AP to the BTS.
Search for the Wi-Fi network in the internet connection options of the mobile and
connect to it.
Username: Nemuadmin
Password: nemuuser
Note:
Equipment preconditions
Procedure
1 If needed, connect a power source to the AP.
2 Connect the AP to the laptop using the Ethernet cable or WiFi network.
If you choose a wireless connection, use the network name and password attached to
the router.
Result
The AP is configured.
Procedure
1 Generate a token.
To generate a token, send an HTTP_POST request with the username and password:
{“username”:”<<User Name>>”,”password”:”<<password>>”}.
Step example
An application that can be used to send an HTTP_POST request is cURL.
In this application, use the command: curl
https://btsAddress:443/NetActSSO/token -X POST -H Content-
Type:application/json -d
"{\"username\":\"UserName\",\"password\":\"pass\"}" -k, where
btsAddress is an M-plane BTS address, UserName is a user name, and pass is a
password.
Step result
The token is generated, and you receive the following object: {token:”<<TOKEN>>”},
for example {"token" : "46f4db42-ed1d-4530-b46d-9eced6220e02"}.
Note:
Keep in mind that these flags are specific to Google Chrome and might not be
supported in other browsers.
Step example
https://10.11.12.13/?token=46f4db42-ed1d-4530-b46d-9eced6220e02
Procedure
1 Enter the WebEM address again instead of clicking the F5 button.
2 You should remove everything after # (including # itself) from the address and press
Enter.
Procedure
1 Go to the Configuration ► Configuration Management ► Parameter
Editor view.
Note:
In case of saving before the activation of changed parameters, check Save also
planned parameters changes to include the planned changes of parameters
in the backup.
Purpose
For troubleshooting and fault traceability of the SBTS.
Procedure
1 Open WebEM and go to Diagnostic ► Snapshot.
Step example
Figure 76: Selecting Snapshot
2 For Coverage, select either All log files or Most important log files.
The All log files snapshot coverage includes all the files, while Most important
log files snapshot coverage includes only the most important files in the technical
log.
Step example
Note:
The default location for a remote snapshot collection is NetAct, but it is also
possible to save it to the lss server. In case the target location is set to
remote, make sure that the TRBLCADM Diagnsostic Snapshot
destination (diagSnapDestination) parameter is configured. If the
parameter value is lss, configure the parameters under the TRBLCADM Local
symptoms server configuration (lssConfig) structure as well. To
configure these parameters, go to Configuration ► Configuration
Management ► Parameter Editor. Use the search box to find the
required parameters.
Step example
Figure 78: Selecting the target location
Step example
Fill it in with regex, for example .*syslog
Note:
Procedure
1 Select the Timeline tab from Navigation Panel.
Procedure
1 Go to BTS Status ► Site Runtime View ► Detailed Site View.
4 Select the desired test from the list and click Execute to run it.
Some tests require certain input data (like IP address) before executing. The results of
the test are displayed on the screen. Note that selecting any other test or switching the
views makes the results disappear.
The RF Monitor tool is available together with the BTS software and requires an
installation on a local PC. It is launched in a web browser, similarly to WebEM. Before
launching RF Monitor, make sure you have MatLab Runtime R2015a installed (in the
same version, 32-bit or 64-bit, as RF Monitor). It can be downloaded from:
https://www.mathworks.com/products/compiler/matlab-runtime.html
Procedure
1 Start RF Monitor, using the desktop shortcut.
Step result
A notification informs you that RF monitoring is starting, and a new web browser page
opens. If that does not happen, type http://localhost:8090 in the browser to
launch RF Monitor manually.
Step result
The test results are presented in an interactive, graphical form. It is also possible to
save or print the graph.
Figure 85: Test results representation
Site View
Site View shows the BTS hardware and topology, deployed cells, and respective statuses.
You can adapt the view by filtering the content by:
Hardware
Show all
SMODs/BBMODs
External SMODs
External alarm boxes
NMS
ONAP
BTS Controllers
Master Node
Other Node
Fronthaul switches
PWRMODs (FPFHs)
MHAs/LNAs
RETs/RETUs
RAEs/RAEUs
NR Cell Groups
RAT
Show all
NR
LTE
WCDMA
GSM
Radio ports
Show all ports
Show only used ports
It is possible to view alarms in Site View. An alarm raised in a particular unit is indicated by
the icon (the color of the icon represents the severity of the alarm). In case of multiple
alarms, the alarm icon on a particular unit indicates only the highest severity, although there
may be other alarms as well. To see alarms for a given unit, click on the alarm icon. The
information on an alarm appears as a tooltip.
The Export as image icon allows you to save the site view in a PNG format.
At the top of the view there are site action options (from the left):
RAT block and unblock
Reset the site
Block and unblock the site
You can use the icon to block, reset, or remove a unit or block a cell.
Site Report
The Site Report view provides information about:
BTS Properties
This section contains information about hardware and cells, for example: product code,
serial number, status, antenna usage info, TRX or channel information.
SW Release Version
This section provides information about the software versions in use.
The Plug and Play (PnP) tab can be used to visualize autoconnection and autoconfiguration
status, fill in autoconnection parameters, see identification info, and get a PnP raport.
Alarms
The Alarms view contains information about active alarms. Click on the alarm to see the
details. Alarms can be filtered based on severity or RAT.
Software Management
This view shows the software version of the BTS (active, passive, and planned) and
technologies configured on the site.
Click the Rollback... button to switch between active and passive software versions (to
revert to the previously used SW version). The button is disabled if an update or a rollback is
ongoing or passive software version information is not available.
Note:
Only commissioned external alarm and control (EAC) lines can be tested in EAC Functionality
Test.
Faults are used to test external fault lines, if EAC is configured. Select the lines to be
tested in the Selected to test column, and the results are updated when available.
Using the Save Results button allows you to save the results to a TXT file.
Controls are used to test the external control lines. Change the state of the output line
and click Send to send the changes to the BTS. After the BTS has changed the state of the
external control line, check the state of the supervised external device. You can update test
results in the Test result column. Using the Save Results button allows you to save
the results to a TXT file.
The SFP Monitoring tab allows you to view details on optical fiber connectivity between
modules. Optical interface diagnostic data is read from SFP connectors.
This view allows you to monitor online antenna line characteristics such as:
The values of Voltage Standing Wave Ratio (VSWR) for the TX-capable antenna lines
The values of Received Total Wideband Power (RWTP) for LTE and WCDMA
The values of Received Signal Strength Indicator (RSSI) for GSM
To start monitoring, select the antenna line and click the Start button. The Stop button
stops the monitoring. The obtained results can be exported to a CSV file.
This view allows you to download technical log files from the BTS. The snapshot collection
settings allow you to:
select a snapshot coverage - all log files, the most important log files, or health check log
files.
select LTE cells (optional).
input filter keywords (optional).
include a reason for a report (optional).
The Download application logs option allows you to download Web Element Manager
logs that are useful for troubleshooting.
The ADMIN tool was accessible over port 3600. Is Web Element Manager
accessible in the same way?
Starting from release LTE 19/SRAN 17A, Web Element Manager is deployed on default
HTTPS port, 443. Modern browsers do not require the user to provide a port whenever
referring to the default port, so it is possible to open both
https://mplaneIpOrLmpIp:443 or just https://mplaneIpOrLmpIp.
What happens if more than one user executes the same operation at one
time?
In practice, a request comes to the BTS first and it gets executed, while the other requests
get rejected. The user is notified about the fact that their request has been rejected.
Is it possible to see the current number of active data sessions and VoLTE
calls?
In WebEM GUI and WebEM Remote Tool, you can check the average number of active UEs per
cell during the measurement period (15 minutes by default). UE is considered as active if at
least a single non-GBR DRB has been successfully configured for it. The same value can be
obtained by checking the value of counter M8051C57 CELL_LOAD_ACTIVE_UE_AVG.
Does the RUEM log contain login information of the user that triggered an
operation?
Yes, it does.
Why the size of Web Element Manager logs (ims2 file) differs when it is saved
by the application or fetched by the IMSnapshot/Snapshot procedure?
An ims2 file fetched from the BTS is a compressed one.
Is it possible to check what the state of BTS was prior to the connection?
Yes. Once the connection is established, there is a pop-up window in the timeline
component, where the load history is shown for all prior connections.
Is the interface between Web Element Manager and BTS opened and
published?
No. The interface between WebEM and BTS is binary; it is not intended to be used by third
parties. For automatization purposes, WebEM Remote Tool (former BTS CLI) should be used.
Does Web Element Manager support extracting a GSM configuration file for
LTE & GSM sharing feature?
Yes, it does.
SR001749: Antenna Line Online Monitoring from BTS Element LTE 19/SRAN 18 SP
Manager
For more information, see Single RAN Operating Documentation/Single RAN Features/SRAN
Operability Features/Configuration Management/LTE5199/SR002394/5GC001752: Zero
Touch Commissioning UI for WebEM.
columns.
Security
You can configure the maximum number of read-write WebEM users from 1 to 10.
You can check user names of users logged in to WebEM.
Runtime view
You can check if there are any users in a GSM/WCDMA/LTE cell.
You can lock all cells within a technology using a single button.
The SR002856 feature introduces the following enhancements to the Centralized RET
Management view:
Usability improvements for the table:
The rows can be sorted or filtered by the column value.
Note:
Note:
The Icon, ALD ID, and RET Unit ID and status columns are fixed. This means that
they are always displayed as the first three columns, they can't be hidden, and their
width can't be changed.
Note:
The column arrangement and visibility are saved in the browser local storage and
displayed the next time you start WebEM. If there's no information on table
settings in the browser local storage, the default columns and column arrangement
are shown.
The table visible in Centralized RET Management contains the following data:
ALD ID Read-only
Angle Editable
Calibrate Editable
Antennas Read-only
BTS ID Editable
Sector ID Editable
Installer ID Editable
Note:
The Centralized RET Management view is not intended for commissioning RETs.
The SR002856 feature introduces the Configure RTT delay in batch option to the Antenna
Line Settings step in Commissioning Wizard (step-by-step view). By using this option, the
values of the round-trip time (RTT) delay in DL and UL can be set for multiple antenna lines
at once. These values represent the ANTL Antenna round trip delay in upload
path (antennaPathDelayUL) and the ANTL Antenna round trip delay in
download path (antennaPathDelayDL) parameters.
The SR002856 feature introduces new commands for WebEM Remote Tool that allow you
to:
get the RET information available in the Centralized RET Management table from the BTS,
based on RET ID (configured or runtime).
set the RET unit parameters that are editable in the Centralized RET Management table.
For more information on the exact command syntax and description, see Single RAN
Operating Documentation/5G and Single RAN System/Administration Tools/WebEM Remote
Tool.