Hotfix Instructions for

Jiras: ENET-7947, ENET-17821, ENET-17816, ENET-17850, ENET- 17688

Product Family Operations Support Systems

Product Eden-NET

On Top of Release / MP Eden-NET 16 SP4 Build 430

Hotfix document Name Eden-Net16SP4_GA.docx

Problem Statement ENET-7947: LMS Enforcement should

exclude cells in exclusion list as target cells
as well.
ENET-17821: 2G ANR IRAT fails with
perform_ho_based_addition.
ENET-17816: ANR-2G IRAT: UTRAN_CELL
not being updated.
ENET-17850: LTE_CCO: KeyError:
'Includes_Backlobe_Coverage' appearing in
logs of LTE_CCO for runs which were
scheduled in SP2MP1 but got executed
after upgrade to SP4.
ENET- 17688: ANR_4G_IRAT failing because
of memory when it did not used to.
ENET-17837: MNC length is too short for
U2000.

Target Release for permanent Fix Eden-NET 17

Contact: Contact your local Nokia Networks support

Summary of changes:

Date Version Summary of changes

Mar-09-2017 1.0 First draft

Hotfix Instructions © Nokia Solutions and Networks 2015

Purpose:
This document contains installation instructions and other information for a hotfix
software delivery for the Nokia Solutions and Networks Eden-NET product. Hotfix is an
urgent unofficial software correction delivery for a critical customer case. Hotfix is
prepared and supported by the responsible R&D team until the hotfix delivery is
approved. Due to fast creation and lack of system level testing hotfix should be tested
also in the local customer test lab. Hotfix corrections are officially available in the later
Release, Maintenance Package (MP) and/or Priority Package (PP) or of the product.

1. Fixed Fault (PR) ID and Title:

ENET-17821 : 2G ANR IRAT fails with perform_ho_based_addition.

Impacted functionality: 2G ANR IRAT.

Hotfix Software Files:

Software Module Name Package Name Checksum

MDK ENET-17821.zip 2082163811

1. Hotfix Information
• Current Behaviour
Unhandled MissingData Exception is raised when the target DN of an adjacency
does not match an existing cell.
• Expected Behaviour
Exception should be handled gracefully.
• Technical Root cause
Insufficient regression testing.
• Technical Fix
Fixed relevant function call so that the exception won’t be raised.
• Other information

2. Prerequisites
Eden-NET 16 SP4 build 430 installed.
MDK version 1.11.1

Save this hotfix document and software files to the /var/hotfix/<Eden-NET release> eg:
/var/hotfix/Eden-NET 16 SP4 (Eden-NET Installation Server) directory. Create this
directory if it does not exist yet. This way it is easy to check and follow later on what
hotfixes have been installed in this system.

Note: Please create a directory based on customer installed release. This will help in
tracking the hotfixes installed on top of a specific release in customer environment.

Hotfix Instructions © Nokia Solutions and Networks 2015

3. Dependencies
• Not Applicable

4. System Impacts
• Some modules may be interrupted when restarting apps

5. Limitations/Restrictions
• Not Applicable

6. Backup
• Not necessary

7. Installation Instructions
• Copy ENET-17821.zip to /home/vson/ENET_17821 in App server, make sure vson
user has read + write permission (please change the patch path according to
convention you may be following)
• Unzip the ENET-17821.zip file under /home/vson/ENET_17821
$ unzip ENET-17821.zip
• Copy MDK-1.11.1.1.zip to site-packages directory
$ cp /home/vson/hotfix/MDK-1.11.1.1.zip
/home/vson/enet/lib/python2.7/site-packages
• Change directory to site-packages

$ cd /home/vson/enet/lib/python2.7/site-packages

• Upgrade MDK package

$ pip install --upgrade MDK-1.11.1.1.zip

• Restart escript and task apps (Note: This will interrupt running modules)

$ enet restart escript

$ enet restart task

8. Rollback
• Similar to installation instructions in section 7, but use MDK-1.11.1.zip in rollback
directory instead.
• Note: MDK must be uninstalled before downgrading to a previous
version
$ pip uninstall MDK

9. Test Instructions
• Run ANR_2G
o This issue only affects networks where cells were removed and existing
adjacencies pointing to those cells were NOT cleaned up. This would only
happen if CNAI was not used when removing cells. Therefore, verifying this fix
may not be possible if the issue is not present beforehand.

Hotfix Instructions © Nokia Solutions and Networks 2015

10. References
Not Applicable.

2. Fixed Fault (PR) ID and Title:

ENET-17816 – ANR-2G IRAT: UTRAN_CELL not being updated
Impacted functionality: ANR 2G IRAT.

Hotfix Software Files:

Software Module Package Name Checksum
Name

ENET-17816.zip /home/vson/enet 2656950165

/lib/python2.7/sit
It contains
ericsson_external_ce e-
packages/mdk/ne
ll_factory.py
ighbor_relation/v
endor/ext_cell_bu
ilders/ericsson_ex
ternal_cell_factor
y.py

1. Hotfix Information
• Current Behaviour
• For Ericsson, ANR 2G is unable to create DN for UTRAN_CELL objects in the
plan due to which error is thrown.
• Expected Behaviour
• ANR 2G proposes plan with correct DN.
• Technical Root cause
• In the Ericsson OSS, the RNC instances are created under
SubNetwork=UNDEFINED. But the ANR 2G module is trying to query RNC
objects under SubNetwork=ONRM_ROOT_MO.
• Technical Fix
• ANR 2G module queries for RNC objects under SubNetwork=UNDEFINED.
• Other information

2. Prerequisites
Eden-NET 16 SP4 build 430 installed.

Save this hotfix document and software files to the /var/hotfix/<Eden-NET release> eg:
/var/hotfix/EdenNET16SP4(Eden-NET Installation Server) directory. Create this directory
if it does not exist yet. This way it is easy to check and follow later on what hotfixes have
been installed in this system.

Note: Please create a directory based on customer installed release. This will help in
tracking the hotfixes installed on top of a specific release in customer environment.

Hotfix Instructions © Nokia Solutions and Networks 2015

3. Dependencies
• N/A
4. System Impacts
• Task and escript apps will be restarted.

5. Limitations/Restrictions
• Not Applicable

6. Backup
• Login to EdenNET application server as vson user
• Create folder /home/vson/ENET_17816/backup
$ mkdir -p /home/vson/ENET_17816/backup
• Copy the existing ericsson_external_cell_factory.py present under site-packages to
newly created backup directory.
$ cp -p /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/ericsson_external_cell_factory.
py /home/vson/ENET_17816/backup

7. Installation Instructions
• Copy ENET_17816.zip from /var/hotfix/<Eden-NET release> to
/home/vson/ENET_17816 in App server, make sure vson user has read and write
permission (please change the patch path according to convention you may be
following).
$ chmod 644 /home/vson/ENET_17816/ENET-17816.zip

Note : If the file is not copied as vson user, execute below command:
$ chown vson:vson /home/vson/ENET_17816/ENET-17816.zip

• Login to the Application Server as vson user.

• Unzip the ENET-17816.zip file
$ unzip ENET-17816.zip

• Replace python files:

$ cp -p /home/vson/ericsson_external_cell_factory.py
/home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/ericsson_external_cell_factory.
py

• Restart task app on Eden-NET:

$ enet restart task

• Restart the escript app on Eden-NET:

$ enet restart escript

Hotfix Instructions © Nokia Solutions and Networks 2015

8. Rollback
• Log in to app server as vson user
• Copy the ericsson_external_cell_factory.py from backup directory.
$ cp -p /home/vson/ENET_17816/backup/ericsson_external_cell_factory.py
/home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/ericsson_external_cell_factory.
py
• Restart task service on Eden-NET:

$ enet restart task

• Restart the escript service on Eden-NET:

$ enet restart escript

9. Test Instructions
• Login to the Eden-NET UI.
• Trigger ANR 2G module execution for Ericsson cell. Module should run and
completed successfully with a proper plan generated for UTRAN_CELL objects.

3. Fixed Fault (PR) ID and Title:

ENET-17850: SyVe: LTE_CCO: KeyError: 'Includes_Backlobe_Coverage' appearing in logs of
LTE_CCO for runs which were scheduled in SP2MP1 but got executed after upgrade to SP4

Impacted functionality: LTE CCO.

Hotfix Software Files:

Software Module Name Package Name Checksum

ENET-17850.zip apply_enet_17850_hotfix.sh 1184192127

LTECCO-0.0.2-py2-none-
This zip file contains the any.whl
following
apply_enet_17850_hotfix.sh
LTECCO-0.0.2-py2-none-
any.whl

1. Hotfix Information
• Current Behaviour
When LTECCO module instance is scheduled from previous version of Eden-NET
(prior 16 SP4) then after upgrade to 16 SP4, when this instance is triggered,
module fails with following error:
“17-03-08 04:30:43-UTC[ERROR] KeyError: 'Includes_Backlobe_Coverage'”

Hotfix Instructions © Nokia Solutions and Networks 2015

 • Expected Behaviour
Scheduled LTECCO module instance runs without any issues.

• Technical Root cause

From release 16 SP4, new gui configuration parameters has been added. Modules
scheduled prior this release didn’t has this parameter in configuration, which
caused KeyError during read attempt.

• Technical Fix
Default values are added in place where configuration didn’t contain new
configuration keys..

• Other information
NA.

2. Prerequisites
Eden-NET 16 SP4 build 430

Save this hotfix document and software files to the /var/hotfix/<Eden-NET release> eg:
/var/hotfix/Eden-NET-16-4.0 (Eden-NET Installation Server) directory. Create this
directory if it does not exist yet. This way it is easy to check and follow later on what
hotfixes have been installed in this system.

Note: Please create a directory based on customer installed release. This will help in
tracking the hotfixes installed on top of a specific release in customer environment.

3. Dependencies
• Not Applicable

4. System Impacts
• Not Applicable

5. Limitations/Restrictions
• Not Applicable

6. Backup
Ensure that on server (which need to be updated) there is a backup of LTECCO module
which can be reused during backup procedure. Module should be available in
/tmp/installer/site-packages folder as LTECCO-xxx.whl file, where xxx is a version
number

7. Installation Instructions
All below commands needs to be run in App server node.
• Stop in Eden-NET all running instances of LTECCO module.
• Copy hot fix package into Eden-Net APP server.

Hotfix Instructions © Nokia Solutions and Networks 2015

 • Unzip package
• Change working directory to newly extracted directory
• Add permission to execute to all .sh files inside directory
chmod 755 ./*.sh
• Ensure all further command are executed as vson user
sudo su - vson
• Run hot fix installation script
./apply_enet_17850_hotfix.sh

8. Rollback
• Stop in Eden-NET all runing instances of LTECCO module.
• Login into Eden-Net APP server.
• Go to /tmp/installer/site-packages
• Ensure all further command are executed as vson user
sudo su - vson
• Run hot fix rollback procedure
pip install --no-dependencies -U ./LTECCO-xxx.whl
, where xxx is a version number

9. Test Instructions
Eden-NET should be in version prior to 16 SP4 (e.g 16 SP2 MP1). Test require to schedule
LTECCO module instance and then upgrade Eden-NET to 16 SP4.

a. Schedule LTECCO module in open loop to run after some delay. Make sure that at least
one cell has neighbors.
b. Upgrade Eden-NET to 16 SP4 and then apply the patch.
c. Wait until scheduled module instance is executed.

4. Fixed Customer Fault (PR) ID and Title:

ENET-17688 : ANR_4G_IRAT failing because of memory when it did not used to.

Impacted functionality: ANR_4G_IRAT

Hotfix Software Files:

Software Module Name Package Name Checksum

ANR3 ENET-17688.zip 2939012197

1. Hotfix Information
• Current Behaviour
By default, all ANR modules will construct the ‘Final Neighbors’ tab in the output
xlsx report. This takes up a lot memory and can cause the module to fail with a
large cluster.
• Expected Behaviour

Hotfix Instructions © Nokia Solutions and Networks 2015

 ‘Final Neighbors’ tab should be disabled by default and should only be constructed
when it is explicitly configured in the configuration file.
• Technical Root cause
We did not anticipate how much memory this tab would consume
• Technical Fix
Changed the default behavior to optimize memory usage
• Other information

2. Prerequisites
Eden-NET 16 SP4 build 430

Save this hotfix document and software files to the /var/hotfix/<Eden-NET release> eg:
/var/hotfix/Eden-NET 15 SP4 (Eden-NET Installation Server) directory. Create this
directory if it does not exist yet. This way it is easy to check and follow later on what
hotfixes have been installed in this system.

Note: Please create a directory based on customer installed release. This will help in
tracking the hotfixes installed on top of a specific release in customer environment.

3. Dependencies
• Not Applicable

4. System Impacts
• Some modules may be interrupted when restarting apps

5. Limitations/Restrictions
• Not Applicable

6. Backup
• Not necessary

7. Installation Instructions
• Copy ENET-17688.zip to /home/vson/ENET_17688 in App server, make sure vson
user has read + write permission (please change the patch path according to
convention you may be following)
• Unzip the ENET-17688.zip file under /home/vson/ENET_17688
$ unzip ENET-17688.zip
• Copy ANR3-3.12.0.1.zip to site-packages directory
$ cp /home/vson/ENET-17688/hotfix/ANR3-3.12.0.1.zip
/home/vson/enet/lib/python2.7/site-packages
• Change directory to site-packages

$ cd /home/vson/enet/lib/python2.7/site-packages

• Upgrade ANR3 package

$ pip install --upgrade ANR3-3.12.0.1.zip

Hotfix Instructions © Nokia Solutions and Networks 2015

• Restart escript and task apps (Note: This will interrupt running modules)

$ enet restart escript

$ enet restart task

8. Rollback
• Similar to installation instructions in section 7, but use ANR3-3.12.0.zip in rollback
directory instead.
• Note: ANR3 must be uninstalled before downgrading to a previous
version
$ pip uninstall ANR3

9. Test Instructions
• Run ANR_4G_IRAT (or other ANR) on a large cluster (>10,000) and ensure it completes.

5. Fixed Fault (PR) ID and Title:

ENET-17837– MNC length is too short for U2000.
Impacted functionality: ANR_4G_IRAT in Huwaei.

Hotfix Software Files:

Software Package Name Checksum
Module
Name

ENET-17837.zip 3843303747

1. Hotfix Information
• Current Behaviour
• ANR run fails with Provisioning error on Huawei OSS.

• Expected Behaviour
• Error does not occur

• Technical Root cause

• Single digit MNC values are found for many cells on Eden Net DB, due to
this reason new MO’s are created with single digit MNC values which is not
acceptable on the EMS.

• Technical Fix

Hotfix Instructions © Nokia Solutions and Networks 2015

 • Code has been added to default MNC value to minimum of 2 digits

• Other information

2. Prerequisites
Eden-NET 16 SP4 build 430 installed.

Save this hotfix document and software files to the /var/hotfix/<Eden-NET release> eg:
/var/hotfix/Eden-NET 16 SP4(Eden-NET Installation Server) directory. Create this
directory if it does not exist yet. This way it is easy to check and follow later on what
hotfixes have been installed in this system.

Note: Please create a directory based on customer installed release. This will help in
tracking the hotfixes installed on top of a specific release in customer environment.

3. Dependencies
• N/A
4. System Impacts
• escript and task service will be restarted.

5. Limitations/Restrictions
• Not Applicable

6. Backup
• Login to EdenNET application server as vson user
• Create folder /home/vson/ENET-17837/backup
$ mkdir -p /home/vson/ENET-17837/backup
• Copy the existing huawei_optimizer_lte.py and
huawei_external_cell_factory.py present under site-packages to newly
created backup directory and delete the python compiled file:
$ cp /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/huawei_optimizer_lte.py /home/vson/ENET-
17837/backup/
$ cp /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/huawei_external_cell_factory.p
y /home/vson/ENET-17837/backup/
$ rm /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/huawei_optimizer_lte.pyc
$ rm /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/huawei_external_cell_factory.p
yc

Note:
Please change the backup directory path according to the convention folowed at
customer site.

Hotfix Instructions © Nokia Solutions and Networks 2015

 7. Installation Instructions
• Copy ENET-17837.zip from /var/hotfix/<Eden-NET release> to
/home/vson/ENET-17837 in App server, make sure vson user has read + write
permission (please change the patch path according to convention you may be
following).
$ chmod 644 /home/vson/ENET-17837.zip

Note : If the file is not copied as vson user, execute below command:
$ chown vson:vson /home/vson/ENET-17837/ENET-17837.zip

• Login to the Application Server as vson user.

• Unzip the ENET-17837.zip file under /home/vson/ENET-17837
$ unzip ENET-17837.zip

• Replace python files:

$ cp /home/vson/ENET-17837_secured/huawei_optimizer_lte.py
/home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/huawei_optimizer_lte.py
$ cp /home/vson/ENET-17837_secured/huawei_external_cell_factory.py
/home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/huawei_external_cell_factory.p
y

• Restart task service on Eden-NET:

$ enet restart escript

$ enet restart task

8. Rollback
• Log in to app server as vson user
• Replace python files with backup:
$ cp /home/vson/ENET-17837/backup/huawei_optimizer_lte.py
/home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/huawei_optimizer_lte.py
$ cp /home/vson/ENET-17837/backup/huawei_external_cell_factory.py
/home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/huawei_external_cell_factory.p
y
$ rm /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/huawei_optimizer_lte.pyc
$ rm /home/vson/enet/lib/python2.7/site-
packages/mdk/neighbor_relation/vendor/ext_cell_builders/huawei_external_cell_factory.p
yc
• Restart task service on Eden-NET:

Hotfix Instructions © Nokia Solutions and Networks 2015

$ enet restart escript
$ enet restart task

9. Test Instructions
• Login to the Eden-NET UI.
• Trigger ANR_4G_IRAT module execution. Module should run and complete
successfully.

6. Fixed Fault (PR) ID and Title:

ENET-7497 : LMS Enforcement should exclude cells in exclusion list as target cells as well.

Impacted functionality: LMS Enforcement.

Hotfix Software Files:

Software Module Name Package Name Checksum

LMSEnforcement.py ENET-7497.zip 1124140838

1. Hotfix Information
• Current Behaviour
There should be a way to exclude the cells in the exclusion lists when they are as
targets in a neighbor relation as well..
• Expected Behaviour
LMS Enforcement should not remove relations where the target is on the
exclusion list.
• Technical Root cause
Currently by design, the cells on the exclusion list are only being excluded as
source cell and they could be deleted when they are the target cell in a neighbor
relation and the neighbor relation dont compy with the LMS.
• Technical Fix
To exclude the cells as both source and target. LMS Enforcement withh by default
behave in a manner consistent with ANR. i.e. it should not remove relations where
the target is on the exclusion list.
• Other information

2. Prerequisites
Eden-NET 16 SP4 build 430 installed.

Save this hotfix document and software files to the /var/hotfix/<Eden-NET release> eg:
/var/hotfix/Eden-NET 15 SP4 (Eden-NET Installation Server) directory. Create this

Hotfix Instructions © Nokia Solutions and Networks 2015

directory if it does not exist yet. This way it is easy to check and follow later on what
hotfixes have been installed in this system.

Note: Please create a directory based on customer installed release. This will help in
tracking the hotfixes installed on top of a specific release in customer environment.

3. Dependencies
• Not Applicable.

4. System Impacts
• Not Applicable.

5. Limitations/Restrictions
Not Applicable

6. Backup
Not necessary

7. Installation Instructions
• Copy ENET-7497.zip to /home/vson/ENET_7947 in App server, make sure vson user
has read + write permission (please change the patch path according to convention
you may be following)
• Unzip the LMSEnforcement.zip file under /home/vson/ENET_7947
$ unzip ENET-7497.zip
• Change the directory to /home/vson/
• As vson user execute the command:
son_module_manager add -m LMSEnforcement -s ./

8. Rollback
• Not Applicable

9. Test Instructions
• Run LMSEnforcement.py with cells in exclusion list, this will result in excluding the
target cells also.

Hotfix Instructions © Nokia Solutions and Networks 2015