Eden Net Lte Anr Guide
Eden Net Lte Anr Guide
Eden Net Lte Anr Guide
The information in this document applies solely to the hardware/software product (“Product”) specified herein, and only as specified herein.
This document is intended for use by Nokia' customers (“You”) only, and it may not be used except for the purposes defined in the agreement
between You and Nokia (“Agreement”) under which this document is distributed. No part of this document may be used, copied, reproduced,
modified or transmitted in any form or means without the prior written permission of Nokia. If you have not entered into an Agreement
applicable to the Product, or if that Agreement has expired or has been terminated, You may not use this document in any manner and You
are obliged to return it to Nokia and destroy or delete any copies thereof.
The document has been prepared to be used by professional and properly trained personnel, and You assume full responsibility when using
it. Nokia welcome Your comments as part of the process of continuous development and improvement of the documentation.
This document and its contents are provided as a convenience to You. Any information or statements concerning the suitability, capacity,
fitness for purpose or performance of the Product are given solely on an “as is” and “as available” basis in this document, and Nokia reserves
the right to change any such information and statements without notice. Nokia has made all reasonable efforts to ensure that the content of
this document is adequate and free of material errors and omissions, and Nokia will correct errors that You identify in this document. But,
Nokia' total liability for any errors in the document is strictly limited to the correction of such error(s). Nokia does not warrant that the use of
the software in the Product will be uninterrupted or error-free.
This document is Nokia’ proprietary and confidential information, which may not be distributed or disclosed to any third parties without the
prior written consent of Nokia.
Nokia is a registered trademark of Nokia Corporation. Other product names mentioned in this document may be trademarks of their
respective owners, and they are mentioned for identification purposes only.
Nokia is continually striving to reduce the adverse environmental effects of its products and services. We would like to encourage you
as our customers and users to join us in working towards a cleaner, safer environment. Please recycle product packaging and follow the
recommendations for power use and proper disposal of our products and their components.
If you should have questions regarding our Environmental Policy or any of the environmental services we offer, please contact us at Nokia for
any additional information.
LTE Automatic Neighbor Relations Guide DN09238435 1-0 Table of Contents
Contents
1 Summary of changes...................................................................................................................................... 7
12 Troubleshooting ANR................................................................................................................................127
12.1 ANR tries to create relations that already exist..................................................................................127
1 Summary of changes
• Unblacklisting
– Parameter enforcement
– Rule based ID check
– White list and Black list target frequencies file
• LTE ANR Frequency Rules functional description and guidelines
• LTE ANR Frequency Rules algorithm
• LMS configuration file template for LTE ANR Frequency Rules module
• ANR Blacklisting and Cleanup LTE module events
• ANR 4G IRAT module events
• ANR-4G IRAT module reports
• Example of ANR-4G IRAT configuration file
Added sections:
Added section:
– LTE_IRAT_Neighbor_List_Size_2G
– LTE_IRAT_Neighbor_List_Size_3G
– Buffer_for_detected_neighbors
– Limit_no_of_detected_neighbors
• The note in the Neighbor additions section is modified.
• A note is added to the Overview of LTE ANR section.
• All instances of the LTE ANR Cleanup module are removed from this
document.
• Viewing LTE ANR reports: In the Detected relations table, the Blacklist-
ing? column name is changed to Modification.
Updated sections:
• The ANR Blacklisting and Cleanup LTE module events section is updat-
ed.
• The Blacklisting based on PRACH non-reachable neighbors section is
updated.
• The Cell level records section is updated for the ANR_Blacklisting_and_
Cleanup_LTE module.
• The ANR Blacklisting and Cleanup LTE GUI parameters section is up-
dated.
• The ANR Blacklisting and Cleanup LTE INI parameters section is updat-
ed.
EdenNet 18 SP1 1811 A note is removed from Viewing SON change reports.
EdenNet 18 FP1 The Exclude_indoor_cells parameter is added to the ANR 4G IRAT INI
parameters section.
• A note about the Tier column is added to the ANR-4G IRAT module
reports, LTE ANR Cleanup module reports, and ANR Blacklisting and
Cleanup LTE module reports sections.
• Cell Level Summary and Cell level records tables are added to the
ANR-4G IRAT module reports section.
• A note is added to the Cleanup based on handover section.
• Added the Execution flow of ANR Blacklisting and Cleanup LTE module
section.
• Added the Provisioning Details table to the ANR Blacklisting and
Cleanup LTE module reports section.
• The Use_modified_CGI_for_ericsson_external_cell_DN pa-
rameter is added to the ANR 4G IRAT INI parameters section.
• The below parameters are added to the ANR Blacklisting and Cleanup
LTE INI parameters section:
Updated content:
EdenNet 17 SP1 FP1 The Open loop mode section is updated with the below information which is
applicable to the ANR 4G IRAT module:
• Open loop mode with deferred provisioning (only for NAdC integration)
The below INI parameters are added to the ANR Blacklisting and Cleanup
LTE INI parameters section:
• Maximum_blacklisting_changes_per_execution
• Allow_processing_after_maximum_changes_to_push_
reached
• Log_warnings_in_Logs_tab
The below GUI parameters are added to the ANR-4G IRAT GUI parameters
section.
EdenNet 17 SP1 The ANR 4G IRAT INI parameters section has been updated with some new
parameters:
• Enable_trimming
• KPI_data_reliability_threshold
• Maximum_allowed_UARFCNs_for_LTE_IRAT_neighbor
• Maximum_count_redirWithSysInfoAllowed_lnrelw
• Maximum_count_redirWithSysInfoAllowed_lnrelg
• Neighbor trimming
• Whitelisting and blacklisting
Module Monitor Service information has been added under the section Mon-
itoring LTE ANR modules.
The ANR Blacklisting and Cleanup LTE INI parameters section has been
updated.
The ANR Blacklisting and Cleanup LTE module reports section has been
updated.
The ANR Blacklisting and Cleanup LTE module reports section has been
updated.
The LTE ANR Cleanup module reports section has been updated.
EdenNet 17 The document has been restructured. The new sections are:
• Neighbor replacements
• ANR-4G IRAT GUI parameters
• Common INI parameters
• ANR-4G IRAT module logs
EdenNet 16 SP2 A new section is added: Example for LMS configuration file
EdenNet 16 This is a new document that provides information on how to optimize net-
work performance by automating the task of managing neighbor relations.
Configuration and management of neighbor relation lists is one of the most labor intensive areas in the
cellular network configuration, especially in mature networks, during network expansion. Automating
the task of configuring and managing neighbor relations results in substantial cost savings for opera-
tors and improves network performance.
EdenNet supports the following LTE ANR (Automatic Neighbor Relations) modules:
• ANR Blacklisting and Cleanup LTE - optimizes network performance by identifying the poorly per-
forming neighbors and blacklisting these neighbors (includes LTE to LTE neighbors and Inter-RAT
neighbors).
• LTE ANR Frequency Rules - automates creation of inter frequency related objects by enabling
handover and idle mode mobility in the LTE network.
• ANR 4G IRAT - optimizes the IRAT neighbor list of LTE cells towards 3G and 2G cells for connect-
ed mode handover.
Note:
Nokia only supports the use of AC based integration for Nokia, Ericsson, and Huawei ven-
dors as direct CM integration is deprecated from EdenNet 21 release onwards for these ven-
dors.
It supports blacklisting and cleanup of intra-LTE, LTE to WCDMA, and LTE to GSM neighbor relations:
• Intra-LTE neighbor relations are evaluated against their handover performance based on user de-
fined criteria, to blacklist the handover service.
• LTE to WCDMA neighbor relations are evaluated against the performance of their mobility ser-
vices, such as SRVCC (Single Radio Voice Call Continuity) and CSFB/PSHO (Circuit Switched
FallBack/Packet Switched HandOver), to blacklist the corresponding mobility service.
• LTE to GSM neighbor relations are evaluated against the performance of the SRVCC mobility ser-
vice.
This module also supports automatic unblacklisting of the handover or mobility service after a defined
period or as per the defined operator policy.
It also supports blacklisting and cleanup based on distance, tier count mechanism, and cell pairs de-
fined in the CSV file. Additionally, Intra-LTE neighbors can also be blacklisted based on PRACH (Phys-
ical Random Access Channel) non-reachable criteria. Whenever KPIs are used for evaluation, the reli-
ability factor can also be defined so that blacklisting actions are taken using reliable KPIs.
It automates the blacklisting and unblacklisting of neighbor relations, and thereby optimizes the neigh-
bor relations in the LTE network.
Note: In the EdenNet UI, the user has an option to blacklist and whitelist relations. With re-
spect to the ANR_Blacklisting_and_Cleanup_LTE module, blacklisting indicates setting han-
dover to forbidden.
It evaluates the handover or mobility performance of LTE neighbor relations for a given monitoring pe-
riod, keeping track of the number of consecutive blacklisting operations performed on a given neigh-
bor relation, and automatically deciding to either unblacklist the handover or mobility service after a
defined period, or continuing to blacklist the given neighbor relation.
It removes neighbor relations from LTE ANR neighbor lists if the Deletion of neighbors use case is se-
lected. The relation to be removed can be specified in one of two ways:
• Clean-up of intra-LTE neighbor relations: Intra-LTE neighbor relations are evaluated against their
handover performance (based on user defined criteria) to clean-up the neighbor relations.
• Neighbor relation clean-up based on distance, tier count mechanism, and cell pairs defined in the
CSV file.
It does not attempt to block the LTE distributed ANR function from adding the removed neighbors once
again.
It also prevents the ping-pong behavior of removing and adding certain neighbor relations between the
ANR Blacklisting and Cleanup LTE module and the ANR function of distributed SON by RAN vendors.
• Identifying all LTE neighbor relations in the scope that match the rules specified by the operator.
• Importing neighbor relations to be deleted, blacklisted, or unblacklisted via a neighbor relation file.
• Keeping track of consecutive deletions performed on a given neighbor relation to decide whether
to automatically blacklist or continue deleting a given neighbor relation.
• Keeping track of consecutive blacklisting operations performed on a given neighbor relation to
decide whether to automatically unblacklist or to continue blacklisting a given neighbor relation.
• Preventing autonomous deletion of blacklisted neighbor relations.
• X2 blacklisting on specific neighbor relations can be applied by providing neighbor relation files
and enabling X2 blacklisting.
Table 2: ANR Blacklisting and Cleanup LTE module supported vendors and technologies lists the sup-
ported vendors and technologies for the ANR Blacklisting and Cleanup LTE module.
Vendor Technology
Nokia LTE
Ericsson LTE
Huawei LTE
Vendor Technology
ZTE LTE
Table 2: ANR Blacklisting and Cleanup LTE module supported vendors and technologies
2.1.1.1 Dependencies
This module modifies the parameters of LTE neighbor relations, and does not affect other services
in the network. However, scheduled operator activities or other modules modifying the same LTE
neighbor relations should not be executed in the closed loop, at the time this module is implementing
changes to the network.
2.1.1.2 Interactions
User equipment based ANR Distributed SON feature: Once neighbor relations are blacklisted in the
network, measurements are not recorded against the corresponding neighbor relations. Nokia eNBs
can automatically monitor the performance of neighbor relations, and if the relations do not meet
the performance requirements, the neighbor relations are automatically deleted. Hence, blacklisted
neighbors are perceived as under performing and are removed by the eNB. The ANR Blacklisting and
Cleanup LTE module protects blacklisted neighbors from automatically getting deleted by the eNB by
setting the Remove Allowed parameter to false for blacklisted neighbors, thereby avoiding repeated
creation and deletion of blacklisted neighbors.
This module performs the following functions for LTE cells in the selected scope:
• Identifying all the frequencies used by surrounding cells within the search distance
• Creating inter frequency handover and idle mode mobility objects based on the:
• Frequencies match with the frequency Layer Management Strategy (LMS) defined in the
LMS configuration file. For more information, see LMS configuration file template for LTE
ANR Frequency Rules module.
• Deleting inter frequency handover and idle mode mobility objects based on the:
Inter frequency handover and idle mode mobility objects are configured in the scope of LTE cells by
searching other LTE, WCDMA and GSM frequency layers which are nearby. These objects, specific to
a frequency, enable user equipment in the cell to begin searching for neighboring cells operating in the
corresponding frequency, thereby enabling inter frequency handovers and idle mode cell reselection.
This module enables a UE based ANR in the eNB to add inter-frequency neighbors during connected
mode, and enable cell reselection towards cells operating on different frequencies. Nokia eNBs send
both LTE and WCDMA frequency information to the UEs to scan for potential neighbors in the sur-
roundings.
Note:
• In open-loop mode, the module identifies frequency layers used in the surrounding LTE, WCD-
MA, and GSM cells with respect to the scope cell, but no changes are applied to the network. The
module output consists of a report listing the source cell and its inter-frequency handover, and idle
mode mobility objects that the module has identified based on the user defined settings.
• In closed loop, the changes are applied to the network. The module can be run in closed loop
mode on a weekly basis.
Table 3: LTE ANR Frequency Rules module supported vendors and technologies lists the supported
vendors and technologies for the LTE ANR Frequency Rules module.
Vendor Technology
Nokia LTE
Table 3: LTE ANR Frequency Rules module supported vendors and technologies
2.2.1.1 Dependencies
This module configures inter frequency handover and idle mode mobility related objects, and does not
affect other services in the network. However. scheduled operator activities modifying the same inter
frequency handover and idle mode mobility objects should not be executed at the time that this mod-
ule is implementing changes to the network.
2.2.1.2 Interactions
This module enables UE based ANR (distributed SON feature) in the eNB to add inter frequency
neighbors during connected mode, and enable cell re-selection towards cells operating on different
frequencies. Nokia eNBs support UE based ANR for adding intra LTE and LTE to WCDMA neighbors.
Nokia eNBs send both LTE and WCDMA frequency information to the UEs to scan for potential neigh-
bors in the surroundings.
2.2.2 LMS configuration file template for LTE ANR Frequency Rules module
The LTE ANR Frequency Rules module uses an Layer Management Strategy (LMS) to check if there
is a rule to create frequency objects between two frequencies. If it exists, the template is used to set
the frequency object attributes.
Note: This template is used only for the LTE ANR Frequency Rules module.
The template to create frequency rules under existing LTE cells to the newly introduced frequency lay-
er is as follows:
“frequency_relations": {
<frequency layer>": {
}
3. Define a template to set the attribute values of the created frequency objects.
"templates": {"<template_name>_<frequency layer>":
{"<parameter>":"<value>"} }
For example,
“filter”: “<target_filter_name>”} }}
5. Define the filter.
"filters": {
"enodeB": {
},
“target_filter_name”: {
For example:
"filters": {
"enodeB": {
"dn": ".+/LNBTS-([0-9]+)$" }
“lnhoif”: {
“target”: “LTEConectedMode”
}
6. Define rules allowing frequency objects from LTE to frequency layer 19500.
7. Define a template to set the attribute values of the created frequency objects.
For example:
"filters": {
Note: Use the target filters in Table 4: Key description to define the target frequency objects
allowed by the LMS.
Key Description
For example, to create frequency rules for the newly introduced frequency layer 19500 from source
18500 for LTE connected mode object:
"filters": {
“lnhoif”: {
“target”: “LTEConectedMode”
}
}
"layers":{
"F18500": {"earfcn": "18500"},
If the attribute name specified in the template is applicable to the frequency object being created (in
the above example LTE to LTEConectedMode, frequency objects created are LNHOIF objects),
the value specified is used instead of the default value configured in the module template file for that
object.
The LMS file is imported into EdenNet using the Administration tab. For more information, see the
Configure and monitor SON modules section in the EdenNet User and Administration Guide docu-
ment.
Note: The LMS template is mandatory for the creation of frequency objects. See Table 5:
Mandatory parameters for frequency objects per version to identify the mandatory parame-
ters required for each object per version.
sAntP, Ger
qRxLevMinIn-
terF
The ANR-4G IRAT module performs the following functions for the LTE IRAT neighbor list:
Note:
If the relations are created manually, the changes are reflected in EdenNet after a few hours.
The timings for the relation MO update per vendor are:
• Huawei: 12 hours
• Ericsson: 4 hours
• Nokia: 4 hours
• ZTE: 6 to 12 hours
If ANR is triggered before the synchronization, the module may propose the same relations
which are added manually and implementation may fail.
Table 6: ANR-4G IRAT module supported vendors and technologies lists the supported vendors and
technologies for the ANR-4G IRAT module.
Vendor Technology
Nokia LTE
Vendor Technology
Ericsson LTE
Huawei LTE
ZTE LTE
In a cross-OSS phase 3B environment, the mandatory dependent managed objects (frequency MOs)
required by the ANR relations are created by NAdC (NetAct Advanced Configurator) for all vendors.
2.3.1.1 Dependencies
The EdenNet Reuse Code Optimization module may cause PCI changes and neighbor relation re-
movals. However, these changes are reflected immediately in the EdenNet cache and are therefore
considered by the ANR modules.
2.3.1.2 Interactions
Each cell in the network should be included in not more than one ANR closed loop instance, since up-
dates of the cache for the cell in one module instance can occur in the middle of the decision making
process for the other module instance. Manual neighbor relation additions, removals, or changes from
tools outside of EdenNet should not be permitted, or else they should be very carefully planned when
the ANR modules are running in closed loop in a network area. These neighbor changes will not be
immediately visible in the EdenNet cache, and therefore non-optimal decisions in the ANR modules
may result. The ANR modules are the only EdenNet modules that add neighbor relations. Therefore,
no interactions with other modules are expected in terms of neighbor additions.
• UMTS are determined either by pattern matching on the cell name or from the UARFCN.
• GSM are determined from the band information obtained from the CM data.
For further information about the LMS, see the EdenNet LMS Configuration File Guide.
Figure 1: Overview of LMS sections provides an overview of the main sections of the LMS used for the
ANR-4G IRAT module.
An example of row rules used for sites with LTE cells is given below:
row rules
"row rules": {
"optional_LTE_row_rule_P1P2U1": {
"P1": { "condition" : { "name": "majority" }, "hop": { "template":
"lte_umts" } },
"P2": { "condition" : { "name": "majority" }, "hop": { "template":
"lte_umts" } },
"U1": { "condition" : { "name": "majority" }, "hop": { "template":
"lte_umts" } },
"GSM1900": { "condition" : "always", "hop": { "template": "lte_gsm" } }
},
"optional_LTE_row_rule_P1U1U2": {
"P1": { "condition" : { "name": "majority" }, "hop": { "template":
"lte_umts" } },
"U1": { "condition" : { "name": "majority" }, "hop": { "template":
"lte_umts" } },
"U2": { "condition" : { "name": "majority" }, "hop": { "template":
"lte_umts" } },
"GSM1900": { "condition" : "always", "hop": { "template": "lte_gsm" } }
}, …
layers
For Nokia, the P1, P2, and U1 layers are defined by the cell name in the layers section of the LMS
configuration file. The GSM layer is defined by technology.
"layers": {
"U1": { "name": "^U.*1$" },
"P1": { "name": "^P.*1$" },
"P2": { "name": "^P.*2$" },
"GSM": { "technology": "GSM" } …
For Ericsson, all IRAT cells are external and it is necessary to define separate layers for UMTS from
the perspective of LTE. These layers must be defined in terms of UARFCN since there is no cell name
in the external cell definitions (the userLabel is available, but this is just a free text field). All UARFCN
to which LTE IRAT relations will be defined must be specified. Use an OR condition if more than one
UARFCN is used for a layer.
"layers": {
"U1": { "name": "^U.*1$" },
"P1": { "name": "^P.*1$" },
"P2": { "name": "^P.*2$" },
"LTE_U1": { "or": [ { "uarfcn": 2062 }, { "uarfcn": 1937 } ] },
"LTE_U2": { "uarfcn": 2087 },
"LTE_P1": { "or": [ { "uarfcn": 462 }, { "uarfcn": 487 } ] },
"GSM": { "technology": "GSM" } …
rules
All sites in the area to be optimized must fall into only one of the site types defined in the rules
section of the LMS. The example below shows the LMS for a site with P1 and P2 UMTS cells and
optional LTE and GSM cells. When LTE cells exist on this site type, then IRAT relations can be defined
as described in the optional_LTE_row_rule_P1P2U1.
"rules": {
"P1P2": {
"P2": {
"P2": { "condition" : { "name": "intra" }, "hop": { "template":
"intra" } },
"P1": { "condition" : { "name": "local" }, "hop": { "template":
"basic2" } }
},
"P1": {
templates
The attribute values to be used for each allowed neighbor relation type are defined in the templates
section of the LMS configuration file. These attribute values should be checked to confirm their
accuracy. An example is given below for setting the mandatory parameters for LNRELW and LNRELG
(Nokia from LTE15A onwards) to operator defined defaults:
"templates": {
"lte_gsm": {
"nrControl": "automatic",
"eNACCAllowed": "allowed",
"srvccAllowed": "allowed"
},
"lte_umts_p": {
"nrControl": "automatic",
"csfbPsHoAllowed": "forbidden",
"psHoAllowed": "allowed",
"srvccAllowed": "allowed",
"removeAllowed": "true",
"utranLbAllowed": "true"
},
"lte_umts_u": {
"nrControl": "automatic",
"csfbPsHoAllowed": "allowed",
"psHoAllowed": "allowed",
"srvccAllowed": "allowed",
"removeAllowed": "true",
"utranLbAllowed": "true"
},
"enodeB_UMTS": {
"srvccHoInd": "CSonly"
},
"enodeB_GSM": {
"dtm": "FALSE",
"networkControlOrder": "NC0",
"systemInfoType": "none"
}
}
Note:
For Nokia, there are some limits on the number of relations that can have certain attribute
value settings.
Parameter Default
srvccAllowed allowed
csfbPshoAllowed forbidden
psHoAllowed allowed
removeAllowed true
utranLbAllowed false
• psHoAllowed and srvccAllowed of LNRELW - All the existing and newly added relations
of the optimized cell (where relations have been added and removed) are ranked and the
first 32 relations per operating frequency are set to allowed for the LTE-WCDMA case.
• Blacklisting
Blacklisting of intra-LTE neighbors is based on the handover performance against the user de-
fined threshold. The rules for analyzing the performance are configurable and the user can
blacklist neighbors based on the following requirements:
• Minimum HO attempts
• Maximum HO attempts
This module also supports blacklisting based on distance and tier count mechanism.
If there are two neighboring cells whose PRACH settings do not match the actual geographi-
cal distance between the cell’s antennas, any handover occurrence between the two cells has
a high risk of failure. Such neighbors are called PRACH non-reachable neighbors.
If you specify the neighbor relations to be removed via a file, the module only removes those
neighbors.
• Un-blacklisting
– KPI based automatic verification and unblacklisting: After blacklisting, the module checks
the customer defined KPIs (defined in INI) and initiates unblacklisting on the cells where KPI
degradation was detected. The module unblacklists the relations blacklisted by the module on-
ly if the cell's KPIs are degraded.
Once neighbor blacklisting runs, relations are un-blacklisted when the timer expires.
• Clean-up
This module supports clean-up of intra-LTE neighbor relations. Intra-LTE neighbor relations
are evaluated against their handover performance based on user defined criteria to clean-up
neighbor relations.
• identifies all the frequencies used by surrounding cells within the search distance.
• ensures that inter-frequency handover and idle mode mobility objects are defined in the frequency
object creation or deletion file.
• creates inter frequency handover and idle mode mobility objects based on the layer management
strategy defined in the LMS configuration file specific to this module.
Frequency rule creation is the primary functionality of this module. For the given target cells, the mod-
ule obtains all the neighbors in the given radius, and if the LMS permits creation of inter-frequency ob-
jects, it creates the appropriate object for the target cell.
Managed objects can also be created for frequency rules by providing a CSV file input. The CSV file
should contain a comma separated list of source cells and target cells (using the cell's label) in each
row.
For the given target cells, the LTE ANR Frequency Rules module obtains all the neighbors in the given
radius. If the source cell contains a frequency relation which is not part of the neighbor cell frequency,
delete the frequency relation.
For the given target cells, the LTE ANR Frequency Rules module obtains all the existing frequency ob-
jects. If any of these existing objects is not allowed in the LMS, the frequency objects are deleted.
For the given target cells, the LTE ANR Frequency Rules module obtains all the existing frequency
objects. If the Parameter enforcement GUI parameter is set to Audit_and_Enforce, then
the parameters of the existing frequency objects are updated according to the LMS template. If
the Parameter enforcement GUI parameter is set to Ignore, the existing parameters are not
updated. However, creations occur with the LMS template provided.
Managed objects can also be whitelisted or blacklisted for frequencies, by providing a CSV file input.
The CSV files should contain a comma separated list of source cells, frequencies to be whitelisted or
blacklisted, technology, and whitelist/blacklist in each row. The whitelisted frequencies (if not present)
are created for the respective technology or retained (if they already exist). The blacklisted frequencies
are deleted (if present) or not created (if not present).
The module retrieves the configuration information from the EdenNet configuration management
cache. It does not force any reading from the OSS for data in the cache that has been modified, or that
has expired. However, any changes made by EdenNet through previous successful closed loop itera-
tions of the module are immediately reflected in the EdenNet configuration management cache.
Open loop mode with deferred provisioning (only for NAdC integration)
When the ANR 4G IRAT module runs in open loop mode, the plan is visible under SON Modules →
Status → Provisioning Logs.
• When the module run is successful, an entry appears in the provisioning logs area. The provision-
ing status is set as waiting till the plan is provisioned or till it expires.
• A user with closed loop permissions for the ANR module can provision the plan immediately, or
schedule it to be provisioned later.
• When a plan is scheduled, the provision status will be changed to Scheduled. For direct OSS inte-
gration, open loop does not generate a plan.
• If the cells in the plan are a part of the SON module exclusion list, or if they are not a part of the
user’s geofence, the plan will not be provisioned. In such cases, the status remains as waiting and
even the scheduled plans are moved to waiting status.
• The validity of the plan is for a period of 24 hours. The plan validity period can be configured. The
plan expires after the validity period and the user is not allowed to provision the plan.
For more details, see the Editing plan lifetime validity for open loop section in the EdenNet User
and Administration Guide document.
• The user can reschedule and cancel schedules.
After running the same algorithm as in open loop mode, the recommended changes are pushed to the
live network. Since any changes made by EdenNet through previous successful closed loop iterations
of the module are immediately reflected in the EdenNet configuration management cache, when Eden-
Net is solely in control of neighbor relation operations, the module always works with the latest config-
uration information.
Periodic updates of relevant managed objects are also performed according to the configured sched-
ule. Typically, these are every hour for cell level managed objects and every four hours for neighbor
relation managed objects.
Note: The LTE ANR Frequency rules module only runs one time. If repeated executions are
required, this module must be run manually, or scheduled.
The ANR Blacklisting and Cleanup LTE module and ANR 4G IRAT module are iterative
in closed loop mode. Once started, the modules run indefinitely (until they are stopped
manually or a scheduled end-time is reached). When an execution is complete, the
modules enter an idle state until another execution is automatically triggered at the
start of the next 15 minute period. Irrespective of the value set for the parameter
TimeBetweenPushes_15Mins, the modules iterate every 15 minutes to check if the
intended ROP (Report Output Period) is met and then decide whether or not to continue that
iteration.
The default time between iterations of the module running and pushing changes in closed loop is 15
minutes. However, the configuration parameter TimeBetweenPushes_15Mins can be modified to
limit how often this module runs after pushing changes. TimeBetweenPushes_15Mins = 4 means
the module pushes changes a maximum of once per hour in closed loop.
This module is not iterative if the CSV file is imported using blacklisting, unblacklisting, or neighbor
deletion file options.
1. In the first iteration, the module proposes the neighbors to be blacklisted based on the provided
constraints such as tier, distance, HO attempts, HO success, expected cell range, and so on.
2. All the proposed changes are provisioned to the network if the module runs in closed loop. For the
successfully provisioned relations, the provision time will be updated in the module data. In case of
partial provisioning, the module updates the time for the successfully implemented relations and ig-
nores the failed relations.
3. The module is re-triggered every 15 minutes as per the EdenNet framework. The pro-
cessing of each run depends on the configured value and provision time of the parameter
TimeBetweenPushes_15Mins. If TimeBetweenPushes_15Mins is 4, the module is processed
once every hour. The other three triggers are skipped.
4. In further iterations, the value configured for KPI_Time_Window_Eval (in hours) is checked
against the blacklisted time for the relation. If the blacklisted time has expired, the source cell is
considered for unblacklisting evaluation.
5. The KPI degradation is checked against the post and pre-optimisation window based on
KPI_Time_Window_Eval and the time that the relation was blacklisted.
The configured KPI from the operator policy is fetched during this time window and compared for
degradation as per the operator policy. The relation is unblacklisted if the KPIs are degraded. The
Reason for Unblacklisting column in the Unblacklisting tab specifies whether the relation is black-
listed based on KPI degradation or timer expiry.
6. If the KPI is not degraded, the Blacklist duration is checked - it can be Ignore or 1-23.
If the time duration is selected, the relation is blacklisted based on the specified number of hours
and it is unblacklisted once the timer expires.
If the Blacklist duration is set to Ignore, only KPI based unblacklisting is performed.
• Poorly Performing Neighbors: This represents a case where several attempts are recorded but
the handover performance is not as expected. In this case, blacklisting is achieved by selecting
Minimum HO attempts in HO criteria and Maximum HO success rate in HO success
rate criteria. The handover success ratio is lower than the given threshold whereas the han-
dover attempts are higher than the given threshold.
• Rarely used Neighbors: This represents a case where low attempts are recorded even when
several attempts are successful. In this case, blacklisting is achieved by selecting Maximum HO
attempts in HO criteria and Ignore in HO success rate criteria. The handover
success ratio is higher than the given threshold but handover attempts are lower than the given
threshold.
This module also considers tier and distance to identify the poorly performing neighbors and rarely
used neighbors:
• The tier count between the source cell and the candidate must be greater than or equal to the
Minimum tier count configuration setting.
• The absolute distance (in kms) between the source and target cell must be greater than or equal
to the Minimum distance configuration setting.
Intra-LTE blacklisting requires the following KPIs to be retrieved for daily, weekly, and hourly
summarization levels: (The KPI monitor period configured for the KPI data which is available
during the last defined number of days from the module execution time will be considered for
computation.)
LTE-WCDMA neighbor relation blacklisting can be performed on SRVCC (Single Radio Voice Call
Continuity) and PSHO/CSFB (Packet Switched Handover/Circuit Switched Fallback) mobility types
and requires the following KPIs:
Note:
• LTE to WCDMA and LTE to GSM Handover KPIs are not available for the fALU vendor.
• KPI evaluation is ignored if the HO criteria is enabled in the module when fALU cells are
in the scope or when fALU cells are the neighbors.
For example, LTE cells in Nokia which have neighboring relations with fALU WCDMA or
GSM.
SRVCC service blacklisting sets Single Radio Voice Call Continuity allowed to
forbidden. PSHO/CSFB (Packet Switched Handover/Circuit Switched Fall-back) service blacklisting
sets PSHO allowed and Circuit-switched fall-back with PS handover allowed to
forbidden.
LTE-TD SCDMA neighbor relation blacklisting can be performed on PSHO/CSFB mobility type and re-
quires the following KPIs:
The TD-SCDMA target cells are modeled as external WCDMA cells (instances of MOC EXUCE),
where the PSC (Primary Scrambling Code) is set to the otherwise reserved value 65535, that is,
EXUCE::PSC = 65535.
PSHO/CSFB service blacklisting sets PSHO allowed and Circuit-switched fall-back with
PS handover allowed to forbidden.
LTE-GSM neighbor relation blacklisting can be performed on SRVCC mobility type and requires the
following KPIs:
SRVCC service blacklisting sets Single Radio Voice Call Continuity allowed to
forbidden.
In the UI, users should be able to configure the percentage value of the Reliability Threshold. This
threshold should be considered during KPI retrieval such that the duration for which KPIs are available
should be compared against the reliability threshold. If the total sum of the period duration is less than
the (monitor period * KPI reliability threshold) then the KPI should be considered as missing and the
corresponding neighbor relation should be excluded from blacklisting and cleanup.
For example, if the monitor period is 1 day (24 hours or 1440 minutes) and the KPI reliability thresh-
old is 80%, then the sum of the durations for a given KPI should be greater than 19.2 hrs (24 * 0.8) or
1152 minutes (1440 * 0.8), so that the KPI is considered for evaluation. The KPI reliability threshold is
a common threshold across all the KPIs used for blacklisting and cleanup, and has to be used for all
KPIs individually.
• Distance indicates the distance between the source cell and target cell. If the source cell and tar-
get cell have multiple antenna locations, the distance from all the antenna locations is calculated
and the minimum value is returned.
• Tier Count indicates the tier count between the source cell and target cell. If the cell coverage type
is indoor, then the tier count can be +1.
The Tier Count between the source cell and the candidate must be greater than or equal to the
Minimum tier count configuration setting.
• The absolute distance (in kms) between the source and target cell must be greater than or equal
to the Minimum distance configuration setting.
Note: The relation will be blacklisted only if all the provided constraints such as Tier,
Distance, HO attempts, HO success, and Expected Cell Range (PRACH based) are met. If
any constraint is set to Ignored, that constraint will not be considered during blacklisting.
4.1.5 Unblacklisting
Currently, KPI based verification and unblacklisting is available using the
ANR_Blacklisting_and_Cleanup_LTE module.
Blacklisting and cleanup instances are designed to run continuously in closed loop, with verification
carried out every hour. KPI_Time_Window_Eval is the parameter in the configuration file
that defines the period. When rollback occurs, it unblacklists all the relations blacklisted by the
ANR_Blacklisting_and_Cleanup_LTE instance in the previous verification period.
The duration for which a neighbor relation has to be blacklisted can be specified in Blacklist
duration. The blacklisted neighbor relation is eligible for unblacklisting only after the elapse of the
blacklist duration. The unblacklisted relation can be blacklisted again. The user can increase the
blacklist duration to the Increased blacklist duration of neighbor relations that have been
consecutively blacklisted and unblacklisted to a value greater than the specified value of Increased
blacklist trigger count.
To disable time based unblacklisting, set Ignore in the Blacklist duration. Once time
based unblacklisting is ignored, relations are unblacklisted based on KPIs. Relations can also be
permanently blacklisted by setting Permanent in the Increased blacklist duration to avoid
ping pong behavior.
During unblacklisting, when amleAllowed is set to True for a relation, handoverAllowed is set to
Allowed and removeAllowed is set to False.
Removal of intra-LTE neighbors is based on the handover performance against the user defined
threshold. The rules for analyzing the performance are configurable and the user can blacklist based
on:
• Poorly Performing Neighbors: represent a case where several attempts are recorded but handover
performance is not as expected. Blacklisting can be achieved by selecting Minimum HO at-
tempts in HO criteria and Ignore in HO success rate criteria. The Handover suc-
cess ratio is lower than the given threshold whereas the handover attempts are higher than the
given threshold.
• Rarely used Neighbors: This represents a case where low attempts are recorded even when more
attempts are successful. Blacklisting can be achieved by selecting Maximum HO attempts in
HO criteria and Ignore in HO success rate criteria. The handover success ratio is
higher than the given threshold but handover attempts are lower than the given threshold.
It also considers tier and distance to identify the poorly performing neighbors:
• The Tier Count between the source cell and the candidate must be greater than or equal to the
Minimum tier count configuration setting.
• The absolute distance (in kms) between the source and target cell must be greater than or equal
to the Minimum distance configuration setting.
If the relation is blacklisted or blocked, the module will not remove such relations.
For all neighbors identified for removal, the module keeps track of consecutive removals and checks if
the neighbor has been removed by the module previously.
If the number of removals reaches the configured threshold value over a configured period, the mod-
ule blacklists the neighbor instead of removing the neighbor from the neighbor list.
Maximum number of repeated neighbor removal is the neighbor relation deletion count of
a cell which the module monitors, and if it exceeds the defined number during the defined neighbor
removal monitoring period, that is, Neighbor removal monitoring period, the neighbor is
blacklisted instead of being removed.
Note: If the neighbor is blacklisted instead of being removed, the module generates two sep-
arate plans - one for blacklisting and another one for cleanup.
Each row is a neighbor relation. The first cell name corresponds to the source cell. The second cell
name corresponds to the target cell that needs to be blacklisted, unblacklisted, or removed from the
neighbor list.
4.1.8.1 Cross OSS support for ANR Blacklisting and Cleanup LTE (with NAdC)
The ANR Blacklisting and Cleanup LTE module supports the optimization of neighbor relations across
OSS boundaries.
4.1.8.2 Cross OSS support for ANR Blacklisting and Cleanup LTE (without NAdC)
The ANR Blacklisting and Cleanup LTE module is not enhanced to support Cross OSS functionality
without NAdC integration.
When the operator introduces a new frequency layer in the LTE network, the new LTE Inter-frequen-
cy neighbors are created only after the network directs the UEs to monitor these inter-frequencies. The
eNodeB can direct the UE to monitor inter-frequencies only if the respective inter-frequency objects
are created by the LTE ANR Frequency Rules module. Then the inter frequency UE based ANR and
idle mode mobility begin to function in the network. In the Nokia LTE network, LNHOIF and IRFIM ob-
jects need to be created and sent to the eNB if Inter-LTE frequencies have to be monitored.
For each target LTE cell, it retrieves all the neighbors (Intra-LTE, LTE-WCDMA and LTE-GSM)
in the given Inter Frequency neighbor radius from the target cell and filters the existing
inter-frequency objects for the target. The module checks if there are any frequency objects for this
neighboring cell frequency, and if the LMS configuration allows a new frequency object under the
target cell for this neighboring frequency. If frequency objects do not exist, it generates a Managed
Object DN and creates the frequency object of the neighboring frequency, as long as it does not
exceed the maximum number of that object.
Users can import the object deletion file under the Frequency Object Deletion File option. They can
import the object creation file under the Frequency Object Creation File option in the GUI.
An example of the frequency object creation file (CSV file) that can be imported for the LTE ANR Fre-
quency Rules module to list the frequency objects to be created in the source cell for the frequency of
the corresponding target cell is defined in Table 9: Example of frequency object creation file format.
LCH48857B21 LCH32931A31
LCH48857B11 LCH32931A11
Each row is a cell pair - the first cell name corresponds to the source cell; the second cell name corre-
sponds to the target cell. Frequency objects are created if the LMS configuration file allows creation of
objects across frequency layers.
An example of the frequency object deletion file (CSV file) that can be imported for the LTE ANR Fre-
quency Rules module to list the frequency objects to be deleted in the source cell for the given fre-
quency is defined in Table 10: Example of frequency object deletion file format.
Frequency channel
Source cell Technology Frequency band
number
LCH48857B21 4G 19500
LCH48857B11 3G 1000
Each row consists of the cell name, technology, frequency channel number, and frequency band (for
2G technology only), depending on the technology.
In the following cases, the LTE ANR Frequency Rules module does not take any action and the output
report file includes the following reasons:
4.2.3 Frequency rule deletion through user distance input and LMS
For the given target cells, the LTE ANR Frequency Rules module obtains all the neighbors in the giv-
en radius, and if the LMS does not permit the creation of inter-frequency objects, it deletes the exist-
ing frequency object for the target cell. If the target cell has a frequency relation which is not part of the
neighbor cell frequency, the frequency relation is deleted.
For each target LTE cell, it retrieves all the neighbors (Intra-LTE, LTE-WCDMA and LTE-GSM) in the
given Inter Frequency neighbor radius from the target cell. If any of the existing frequency objects
have frequencies outside the given radius, the frequency objects are deleted. The LTE ANR Frequen-
cy Rules module checks if there are any frequency objects for this neighboring cell frequency, and if
the LMS configuration does not allow the frequency object under the target cell, the frequency object is
deleted.
For each target LTE cell, it retrieves all the neighbors (Intra-LTE, LTE-WCDMA and LTE-GSM) in
the given Inter Frequency neighbor radius from the target cell. The LTE ANR Frequency Rules
module then obtains all the existing objects for the target cell. If the Parameter enforcement GUI
parameter is set to Ignore, the existing parameters are not updated. However, new frequency objects
are created with the LMS template.
Note: This feature is supported only for intra-LTE and LTE-WCDMA connected and idle
mode objects. It is not supported for LTE-GSM and FreqRDRT objects.
If the Rule based ID check GUI parameter is set to Ignore, the LTE ANR Frequency Rules
module falls back to the sequential ID based creation of frequency rules.
If the Rule based ID check GUI parameter is set to Skip (if any frequency is already existing
with a different instance ID or if the instance ID is used by another existing frequency), the LTE ANR
Frequency Rules module skips such cases and only tries to perform the creation of frequency rules
based on the given instance ID for non-conflicting frequencies. For conflicting frequencies and for
frequencies where no instance ID is mentioned in the LMS template (that are not already created), the
LTE ANR Frequency Rules module follows sequential ID based creation of frequency rules.
If the Rule based ID check GUI parameter is set to Delete_and_Recreate, even if there are
conflicting frequency rules existing, the LTE ANR Frequency Rules module tries to delete and recreate
the same with the required instance ID.
The MO types supported for instance ID based creation are LNHOIF, IRFIM, LNHOW, and UFFIM. In
the corresponding LMS template, the instance ID must be given in the format <MO_NAME>ID.
For LNHOIF, IRFIM, and LNHOW, ensure that no two frequencies are requesting the same instance ID
in the LMS template.
For UFFIM, all frequencies must request the same ID as only one MO (that can have multiple frequen-
cies) is created.
Note:
• The instance ID must be a non-negative value. If a negative value is provided as the in-
stance ID, the corresponding positive value is used instead.
• For any whitelisted frequency, instance ID based creation is not supported. If a frequen-
cy requests an instance ID that is already existing for a whitelisted frequency, instance ID
based creation is skipped for that frequency.
Users can import the whitelist blacklist CSV file using the Frequency Object Deletion File option.
They can import the object creation file using the White list and Black list target
frequencies file GUI parameter.
An example of the whitelist blacklist file (CSV file) that can be imported for the LTE ANR Frequency
Rules module to list the frequencies to be whitelisted or blacklisted for the source cell is defined in Ta-
ble 11: Example of whitelist blacklist file.
LCH48857B11 12 2g white
Frequency objects are created if the LMS configuration file allows the creation of objects across fre-
quency layers.
Note:
• LMS has the highest priority. In case a whitelisted frequency is not allowed in the LMS,
the frequency object is not created for that frequency. For a blacklist, the frequencies are
deleted irrespective of the LMS.
• If the same frequency is provided in both the whitelist and the blacklist, that frequency is
not considered for either operation.
• The whitelist blacklist CSV file must not be provided when the CSV based creation and
deletion file is provided.
The LMS configuration file defined here is specific to the LTE ANR Frequency Rules module.
For example, to create frequency rules under existing LTE cells for a newly introduced frequency layer
such as 19500 for only LTE connected mode objects.
The rules allowing the creation of frequencies from LTE to frequency layer 19500 are as follows:
To define a template to set attribute values for the created frequency objects, define the attribute and
its values as follows:
If the attribute name specified in the template is applicable to the frequency object being created (in
the above example, LTE - LNHOIF, LNHOIF frequency objects are created), the value specified in the
template is used instead of the default value configured in the module template file for that object.
The default time between iterations of the module running and pushing changes in closed loop is 15
minutes. However, the configuration parameter TimeBetweenPushes_15Mins can be modified to
limit how often this module runs after pushing changes. TimeBetweenPushes_15Mins = 4 means
the module pushes changes a maximum of once per hour in closed loop.
Tier counting identifies the number of tiers between every source cell and all neighbors or potential
neighbors (within a reasonable range). When polygons are created for tier counting, a first tier neigh-
bor shares a polygon boundary with the source cell, a second tier neighbor shares a boundary with a
first tier neighbor to the source cell and so on.
Geo-scoring is a method of quantifying the degree of radio frequency coupling or isolation between
two or more cells based on the coverage area and antenna relationships between the cells of interest.
Tier counting and geo-scoring use cell locations and antenna information from the cell plan data. This
information is mandatory for every cell in the area under optimization.
Note:
• Distance indicates the distance between the source cell and target cell. If the source cell
and target cell have multiple antenna locations, the distance from all the antenna loca-
tions will be calculated and the minimum value will be returned.
• Tier Count indicates the tier count between the source cell and target cell. If the cell cov-
erage type is indoor, then the tier count can be +1.
• Co-site cells: all the cells that share the same site_id from cell_plan data. Tier count for
co-site cells is 1.
• Co-sector cells: Among co-site cells, all the cells that face the same azimuth direction
(+/- 20 degree) are considered as co-sector cells. For co-sector cells, the tier count is 0.
• If the source and target cells are in the same location (for example, co-site, or two sites
in the same location with different site IDs) then distance is shown as 0 in the report.
ers. The frequency layers for UMTS are determined either by pattern matching using the cell name or
else from the UARFCN (UTRA Absolute Radio Frequency Channel Number). The frequency layers for
GSM come from pattern matching using the cell name or else from the band information determined
from the CM data.
It is possible to define Max Neighbor Size conditions in the LMS configuration which can be used,
for example, to limit the number of LTE to UMTS relations allowed to a specific UARFCN, or limit the
number of LTE to GSM relations allowed to a specific GSM band.
The permissible LTE to UMTS relations and LTE to GSM relations must be defined in the LMS configu-
ration to ensure that the LMS enforcement module does not remove existing relations.
Note:
• In case both LMS based trimming and Enable_Trimming are true, LMS based trim-
ming will happen only if Max Neighbor Size exists.
• If LMS based trimming is true and Max Neighbor Size exists in the LMS, even the
first tier and co-site or co-sector can be removed.
• During IRAT neighbor addition, if Max Neighbor Size exists in the LMS, the module
will add the relation till Max Neighbor Size reaches the target cell, irrespective of the
module configuration.
The ANR 4G IRAT module supports the optimization of neighbor relations across OSS boundaries.
ANR 4G IRAT instances that stretch over OSS boundaries between different vendors are also support-
ed.
• The LMS file must contain separate LMS definitions per OSS.
• The OSS name must be specified at the beginning of each LMS configuration in the file.
The module configuration supports separate parameter settings per vendor for a few parameters.
The ANR 4G IRAT module supports the optimization of neighbor relations across OSS boundaries.
ANR 4G IRAT instances that stretch over OSS boundaries between different vendors can also be sup-
ported.
• The LMS file must contain separate LMS definitions per OSS.
• The OSS name must be specified at the beginning of each LMS configuration in the file.
The module configuration supports separate parameter settings per vendor for a few parameters.
Note:
LTE-GSM trimming is per band and LTE-WCDMA trimming is per UMTS target frequency.
• IDN based: This format is defined in Table 12: IDN based file.
• Cell name based: This format is defined in Table 13: Cell name based file.
Note:
If the source cell is an Ericsson pico cell, GSM target cells will not be considered for evalua-
tion.
For all neighbor additions, a maximum tier limit and maximum distance limit are enforced. A check is
also performed to ensure that scrambling code conflicts are not introduced for the added 3G relations,
or BCCH (Broadcast Control Channel) + BSIC (Base Station Identity Code) conflicts for the added 2G
relations.
The steps below are repeated for each 3G and 2G frequency layer as per the layer management strat-
egy:
1. Missing white-listed neighbors: The module always attempts to add all whitelisted relations. If there
is no room on the neighbor list to add a whitelisted neighbor, then an attempt is made to remove an
existing neighbor from that 3G or 2G frequency layer to make way for the new relation.
2. Missing first tier neighbors identified: The module always attempts to add all cells identified as
missing first tier neighbors - this applies to all relations classified as first tier neighbor. The tier-
map used is based on the frequency layer for the missing IRAT (3G or 2G) neighbor. If there is no
space on a neighbor list to add missing first tier neighbors, an attempt is made to remove an exist-
ing neighbor from that 3G or 2G frequency layer to make way for the new relation. These relations
are called First Tier Neighbor adds in the output report.
3. Additional neighbor adds (based on 3G or 2G co-sectors to top intra-frequency LTE neighbors):
The module attempts to add missing IRAT neighbors based on intra-frequency LTE handovers.
Only LTE intra-frequency neighbors above a threshold for the minimum number of intra-frequency
handover successes are considered. The potential candidates are then ranked based on handover
success counts from the source cell to its intra-frequency LTE neighbors. The co-sector 3G and
2G cells to these LTE neighbors are then taken. Candidates are selected from the second tier up
to the configurable maximum tier limit. The tier-map used is based on the frequency layer for the
candidate IRAT (3G or 2G) neighbor. If there is no space on a neighbor list to add neighbors, an at-
tempt is made to remove an existing neighbor from that 3G or 2G frequency layer to make way for
the new relation. These are called Neighbor Co-sector adds in the output report.
Note: If the KPIs of the co-sector neighbor are not above the defined threshold, they are
not added to the list of co-sectors. In this case, the neighbor is evaluated next based on
the geo-score. It is added and represented as tier 2+ neighbors.
4. Additional neighbor adds (network topology based): The module attempts to add the top candidate
missing neighbors based on network topology.
Note:
• Extended First Tier neighbors are added when there are additional first tier neighbors
outside the maximum count of the Absolute First Tier neighbors (reporting catego-
rization). In case of neighbor removal between the first tier and the extended first tier,
extended first tier neighbors take precedence.
• If the Limit_no_of_detected_neighbors parameter is set to Yes,
the number of topology based detected neighbors is limited based on the
Buffer_for_detected_neighbours parameter.
For LTE to GSM addition, the count of the Maximum LTE - GSM neighbor
size is derived from the lte_irat_neighbor_list_size_2g parameter
that can be added for a cell and the count of the existing LTE-GSM neighbors
for a cell. The remaining neighbors are calculated by subtracting the Max LTE
- GSM neighbor size and Existing neighbor for a cell. Once the
remaining neighbors are identified for LTE-GSM, the buffer is added based on
the Buffer_for_detected_neighbours parameter, to limit topology based
detection.
For example, if the source cell has 20 LTE-GSM IRAT relations, the
lte_irat_neighbor_list_size_2g parameter is set to 32, and the
Buffer_for_detected_neighbours parameter is set to 20, the detected
neighbors for topology based addition are limited to:
32 – 20 + 20 = 32
The slot is reduced if first tier, whitelisted, or HO based detected neighbors are
present. If topology based (tier 2+) relations already exist, the slot is further reduced.
For example, consider that 5 first tier, 2 white listed and 1 HO based detected neigh-
bor are present. For the same scope cell, there are 2 topology based relations which
are also detected. In this case, detected neighbors are:
32 – (20+5+2+1)+ 20 = 22
It fetches 22 tier 2+ neighbors for the scope cell. It will skip the 2 existing topology
based relations. It will populate 20 topology based neighbors for the scope cell in the
detected sheet.
The potential candidates are ranked based on a Cell Coupling Score that is based on the tier
count, distance, and geo-scores. Candidates are selected from the second tier up to the config-
urable maximum tier limit. The tier-map used is based on the frequency layer for the candidate
IRAT (3G or 2G) neighbor. When there is no space on a neighbor list to add neighbors, an attempt
is made to remove an existing neighbor from that 3G or 2G frequency layer to make way for the
new relation. These are called Tier 2+ Neighbor adds in the output report.
Note:
There is a limit built into the module which allows relations to be defined to a maximum of
6 distinct UARFCNs.
1. IRAT Neighbor with the same UARFCN + SC for 3G or the same BCCH + BSIC for 2G as the pro-
posed addition
2. IRAT Neighbor with the lowest number of IRAT handover successes in the previous 24 hour period
When an attempt is made to remove an existing IRAT neighbor for replacement by a new IRAT neigh-
bor, the following conditions must be met:
For IRAT neighbor replacement based on intra-frequency LTE handovers, the below additional criteria
must be met:
• The number of LTE intra-frequency handover successes to the LTE cell which is co-sector to the
candidate UMTS or GSM cell must outperform the existing neighbor by a defined Outperform Mul-
tiplier (LTE_IRAT_Outperform_Multiplier set through the user interface at run time).
For IRAT neighbor replacement based on network topology, (tier count and geo-scores), the below ad-
ditional criteria must be met:
• The combined score (calculated from tier count and geo-scores) for the proposed neighbor addi-
tion must exceed the combined score calculated for the existing neighbor being replaced.
If these criteria cannot be met, the IRAT neighbor with the next lowest number of neighbors, which
meets all the removal criteria, is tried. In case there are multiple IRAT neighbors with zero handover
successes in the previous 24 hour period, those with the highest tier count are selected first, then
those with the lowest cell coupling score within the same tier are selected.
Note: The module will remove the unused LNADJGs and LNADJWs only when Optimize
4G to 2G neighbor relations and Optimize 4G to 3G neighbor relations
are enabled. The unused LNADJGs and LNADJWs can be removed either as part of neigh-
bor replacement or as part of neighbor trimming.
For example, if a KPI is retrieved for the last 24 hours (1440 minutes), and the KPI reliability threshold
is 50%, then the duration of KPI periods with valid data should be greater than 12 hours (24 * 0.5) or
720 minutes (1440 * 0.5).
Neighbor removals
• Neighbor trimming logic: While finding the bottom neighbor for trimming, the HO success count
(from the source cell to the neighbor) is checked for reliability. If it is reliable, it can be marked for
removal. If the KPI is found to be unreliable, the next bottom neighbor is considered for trimming
till a suitable bottom neighbor is found.
• In the Final Neighbors tab of the Output Report, Cannot Remove Reason is updated with the
message HO Success KPI is not reliable where this is applicable.
Neighbor additions
With the default value of zero, KPI reliability is bypassed. To enforce KPI reliability, set a value greater
than zero.
Configurable_relation_Id= {
"LTE": {
"LTE_to_WCDMA_relation_Id": "value",
"LTE_to_GSM_relation_Id": "value"
• LTE_to_WCDMA_relation_Id
• LTE_to_GSM_relation_Id
The value of these parameters is verified when the INI file is imported into the GUI. The following are
checked in GUI validation:
• The parameter must only contain the keys defined for each technology. Illegal keys must not be
present.
• The parameter must contain one of the following valid keys (or else an error message is dis-
played):
– LTE_to_WCDMA_relation_Id
– LTE_to_GSM_relation_Id
• After the above conditions are verified, the parameter values are verified syntactically. An error
message is displayed if they are syntactically wrong.
• Each CM parameter must be enclosed within angle brackets (< and >)
– The name specified within angle brackets must be a correct CM parameter name. (validated
during the ANR 4G IRAT module run)
– Any number of CM parameters can be specified in the INI parameters which may or may not
be separated by delimiters.
– It is not necessary to use the same delimiter in the entire parameter value. Any combination of
delimiters can be used.
– The alphanumeric part can be specified anywhere in the INI parameter value except in be-
tween the angle brackets.
For example: "abc<mcc>_<mnc>" or "ABC<mcc>+Qwe1<mnc>zxc"
The characters "ABC", "Qwe1", "zxc" are placed as is in their respective positions in the final
parsed value for the RDN ID.
– If the parameter contains any keys other than the specified ones (at any level), GUI validation
fails and an error message is displayed.
• The value can also be set to the instance ID of the source cell or the neighbor cell:
If the INI file is verified and imported, the ANR 4G IRAT module searches for the configured CM para-
meters during execution, firstly in the neighbor cell object or else in the CM cache.
If the configured CM parameters are still not found, or if the CM parameter names are incorrect, the
default values are used. The default values are different for different technologies and relation types,
as described in Table 14: Default values for relation DN IDs for ANR 4G IRAT:
<ExternalUtran- <ExternalUtran-
CellFddId> CellFddId>
<ExternalUtran- <ExternalUtran-
CellTddId> CellTddId>
LTE_to_GSM_re- This is the last el- This is the last el- Relation ID of the
lation_Id ement in the cell's ement in the cell's LTE to GSM rela-
DN: DN: tion MO.
<ExternalGeran- <ExternalGeran-
CellId> CellId>
Table 14: Default values for relation DN IDs for ANR 4G IRAT
• The user must populate the config parameter in the Global section of the INI file.
• The user must configure the INI parameter with a combination of CM parameters which will
resolve to a unique value for each RDN ID as the feature does not check for uniqueness.
For example:
If the user configures the INI parameter as <mcc>_<mnc>_<rncId>, this combination is not unique
for different relations of a source cell (as all three parameters can be the same for different rela-
tions). The user needs to configure it as <mcc>_<mnc>_<rncId>_<cellId>, as in this combination -
the cellId is unique for each neighbor of a source cell and hence it is also unique for the relation to
that neighbor.
5.1 Prerequisites
To execute the LTE ANR modules, the following prerequisites must be met:
• Google Chrome or Mozilla Firefox Web browser must be installed on your computer.
• The required LTE ANR module license must be activated. For more information, see:
The ANR Blacklisting and Cleanup LTE module requires the following information from the OSS for all
the cells under optimization:
Tier counting and distance calculation use the cell locations and antenna information from the cell plan
data. This information is mandatory for every cell in the area under optimization.
Distance calculation uses the cell locations and antenna information from the cell plan data. This infor-
mation is mandatory for every cell in the area under optimization.
For details about the CM data and PM data of the LTE ANR Frequency Rules module, see the below
documents:
For details about the CM data and PM data of the ANR 4G IRAT module, see the below documents:
Prerequisites
• ANR_Blacklisting_and_Cleanup_LTE
Or
• LTE_Frequency_Rules
Or
• ANR_4G_IRAT
Expected outcome
The selected ANR module is accessed and the Configure Targets page appears.
4. To select the UMTS or LTE target cells for configuration, do one of the following:
• Based on the Topology Filter or Center Frequency Filter, select the target cells on the map.
Or
• Based on the Topology Filter or Center Frequency Filter, click the Select all Filtered Items
icon to select all the filtered items.
Or
• Based on the following options, select the existing clusters or create a new cluster:
For more information about creating a new cluster, see the Cell Clusters section in the
EdenNet User and Administration Guide.
Or
The target cells are selected on the map and are listed in the Selections pane.
Note: For more information about selecting cells, see the Selecting cells section in the
EdenNet User and Administration guide.
5. Click Next.
6. In the Parameter Value column, define the values of the GUI configuration parameters. For the list
of GUI parameters, see LTE ANR GUI parameters.
Note: Click the Default Value icon to revert to the default GUI parameter value.
7. Click Next.
8. In the Module Global Configuration category, select the required configuration file.
Note: In each category, you can select only one configuration file.
For more information, see the Configuring execution type section in the EdenNet User and Admin-
istration Guide.
Expected outcome
The ANR 5G module is configured and executed as per the defined schedule.
Note: You can monitor the ANR 5G module activities, status, and so on. For more
information, see Monitoring LTE ANR modules.
Table 18: LTE ANR Frequency Rules configuration parameters describes the GUI parameters of the
LTE ANR Frequency Rules module.
Default
Parameter Description Range (Min, Max) Step
value
Frequency Ob- CSV file containing the source select a file N/A N/A
ject Creation cell and target cell for frequen-
File cy objects to be created. A fre-
quency object will be created
with the frequency of the target
cell. Each line in the file has
one source cell and one target
cell. The source cell and tar-
get cell are identified by their
common names and separated
with a comma.
Frequency Ob- CSV file containing source cell, N/A N/A N/A
ject Deletion target technology and target
File frequency (sometimes the fre-
Default
Parameter Description Range (Min, Max) Step
value
SON Operation Set to Open Loop to run the Open Loop, Closed N/A Open Loop
Mode module in open loop mode. Loop
Set to Closed Loop to run
the module in closed loop
mode. In Closed Loop mode,
changes are automatically
pushed to the network with-
out user intervention. In Open
Loop mode, the module does
not automatically push para-
meter changes to the network.
The user has to manually pro-
vision plans to push changes
to the network.
Default
Parameter Description Range (Min, Max) Step
value
Plan Name Tag Text that will be added to the Sequence which con- N/A Empty
names of all the plans that will tains any combinations
be generated by this module. of:
If the target of the module is
• Uppercase and low-
a whole specific cluster (and
ercase letters: [A-
the name of this cluster al-
Za-z]
so matches the Range), then
• Numbers: [0-9]
the cluster name will also be
• Underscore: _
added to the plan name.
The maximum length is
20 characters.
White list and This parameter lists the target N/A N/A N/A
Black list target frequencies for frequency ob-
frequencies file ject creation (for whitelisting)
Default
Parameter Description Range (Min, Max) Step
value
Table 19: ANR Blacklisting and Cleanup LTE configuration parameters describes the GUI parameters
of the ANR Blacklisting and Cleanup LTE module.
For example:
B7WAW205A11,
B7WAW152A31,
blacklist
For example:
B7HCH119A31,
B7HCH031A21
Unit is tiers.
Unit is kms.
HO success rate cri- This parameter defines the Ignore, Maximum N/A Maximum
teria handover success rate cri- HO success rate HO success
teria to be used for blacklist- rate
ing and deletion of neighbor
relations. Either the parame-
ter can be ignored or Maxi-
mum HO success rate can
be used. If set to Ignore, han-
dover success rate criteria is
not considered to select the
neighbor relations for black-
listing and deletion.
Unit is percentage.
LTE to WCDMA The blacklisting type for LTE CSFB&PSHO, N/A CSFB&
neighbor blacklisting to WCDMA neighbor rela- SRVCC
PSHO
type tion can be either CSFB (Cir-
cuit Switched Fallback) and
PSHO (Packet Switched
Handover) or SRVCC (Single
Radio Voice Call Continuity).
Unit is hours.
Unit is days.
Unit is percentage.
Unit is percentage.
Unit is days.
SON Operation Mode Set to Open Loop to run Open Loop, Closed N/A Open Loop
the module in open loop Loop
mode. Set to Closed Loop
to run the module in closed
loop mode. In Closed Loop
mode, changes are automat-
ically pushed to the network
without user intervention. In
Open Loop mode, the mod-
ule does not automatically
Plan Name Tag Text that will be added to Sequence which N/A Empty
the names of all the plans contains any com-
that will be generated by binations of:
this module. If the target of
• Uppercase and
the module is a whole spe-
lowercase let-
cific cluster (and the name
ters: [A-Za-z]
of this cluster also matches
• Numbers: [0-9]
the Range), then the cluster
• Underscore: _
name is also added to the
plan name. The maximum
length is 20 charac-
ters.
A frequency object creation file (CSV file) lists the frequency objects to be created in the source cell for
the frequency of the corresponding target cell. Table 20: Example of frequency object creation file for-
mat describes an example of frequency object creation file format.
LCH48857B21 LCH32931A31
LCH48857B11 LCH32931A11
Each row is a cell pair. Frequency objects are created if the LMS (Layer Management Strategy) config-
uration file allows the creation of objects across frequency layers.
A frequency object deletion file (CSV file) lists the frequency objects to be deleted from the source cell
for the given frequency.
Note: Frequency object deletion can only be done using the Frequency Object Deletion
File option.
Table 21: Example of frequency object deletion file format describes an example of frequency object
deletion file format.
Frequency channel
Source cell Technology Frequency band
number
LCH48857B21 4g 19500
LCH48857B11 3g 1000
Each row is a cell pair. Frequency objects are deleted if the LMS (Layer Management Strategy) config-
uration file allows the deletion of objects across frequency layers.
Note: This file must not be provided if the frequency object creation or deletion file is given.
Table 22: Example of whitelist blacklist file lists an example of the file format.
LCH48857B11 12 2g white
Each row consists of the source cell, frequency to be whitelisted or blacklisted, technology, and white
or black (for whitelisting or blacklisting respectively).
For example:
If Optimize 4G to 3G
neighbor relations
is enabled, only 4G to 3G
relations are optimized
and 4G to 2G relations
are not considered.
For example:
If Optimize 4G to 2G
neighbor relations
is enabled, only 4G to 2G
relations are optimized
and 4G to 3G relations
are not considered.
SON Operation Set to Open Loop to run Open Loop, Closed N/A Open Loop
Mode the module in open loop Loop
mode. Set to Closed
Loop to run the mod-
ule in closed loop mode.
In Closed Loop mode,
changes are automatical-
ly pushed to the network
without user intervention.
In Open Loop mode, the
module does not auto-
matically push parameter
changes to the network.
The user has to manual-
ly provision plans to push
changes to the network.
Plan Name Tag Text that will be added to Sequence which N/A Empty
the names of all the plans contains any combi-
that will be generated by nations of:
this module. If the target
• Uppercase and
of the module is a whole
lowercase let-
specific cluster (and the
ters: [A-Za-z]
name of this cluster also
• Numbers: [0-9]
matches the Range), then
• Underscore: _
the cluster name will al-
so be added to the plan The maximum length
name. is 20 characters.
Table 24: Common configuration file parameters lists the common configuration file parameters used
by the ANR modules.
Range (Min,
Parameter Description Step Default
Max)
Exclude_outdoor_ When this parameter is set to True, True, False N/A False
cells outdoor cells are excluded from tier
based intra, inter and IRAT neighbor
relation addition for an indoor source
cell, but they will be included in mea-
surement based neighbor relation
addition.
Table 25: ANR Blacklisting and Cleanup LTE configuration file parameters lists the INI parameters of
the ANR Blacklisting and Cleanup LTE module.
Range
Parameter Description Step Default value
(min, max)
Unit is hours.
Log_warnings_in_ If enabled, warning logs are print- True, False N/A False
Logs_tab ed in the Logs tab. If disabled,
warning logs are only available
in the output report log sheet. By
default, the value is set to False.
Allow_processing_ When the value for this parame- True, False N/A False
after_maximum_ ter is set to False and if the max-
changes_to_push_ imum number of changes to be
reached pushed as defined by the para-
meter Maximum_blacklist-
Range
Parameter Description Step Default value
(min, max)
ing_changes_per_execu-
tion is reached, then the re-
maining relations are not opti-
mized. When the value for this
parameter is set to True, then
all relations are evaluated irre-
spective of whether the num-
ber of changes has exceeded
Maximum_blacklisting_
changes_per_execution or
not.
Table 25: ANR Blacklisting and Cleanup LTE configuration file parameters
These parameters provide a level of protection so that the module does not remove an excessive
amount of neighbor relations, either from an individual cell, or from all cells on the target list. The limits
for the maximum number of changes are applicable to both modes of operation (automated mode and
neighbor relation file mode). Changes are not pushed to the network if the limits are exceeded in either
mode.
The configuration file is uploaded to the EdenNet application. For more information on how to upload
the file, see the Configuring a module section in the EdenNet User and Administration Guide docu-
ment.
The below code snippet provides an example of the ANR Blacklisting and Cleanup LTE configuration
file:
[Global]
#------------------------#
# Common parameters #
#------------------------#
Log_warnings_in_Logs_tab = False
TimeBetweenPushes_15Mins = 1
KPI_Time_Window_Eval = 1
[Operator Policy]
# The format is KPI name = +/-number%, aggregation rule
# + means the tolerance can go up to that number
# - means the tolerance can go down to that number
# aggregation rules can be sum, average, or sum/sum
eRAB_Voice_Call_Initiated = +0%, average
Note:
• At least one KPI should be mentioned in the Operator policy. Otherwise, module execu-
tion fails.
• Unblacklisting fails if relation level KPIs are mentioned in the Operator policy.
During execution of the ANR 4G IRAT module, the module specific configuration file (INI file) para-
meters are considered along with the parameters provided in the Configuration Parameters page.
These parameters are considered for all ANR 4G IRAT instances. The INI file is controlled by the ad-
ministrator.
Table 26: ANR 4G IRAT configuration file parameters lists the INI parameters of the ANR 4G IRAT
module.
Range (min,
Parameter Description Step Default value
max)
LTE_IRAT_ho_ Set to True if connected mode han- True, False N/A True
success_avail- dover from LTE to UMTS and LTE
able to GSM is enabled in the network
and per relation handover counts
are available. If set to False, re-
placement of existing LTE IRAT re-
lations will be permitted even when
handover counts are not available.
Range (min,
Parameter Description Step Default value
max)
Note:
• Huawei vendor
Range (min,
Parameter Description Step Default value
max)
• ZTE vendor
• Nokia 2G cells
Note:
• Huawei vendor
• ZTE vendor
• Nokia 2G cells
Range (min,
Parameter Description Step Default value
max)
Enable_trimming Enables trimming based on the fol- True, False N/A False
lowing configuration parameters:
• LTE_IRAT_Neighbor_List_
Size_2G
• LTE_IRAT_Neighbor_List_
Size_3G
Range (min,
Parameter Description Step Default value
max)
Range (min,
Parameter Description Step Default value
max)
Use_modified_ If set to True, the modified CGI is True, False N/A False
CGI_for_erics- used to identify the external cells. If
son_external_ set to False, the cell name or label
cell_DN is used to identify the external cells.
Exclude_indoor_ When set to True, indoor cells are True, False N/A False
cells excluded from tier based Intra, In-
ter, and IRAT neighbor relation ad-
dition but they will still be included
in measurement based neighbor re-
lation addition.
Update_mobility_ If this parameter is set to True, the True, False N/A True
parameters_for_ parameters srvccAllowed and
existing_neigh- psHoAllowed for LNRELW will be
bors updated for all neighbors per fre-
quency.
Note:
• This parameter is
applicable only for
the Nokia vendor.
• The LMS settings
of the new
neighbors will not
be considered if
there are already 32
existing neighbors
with parameters
srvccAllowed
and psHoAllowed
set to allowed,
when the Update_
Range (min,
Parameter Description Step Default value
max)
mobility_
parameters_
for_existing_
neighbors
parameter is set to
False.
consider_HO_ This parameter indicates the criteria Both, HO, Tier N/A Both
or_tier_for_neigh- to be considered along with the cell
bor_ranking coupling score for neighbor ranking:
HO_based,
Topology_based,
First_tier
Range (min,
Parameter Description Step Default value
max)
Note:
Range (min,
Parameter Description Step Default value
max)
Configurable_re- Indicates the relation ID (RDN val- N/A N/A The default
lation_Id ue) of a relation MO. value is dif-
ferent for dif-
For details on how to configure the
ferent rela-
parameter, see Configuring relation
tion types and
DN ID for Ericsson (4G).
technologies.
For more in-
formation, see
the Default
values for re-
lation DN IDs
for ANR 4G
IRAT table in
the Configur-
ing relation
DN ID for Eric-
sson (4G) sec-
tion.
Note:
• While trimming, LMS has higher precedence when compared to configuration parame-
ters.
• If Maximum_count_redirWithSysInfoAllowed_lnrelw and
Maximum_count_redirWithSysInfoAllowed_lnrelg are set to 0,
redirWithSysInfoAllowed will be set to forbidden for all the relations of the cells
which are optimized.
• If an invalid value is set for Maximum_count_redirWithSysInfoAllowed_lnrelw
and Maximum_count_redirWithSysInfoAllowed_lnrelg, the module defaults to
4.
Note:
During neighbor replacement, there could be additional changes based on the last
processed cell and the Max_Num_Changes_To_Push parameter limit could be changed by
a maximum of 1.
The below code snippet provides an example of the ANR-4G IRAT configuration file:
[Global]
#------------------------#
# Common parameters #
#------------------------#
Max_Num_Changes_To_Push = 5000
Neighbors_Pulled_Per_Cache_Cycle = 300
LTE_IRAT_Max_Cell_Distance_Threshold = 40
LTE_IRAT_Min_LTEintraFreq_HO_Success_For_Cell_Add = 50
LTE_IRAT_Max_Tier_Count_For_Cell_Add = 2
# Existing LTE IRAT relations with more than this number of HO Success
will not be replaced
LTE_IRAT_Max_HO_Successes_For_Nbr_Removal = 0
[Output]
tabs = Parameters, Changes, Detected Neighbors, IRAT Reuse Conflicts,
Logs
Prerequisites
Only users with admin privileges have permissions to modify the INI parameters.
• EdenNet modules: The modules that Nokia provides are available in this category.
• Adapted modules: The modules that users develop are available in this category.
• Helper modules: These modules are mainly used for troubleshooting by Nokia support teams.
They are not categorized as Generally Available. General Availability implies that the release is
available to all customers.
• ANR_Blacklisting_and_Cleanup_LTE
Or
• LTE_Frequency_Rules
Or
• ANR_4G_IRAT
The user should have admin or SON manager access permissions to perform the Delete oper-
ation. INI files can be deleted only if they are not used by other modules.
• Activate: to activate the selected file from the list.
A file can be deactivated only when it is not used by other module instances listed under Ac-
tive SON Modules and Module History.
• Set As Default: to set the selected file as the default configuration.
• Reset: to reset the edited parameter values in the selected INI file.
• Save: to save the new version of the configuration after editing the parameter values in the
selected INI file.
• Save As: to save the configuration with a different name.
For more details, see the Configuring a module section in the EdenNet User and Administration
Guide.
• ANR_Blacklisting_and_Cleanup_LTE
Or
• LTE_Frequency_Rules
Or
• ANR_4G_IRAT
Expected outcome
The target cells which were configured for the selected module instance are displayed on the map.
The cells with errors also generate error events which can be analyzed in order to perform the
required troubleshooting.
3. In the Active SON Modules or Module History area, select the LTE ANR module.
The LTE ANR module status appears in the Execution Status tab.
5. In the User Outputs option, click the username. For example, admin.
The Directory Listing For dialog box appears. It lists the module filename.
Expected outcome
The Excel file is saved to your local system. You can open and view the report. For more
information, see:
Table 28: ANR Blacklisting and Cleanup LTE module report (Blacklisting of neighbors use case) and
Table 29: ANR Blacklisting and Cleanup LTE module report (Deletion of neighbors use case) describe
each report in the Excel file.
Note:
If multiple clusters are selected to run the module, cluster names are displayed in the Para-
meters sheet.
Parameters Lists the module parameters used for this iteration of ANR_Black-
listing_and_Cleanup_LTE module.
Detected Relations Provides the detected relations between the source and neighbor
cells. Also, it provides the status or reason for blacklisting.
Blacklisting Provides the blacklisted relation details. This sheet is visible only
when some neighbor relations are blacklisted.
Unblacklisting Provides the unblacklisted relation details. This sheet is visible on-
ly when some neighbor relations are unblacklisted.
Logs Details any errors or conditions which indicate that detected neigh-
bors could not be sent for implementation.
Provisioning Details Provides the relation provisioning status when the module runs in
closed loop. This sheet is visible only when some neighbor rela-
tions are blacklisted or unblacklisted.
Table 28: ANR Blacklisting and Cleanup LTE module report (Blacklisting of neighbors use case)
Parameters Presents the module UI and the configuration file parameters used
for ANR_Blacklisting_and_Cleanup_LTE execution.
Detected Neighbor Removal Presents all the detected neighbors which are candidates for re-
moval.
Removed X2 Links It will be populated only when the vendor of the source eNodeB is
Nokia.
Logs Details any errors or conditions which indicate that detected neigh-
bors cannot be sent for implementation.
Table 29: ANR Blacklisting and Cleanup LTE module report (Deletion of neighbors use case)
The tabs within the excel sheet for the Blacklisting of neighbors use case are described in the follow-
ing tables:
• Parameters
• Detected relations
• Blacklisting
• UnBlacklisting
• Logs
The tabs within the excel sheet for the Deletion of neighbors use case are described in the following
tables:
• Parameters
• Detected Neighbor Removal
• Removed X2 links
• Logs
• Changes
• Provisioning Details
Table 30: Output report naming conventions describes the output report naming conventions for the
ANR_Blacklisting_and_Cleanup_LTE module.
ModuleName_Multi_DateTime Indicates that multiple clusters are selected and the names of
the clusters are displayed in the Parameters sheet of the re-
port.
ModuleName_Datetime Indicates that no clusters are selected and only cells are se-
lected.
Note: For all the reports mentioned in Table 28: ANR Blacklisting and Cleanup LTE module
report (Blacklisting of neighbors use case) and Table 29: ANR Blacklisting and Cleanup LTE
module report (Deletion of neighbors use case), the Tier column defined in Table 31: Tier
count will have values greater than or equal to 10001 for all invalid or missing data related
cells.
8.1.1.3 Blacklisting
Table 32: Blacklisting describes the columns present in the Blacklisting sheet.
Source Cell Region The OSS that manages the source cell.
Neighbor Cell Region The OSS that manages the target cell.
Tier count Tier count to the resolved cell. The Effective Tier count after Tier Count Ad-
justment has been applied. A tier of 10,000 means that it is unreachable
through the tier map.
Sum of Expected Cell The sum of the source and target cell ECR in kms.
Range (km)
Source Cell DN The Distinguished Name for the source cell managed object.
Source Region The EdenNet region to which the source cell belongs.
Total Neighbors Added Total number of neighbors added during the execution of the module.
Total Neighbors Removed Total number of neighbors removed during the execution of the module.
Total Neighbors Before Total number of neighbors before this execution of the module.
Total Neighbors After Total number of neighbors after this execution of the module (actual if
run in Closed Loop, hypothetical if run in Open Loop).
IRAT (LTE-WCDMA) Total number of IRAT (LTE-WCDMA) neighbors before the current exe-
Neighbors Before cution of the module.
IRAT (LTE-WCDMA) Total number of IRAT (LTE-WCDMA) neighbors after the current execu-
Neighbors After tion of the module (actual if run in closed loop, hypothetical if run in open
loop).
IRAT (LTE-GSM) Neigh- Total number of IRAT (LTE-GSM) neighbors before the current execution
bors Before of the module.
IRAT (LTE-GSM) Neigh- Total number of IRAT (LTE-GSM) neighbors after the current execution
bors After of the module (actual if run in closed loop, hypothetical if run in open
loop).
Source Cell Region The OSS that manages the source cell
Neighbor Cell Re- The OSS that manages the target cell
gion
Sum of Expected Sum of the source and target cell ECR in kms
Cell Range (km)
8.1.1.6 HO report
Table 35: HO report describes the columns present in the HO report sheet.
Neighbor Frequency The frequency layer the neighbor cell belongs to.
Layer
• For WCDMA cells - the UARFCN
• For GSM cells - the Band
Reuse Code • For WCDMA cells - the UARFCN + Primary Scrambling Code
• For GSM cells - the BCCH + BSIC
Neighbor relation exis- Indicates if the relation exists (actual if run in closed loop, hypothetical if
tence run in open loop).
Cross OSS neighbor re- Indicates if the relation is across an OSS boundary.
lation existence
Category The categories are First Tier and Extended First Tier.
Change Reason Descriptive reason for the neighbor addition or removal (for example, first
tier addition, detected neighbor addition, reciprocal addition, replacement).
Percentage of HO at- Percentage of handover attempts on this relation compared to all the out-
tempts per frequency going neighbor relations for this frequency.
(%)
• For WCDMA targets - the UARFCN
• For GSM targets - the Band
Tier Count Tier count to the neighboring cell. The Effective Tier count after Tier Count
Adjustment has been applied. A tier of 10,000 means it is unreachable
through the tier map.
Detection Method Describes the proxy relations used to detect missing neighbors. For ex-
ample: 4G->4G (co-sector 3G on target) or 4G->4G (co-sector 2G on tar-
get).
8.1.1.7 Logs
Table 36: Logs describes the columns present in the Logs sheet.
8.1.1.8 Parameters
Table 37: Parameters describes the columns present in the Parameters sheet.
Value The parameter value used for the execution of the module
Reason Description
White List Neighbor A neighbor relation was added which was whitelisted through EdenNet.
First Tier Neighbor A missing neighbor relation was added which is a first tier according to the
tier map and is ranked within the value of Absolute_1st_Tier_Maximum.
HO Based Detected A neighbor relation was added based on intra-frequency LTE handovers.
Neighbor
Tier 2+ Neighbor A neighbor relation was added which was tier two or greater according to the
tier map and detected as missing through the network topology.
Reason Description
Source Trim (One- A neighbor relation was trimmed to meet the configured neighbor list size lim-
Way) its.
Neighbor List Full. An existing lower ranked neighbor was removed and replaced by a higher
Removed Bottom ranked missing neighbor.
Neighbor
Replaced conflicting A neighbor relation which had an SC conflict was removed and replaced by a
neighbor higher ranked missing neighbor.
8.1.1.12 UnBlacklisting
Table 41: UnBlacklisting describes the columns present in the UnBlacklisting sheet.
Neighbor Cell Region The OSS that manages the target cell.
Source Cell Region The OSS that manages the source cell.
8.1.1.13 Changes
Table 42: Changes describes the columns present in the Changes sheet.
Source Parent The parent entity of the Source Cell. For LTE cells, it is the LTE eNodeB.
Source Cell Region The OSS that manages the source cell.
Neighbor Parent The parent entity of the Target Cell. For LTE cells, it is the LTE eNodeB.
Neighbor Cell Region The OSS that manages the target cell.
Neighbor Type The neighbor types are LTE-LTE Intra frequency relation and LTE-LTE Inter
frequency relation.
Tier Tier count to the resolved cell. The Effective Tier count after Tier Count Ad-
justment has been applied. A tier of 10,000 means that it is unreachable
through the tier map.
Table 43: Provisioning Details describes the columns present in the Provisioning Details sheet.
Permanently Blacklist- Provides information about whether the relation is blacklisted permanently or
ed not if the Increased blacklist duration is set as Permanent
Provisioning Status Provides details about whether the relation is provisioned successfully
Source Cell Region The OSS that manages the source cell.
Neighbor Cell Region The OSS that manages the target cell.
Tier count Tier count to the resolved cell. The Effective Tier count after Tier Count Ad-
justment has been applied. A tier of 10,000 means that it is unreachable
through the tier map.
Neighbor Type The neighbor types are LTE-LTE Intra frequency relation and LTE-LTE Inter
frequency relation.
Removed? Indicates whether the neighbor relation is blocked. The values are Yes or
No.
Tabs Description
Parameters Provides a summary of all the configuration parameters and the values used
in the execution
LNHOIF Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
IRFIM Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
Tabs Description
LNHOW Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
UFFIM Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
LNHOG Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
GFIM Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
GNFL Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
REDRT Changes Provides all the corresponding frequency objects which are created, updat-
ed, or deleted for the scope cell
8.1.2.1 Parameters
Table 47: Parameters describes the columns present in the Parameters sheet.
Value The parameter value used for the execution of the module
8.1.2.2 Changes
Table 48: LNHOIF, IRFIM, LNHOW, UFFIM, LNHOG, GFIM, GNFL, and REDRT Changes describes
the columns present in the LNHOIF, IRFIM, LNHOW, UFFIM, LNHOG, GFIM, GNFL, and REDRT
Changes sheets.
Note: The GFIM Changes sheet does not contain this column.
Change Type The change types are created, updated, and removed.
For the REDRT Changes sheet, there is an additional column - Technology, which lists the specified
technology (2G, 3G, or 4G).
Table 48: LNHOIF, IRFIM, LNHOW, UFFIM, LNHOG, GFIM, GNFL, and REDRT Changes
8.1.2.3 Logs
Table 49: Logs describes the columns present in the Logs sheet.
Tabs Description
Final Neighbors (disabled by Provides information about the final neighbors which exist after ANR
default) execution:
Tabs Description
Changes Details the neighbor additions and deletions that are proposed (open
loop) or actually sent for implementation (closed loop). This list ex-
cludes changes which could not be implemented due to errors or
other conditions such as SC conflicts.
Logs Details any errors or conditions for neighbors that could not be sent
for implementation.
Parameters Lists the module parameters used for this iteration of ANR 4G IRAT.
HO Report (disabled by de- Details an overview per LTE cell of all the changes made by the
fault) module including the change reason. In open loop, the Neighbor re-
lation existence column represents the hypothetical situation if the
module was run in closed loop. PM counter statistics on handover
counts and success rate are also presented and they are used as
a condition for identifying the existing poorly performing neighbors.
It also includes statistics on the IRAT relations and 4G to 4G han-
dovers (based on the PM counter data).
Note:
IRAT Reuse Conflicts Provides additional details on the proposed IRAT neighbors that
could not be added because they have the same UARFCN and SC
for 3G, or the same BCCH and BSIC combination for 2G as an exist-
ing neighbor.
IRAT Neighbor performance Provides details about the tier counts and geo-score calculations
(disabled by default) for existing neighbors. It also lists which of the existing relations are
classified as poor performers. It also details which existing neighbors
meet the criteria for potential replacements in case a missing IRAT
neighbor is detected and the neighbor list is past the defined maxi-
mum limit. It is based on the IRAT neighbor definitions.
Tabs Description
Cell Level Summary Presents a summary with one entry per cell regarding the action tak-
en for that cell and the total neighbor list sizes before and after ANR
execution.
ModuleName_Multi_Date- Indicates that multiple clusters are selected, and the name of the
Time clusters is shown in the Parameters sheet of the report.
ModuleName_Datetime Indicates that clusters are not selected. Only cells are selected.
ModuleName_Datetime Indicates that a single cluster or multiple clusters are selected along
with cells from the map.
Note: For all the reports mentioned in ANR-4G IRAT module reports, the Tier column will
have values greater than or equal to 10001 for all the invalid or missing data related cells.
8.1.3.3 Parameters
Table 53: Parameters describes the columns present in the Parameters sheet.
Value The parameter value used for the execution of the module
Table 54: IRAT Neighbor Performance describes the columns present in the IRAT Neighbor Perfor-
mance sheet.
Tier Count Tier count to the neighboring cell. The Effective Tier count after Tier Count
Adjustment has been applied. A tier of 10,000 means it is unreachable
through the tier map.
Basic Tier Count Basic Tier count before Tier Count Adjustment.
S->T GeoScore GeoScore of the angle between the source cell azimuth and the neighbor
cell.
T->S GeoScore GeoScore of the angle between the target cell azimuth and the source
cell.
Poor Performing neigh- True if the relation meets all the configured criteria for poorly perform-
bor ing neighbor removal (for example, Tier, Distance, S->T GeoScore, T->S
GeoScore, HO Attempt Number, HO Success Rate).
Available HO attempts KPI value for the available HO attempts duration in hours.
duration (hrs)
Available HO success KPI value for the available HO success duration in hours.
duration (hrs)
Potential Replacement Descriptive reason why an existing neighbor is not a candidate for re-
placement in the case of full neighbor lists. To be replaced, an existing re-
lation must meet all the replacement criteria.
For example:
Cell Coupling Score It is calculated from the tier count, distance, and relative antenna orienta-
tions. It is also called Coupling Score.
HO Success Score The number of Handover Success counts on the proxy LTE-LTE intra-fre-
quency relation over the last 24 hour period.
Neighbor Frequency The frequency layer that the neighbor cell belongs to.
Layer
• For WCDMA cells - the UARFCN
• For GSM cells - the Band
8.1.3.5 Logs
Table 49: Logs describes the columns present in the Logs sheet.
Nbr Frequency Layer The frequency layer the neighbor cell belongs to.
New Neighbor True indicates that a neighbor is added in the current iteration of the mod-
ule. False indicates that it is an existing neighbor.
Tier count Tier count to the neighboring cell. The Effective Tier count after Tier Count
Adjustment has been applied. A tier of 10,000 means it is unreachable
through the tier map.
Basic Tier Count Basic Tier count before Tier Count Adjustment.
Neighbor Type The neighbor types are existing, added, and removed.
Reason Descriptive reason for neighbor additions (for example, First Tier, HO
Based, Topology/Tier2+, Missing Reciprocal).
Score It is calculated from the tier count, distance and relative antenna orienta-
tions. It is also called the Coupling Score.
Neighbor rank Indicates the ranking with the neighbor type (Intra, IRAT).
Source LMS Layer The layer from the LMS which the source cell belongs to.
Neighbor LMS Layer The layer from the LMS which the neighbor cell belongs to.
Neighbor LMS Condi- The condition from the LMS which permits the neighbor relation.
tion Name
LMS Max Nbr Size The condition from the LMS which determines the maximum neighbor size.
Cannot Remove Rea- Descriptive reason why any existing neighbors are unsuitable for removal.
son
CSFB with PSHO Indicates whether CSFB with PS handover to the related neighbor cell is al-
lowed or forbidden after optimization. The values are:
• Allowed
• Forbidden
Redirect system infor- Indicates whether the related neighbor cell is a candidate for providing sys-
mation tem information in case of UE redirection to UTRAN or GERAN after opti-
mization. The values are:
• Allowed
• Forbidden
Table 56: Final neighbors (includes GSM-GSM neighbors and GSM-UMTS neighbors)
Source Parent The parent entity of the Source Cell. For LTE cells, it is the eNodeB ID.
Neighbor Frequency The frequency layer the neighbor cell belongs to.
Layer
• For WCDMA cells - the UARFCN
• For GSM cells - the Band
Reason Descriptive reason why the cell is considered for addition. Normally, it is First
Tier (through first tier addition phase), HO Based (through proxy relations) or
Topology/Tier2+ (other additions are done through the Tier map).
Tier Count Tier count to the neighboring cell. The Effective Tier count after Tier Count
Adjustment has been applied. A tier of 10,000 means it is unreachable
through the tier map.
Cell Coupling Score It is calculated from the tier count, distance and relative antenna orientations.
It is also called the Coupling Score.
HO Success Score The number of Handover Success counts on the proxy LTE-LTE intra-fre-
quency relation over the last 24 hour period.
Neighbor List Modifi- Indicates whether the neighbor relation is added or not added.
cation
Neighbor List Modifi- Descriptive reason for Not Added (for example, the candidate does not out-
cation Reason perform the current lowest ranked neighbor).
Detection Method Describes the proxy relations used to detect missing neighbors. For example:
4G->4G (co-sector 3G on target) or 4G->4G (co-sector 2G on target).
8.1.3.8 Changes
Table 58: Changes describes the columns present in the Changes sheet.
Source Parent The parent entity of the Source Cell. For LTE cells, it is the eNodeB ID.
Neighbor Frequency The frequency layer the neighbor cell belongs to.
Layer
• For WCDMA cells - the UARFCN
• For GSM cells - the Band
Reuse code • For WCDMA cells - the UARFCN + Primary Scrambling Code
• For GSM cells - the BCCH + BSIC
Tier Tier count to the neighboring cell. The Effective Tier count after Tier Count Ad-
justment has been applied. A tier of 10,000 means it is unreachable through
the tier map.
Source Frequency Frequency layer that the source cell belongs to.
Layer
Detection Method Describes the proxy relations used to detect missing neighbors.
3. From the Module/Service drop-down list, select the LTE ANR module instance.
You can view the event logs using the following filters:
Note: The common event levels are information and warning. By default, the warning
and error filters are selected. To view all the levels of events, clear the warning and
error filters.
5. Optional: In the Saved Filters field, enter a name for the event filter, and click the Save As New
Filter option to save the filter.
6. Click Filter.
Expected outcome
The events are listed based on the selected filter. For more information, see LTE ANR events.
Category: ANR_Blacklisting_and_Cleanup_LTE
EMS validation errors error The module has EMS validation errors.
Plan push failures error The module has plan push failures.
Skipped Target info The target is skipped because the source cell has
invalid neighbor relations.
Proposed Change Details info This event contains the blacklisted and unblacklist-
ed relation details.
Module Iteration Finished info The module run is completed. Since the module is
recursive, there are multiple entries for the same
instance.
Module Exception info The module has failed. Check the module logs for
more details.
Category: LTE_Frequency_Rules
EMS validation er- error The module has EMS validation errors.
rors
Plan push failures error The module has plan push failures.
Category: ANR_4G_IRAT
Failed to push changes! critical When provisioning fails during closed loop.
Attempted changes did critical When the EMS validation before the actual provisioning fails.
not pass EMS valida-
tion. See log for details.
Could not evaluate cell error If the cell does not satisfy all the initial ANR validations or if it
has a relation pointing to an invalid target cell then the cell is
skipped from optimization.
No first tiers error When there are no first tiers for the source cell.
No n tiers error When the n tier cannot be fetched for the cell with validation er-
rors.
neighbor_relation_unre- warning When the target cell of the relation is an unknown cell, the in-
solved ternal cell representation is not present in any OSS.
Could not trim neighbor warning When the module is not able to trim targets to the configured
list value.
Could not add particular warning When the target cell is not added because of LMS or module
neighbor configuration constraints.
For example:
Neighbor change event info Generates a cell event to indicate neighbor addition, removal,
or updation. The event type is added, updated, or removed.
For example:
• LTE_UMTS_Neighbor_Added
• LTE_UMTS_Neighbor_Updated
• LTE_UMTS_Neighbor_Removed
• LTE_GSM_Neighbor_Added
• LTE_GSM_Neighbor_Updated
• LTE_GSM_Neighbor_Removed
Attempted changes did info When the EMS validation before the actual provisioning fails.
not pass EMS valida-
tion. See log for details.
Module Exception info The module has failed. Check the module logs for more details.
Could not remove poor- warning Basic neighbor removal check failed.
ly performing neighbor
Prerequisites
3. In the left pane, click Modules, select the required module from the below options, and click
Apply.
• ANR_Blacklisting_and_Cleanup_LTE
Or
• ANR_4G_IRAT
Expected outcome
The SON changes for the selected module are displayed in a tabular format.
Scenario Description
Cell neighbor list evalu- <cell1> is evaluated and neighbor list changes are made and/or missing
ated neighbors are detected.
Detected <W> neighbors. Added <X> neighbors and removed <Y> neigh-
bors.
Note: The module generates the record in the Report tab only
for the cell which is evaluated under the following conditions:
Cell excluded <cell1> was excluded from evaluation due to: <reason for exclusion>
Example: PCH19704A21 was excluded from evaluation due to: Could not
trim (PCH19704A21) because sufficient neighbors could not be removed
to meet the max total size limit.
The ANR_Blacklisting_and_Cleanup_LTE module reports the records at cell level as defined in Table
63: Cell level records for ANR_Blacklisting_and_Cleanup_LTE. The cell level records can be viewed
from the Reports tab of the EdenNet GUI. See the View Reports section in the EdenNet User Guide
for more details.
Scenario Description
Scenario Description
Neighbor Blacklisted/ Blacklist Message: Neighbor cells <List of target cell names> are blacklist-
Neighbor UnBlacklisted ed from the source cell <source cell name> based on the LTE ANR Black-
listing module decision.
Example: Neighbor cell VC46722 is blacklisted from the source cell Ver-
celli-032 based on the LTE ANR Blacklisting module decision.
For more information, see the Configure and monitor SON modules section in the EdenNet User and
Administration Guide.
To view the Network Analysis table for the ANR 4G IRAT module or the ANR Blacklisting and Cleanup
LTE module, see the Viewing network analysis details section in the EdenNet User and Administration
Guide. It provides information about the reasons behind the changes pushed by the EdenNet mod-
ules.
To view the execution status, which provides the Instance Name and State of a selected module, as
well as the SON module's script log detailing the actions taken on individual target cells, see the View-
ing the execution status section in the EdenNet User and Administration Guide.
• Error: causes the module to stop working and log the incident that caused the module to stop.
• Warning: logs a detailed warning in the instance log.
Currently, only per cell warnings are defined for Module Monitor Service for ANR. These are:
– Cell has no location (latitude, longitude) (indicates that the location in the cell plan should be
checked).
• Triggered once every 24 hours:
– Cell has no first tier information (indicates that the location in the cell plan or tier count service
should be checked).
– Cell does not have any intra-frequency neighbors.
– Cell does not have any inter-frequency neighbors.
– Cell does not have any IRAT type neighbors.
– Cell does not have neighbors of any type.
– Cell has large tier counts for close surrounding cells (indicates that tier count service should
be checked).
12 Troubleshooting ANR
This section describes how to troubleshoot the ANR modules.
When ANR is run iteratively, it tries to create the same relations in every iteration. This results in provi-
sioning failure from the second iteration onwards. However, if ANR is triggered again after a few hours,
it proposes the correct relations and provisioning succeeds.
Possible scenarios:
The neighbors table is not updated properly because relation creation notifications are getting
dropped.
Solution
su - vson
3. Restart the mo_event_distributor_app by entering: