Eden Net Integration Ac Vs Direct Oss
Eden Net Integration Ac Vs Direct Oss
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.
EdenNet deployment with and without DN09273754 1-0 Table of Contents
AC: Differences in data representation,
visualization, and behavior
Contents
1 Summary of changes...................................................................................................................................... 5
2 Overview........................................................................................................................................................... 6
3 CM interfaces................................................................................................................................................... 8
19 PLMN identity...............................................................................................................................................31
20 CM Operation logs...................................................................................................................................... 32
21 NE version compatibility............................................................................................................................ 33
22 Glossary........................................................................................................................................................34
1 Summary of changes
Deleted sections:
EdenNet 19A FP 2004 This is a document that describes the differences in data represen-
tation, visualization, and behavior in EdenNet deployment with direct
OSS and AC based integrations.
2 Overview
EdenNet is evolving by introducing a new CM framework utilizing Nokia’s existing CM product called
Advanced Configurator (AC/NAdC). EdenNet is integrated to EMS/OSS through an AC mediation lay-
er (for Configuration Management (CM)) and it is directly integrated to the EMS (for Performance Man-
agement (PM)). AC mediation layer supports multi-vendor, multi-technology, and multi-OSS network.
This document provides an overview of EdenNet deployment with and without AC. The differences in
data representation, visualization, and behavior between AC and direct OSS integration is described,
so that, the operators can enhance their adapted modules and improve the user experience with
EdenNet.
With the AC based solution, there are some changes in terms of how CM data is represented and
stored in EdenNet when compared to direct OSS integration.
While some changes are specific to the vendor and technology, some are common. It covers the major
differences for the adapted modules (new as well as pre-existing) and configuration files (which takes
CM managed objects and parameter names as input).
The operator who uses EdenNet without AC based solution will experience some differences in CM
data representation. Also, the adapted modules developed by the operator might be impacted.
Table 2: Supported vendor and technology lists the EMS, vendor, and technology support with AC
based integration.
Vendor Technology
ZTE UME 4G
Note:
Note: Nokia only supports the use of AC based integration for Nokia, Ericsson, and Huawei
vendors as direct CM integration is deprecated from EdenNet 21 release onwards for these
vendors.
3 CM interfaces
Table 3: CM Interfaces lists the CM interfaces used in AC and direct OSS integration for Nokia,
Huawei, and Ericsson.
Ericsson BULK CM Interface (CNAI and BCG with Per MO based CM interface
OSSRC/REST with ENM) (CNAI, BCG, and REST)
Table 3: CM Interfaces
All All CM MOs and parameters (including Only a few chosen CM MOs and
radio and transport) supported by the parameters are stored in the
OSS/EMS are stored in the AC data- EdenNet database.
base.
Note: This will im- For example, EARFCNDL For example, earfcndl
pact the PCE con- parameter of CELL MO is in parameter of CELL MO is in
Huawei (all RATs) Parameter type: Bit String (where Parameter type: Bit String
one parameter consists of multiple
Note: PCE configu- Note: In direct OSS
bits having bit name, index, and
ration files might be integration, the PCE
values). The PCE module supports
changed. module supports bit
bit level auditing and enforcement.
level auditing and en-
For more information, see Pa-
Note: Supported for all forcement only for
rameter Consistency Check
Huawei RATs. Huawei 2G and 3G.
and Enforcement (PCE)
Guide. This is not applicable
for Huawei 4G.
Nokia (all RATs) Parameter type: Bit String (where Parameter type: Bit String
one parameter consists of multiple
For more information, see Pa- Operator should specify the col-
bits having bit name, index, and
rameter Consistency Check lated integer value of all the bits
values)
and Enforcement (PCE) mentioned in the parameter.
Guide. Operator should specify the col-
lated integer value of all the bits
mentioned in the parameter. Be-
havior is same as in direct OSS in-
tegration.
Ericsson 2G, 3G, 4G, and 5G Parameter type: Structure para- Parameter type: Structure pa-
meter rameter
With the
retainNativeDNFormat flag
set to False, the plain structure
parameters are split into multiple
parameters with an underscore
( _ ) as a delimiter between
the parameter name and sub
parameter name.
For example:
• Plmnid_mcc
• Plmnid_mnc
• Plmnid_mnclength
With the
retainNativeDNFormat flag set
to True, the structure parameter
representation is the same as
direct integration solution.
Note: The PCE migration tool is no longer supported. This tool is used only by the Nokia
technical support team.
• UI (symbolic name)
• Internal values
For example:
• Adapted modules should fetch and provision the parameter values in UI format using
SDK interfaces. The configuration files should contain the UI format for the parameter
values. It is valid for all parameter types, vendors, and technologies.
• EdenNet stores and accepts only the UI values of the CM parameters.
• In the EMS/OSS, for few parameter types, the value can be in internal format and some
can be in UI format.
• EdenNet recommended UI values can be different from the native values present in the
EMS/OSS.
• There are some parameters with a special value. Generally, there is a number and de-
scription attached to that value. EdenNet will always return and accept the number irre-
spective of UI or internal value being asked for. This is valid from 19 SPAC1912 AC re-
lease. Prior to this release, the associated number was returned as the internal value
and description as UI value.
• By default, EdenNet accepts and provision the plan with UI values.
Note: In EdenNet
GUI, DB, and reports
the internal values will
change to the UI val-
ues for adapted mod-
ules.
Note: For Nokia, Ericsson, and Huawei (2G and 3G), the parameter behavior is consistent in
AC based and direct OSS integration.
The PCE migration tool is no longer supported. This tool is used only by the Nokia technical
support team.
For example, for cell XXXXX, the oss value for spectrumEmissionReqMapping is []
Request:
ems.getEMSAttributes({'SubNetwork=ONRM_ROOT_MO,SubNetwork=ABCD,
MeContext=YYYY,ManagedElement=1,ENodeBFunction=1,EUtranCellFDD= XXXXX:
['spectrumEmissionReqMapping']})
Response:
{'SubNetwork=ONRM_ROOT_MO,SubNetwork=ABCD,MeContext=YYYY,
ManagedElement=1,ENodeBFunction=1,EUtranCellFDD= XXXXX ':
{u'spectrumEmissionReqMapping': []}}
From AC19 onwards, if the parameter is not present or the parameter value is set to null in the EMS,
then the parameter will not be stored in the database, unlike direct OSS integration where the parame-
ter is stored in the database.
For example, for cell XXXXX, the oss value for spectrumEmissionReqMapping is null.
Request:
ems.getEMSAttributes({'SubNetwork=ONRM_ROOT_MO,SubNetwork=ABCD,
MeContext=YYYY,ManagedElement=1,ENodeBFunction=1,EUtranCellFDD= XXXXX ':
['spectrumEmissionReqMapping']})
Response:
{'SubNetwork=ONRM_ROOT_MO,SubNetwork=ABCD,MeContext=YYYY,
ManagedElement=1,ENodeBFunction=1,EUtranCellFDD= XXXXX ': {}}
Table 7: GetChildAttribute API usage describes the usage of GetChildAttribute API in direct OSS
and AC based integration.
The GetChildAttribute API can be used to The GetChildAttribute API is used to query
fetch MO parameters, by passing the parent DN only the child CM MOs and parameters.
and parent MO type in a query to fetch parame-
ters. Ideally, this API should be used to get MO
parameters of the child MOs of the parent and
not its own.
Table 8: DN format change describes the DN format change in direct OSS and AC based integration
for various vendors.
Vendor Change
Nokia (all RATs) In AC based integration, the change is in the root element of DN. Second
PLMN is replaced with actual region name.
For example:
Direct integration:
PLMN-PLMN/MRBTS-12/LNBTS-34/LNCELL-123
AC based integration:
PLMN-Bangalore/MRBTS-12/LNBTS-34/LNCELL-123
Ericsson (all RATs) with In AC based integration, the delimiters between Managed Objects (MOs)
retainNativeDNFor- and their values are changed.
mat set to False
Root prefix is changed from:
For example:
SubNetwork=SysRegion,MeContext=ABC001,ManagedElement=1,
ENodeBFunction=1,EUtranCellFDD=BBK0400AQW
ENM-Mysore/SubNetwork-SysRegion/MeContext-ABC001/
ManagedElement-1/ENodeBFunction-1/EUtranCellFDD-BBK0400AQW
SubNetwork=SysRegion,MeContext=ABC001,
ManagedElement=1,
ENodeBFunction=1,EUtranCellFDD=BBK0400AQW
Vendor Change
E3SUB-Mysore/SubNetwork-SysRegion/MeContext-ABC001/
ManagedElement-1/ENodeBFunction-1/EUtranCellFDD-BBK0400AQW
SubNetwork=SysRegion,BSC=1,INTERNAL_CELL=BBK0400AQW
E2SUB-Mysore/SubNetwork-SysRegion/BSC-ABC001/INTERNAL_
CELL-BBK0400AQW
Ericsson 2G, 3G, 4G, In AC based integration, root prefix is changed from:
and 5G with retainNa-
• Subnetwork=ONRM_ROOT to ENM=<RegionName> for OSS ENM
tiveDNFormat set to
• E3SUB in case of OSSRC 3G/4G
True
• E2SUB in case of OSSRC 2G
For example:
SubNetwork=SysRegion,MeContext=ABC001,
ManagedElement=1,ENodeBFunction=1,EUtranCellFDD=BBK0400AQW
ENM=Mysore,SubNetwork=SysRegion,MeContext=ABC001,
ManagedElement=1,ENodeBFunction=1,EUtranCellFDD=BBK0400AQW
SubNetwork=SysRegion,MeContext=ABC001,ManagedElement=1,
ENodeBFunction=1,EUtranCellFDD=BBK0400AQW
E3SUB=Mysore,SubNetwork=SysRegion,MeContext=ABC001,
ManagedElement=1,ENodeBFunction=1,EUtranCellFDD=BBK0400AQW
Huawei (LTE) The root prefix is changed from H4GN to HNCGN. Root element con-
tains the sub-region name.
For example:
Direct Integration:
H4GN-1/ENODEB30-12/ENODEB-1/RADIO-1/CELL-123
Vendor Change
AC based integration:
HNCGN-<Regionname>/ENODEB-12/CELL-123
For example:
Direct integration:
BSC6900UMTSNE=RNCNAME,CELL=CELLID_123
AC based integration:
HNCGN-<Regionname>/RNC-123/UCELL-123
Note: There are MOs that contain parameters with reference DN. These reference parame-
ter DNs takes the new DN format.
In AC based solution, all the relation objects are represented directly under cell objects. In direct
integration, all the relations are available under FreqRelation MOs.
For example:
ENM=Mysore,SubNetwork=SysRegion,MeContext=ABC001,ManagedElement=1,ENodeBFunction=
1,EUtranCellFDD=BBK0400AQW,EUtranFreqRelation=345,EUtranCellRelation=AB56XO
ENM-Mysore/SubNetwork-SysRegion/MeContext-ABC001/ManagedElement-1/
ENodeBFunction-1/EUtranCellFDD-BBK0400AQW/EUtranCellRelation-AB56XO
In Direct integration, the cell name is taken as input from the cell-ret mapping file, but in AC based in-
tegration, operators need to define the cell DN instead of cell name.
For Nokia, cell name can be accepted, but the cell name must be unique in the network. For more in-
formation, contact Nokia technical support team.
RET mapping file examples for Nokia, Huawei, and Ericsson in the new format are as follows:
cell dn ret dn
HNCGN-NORTH/RAN-BA0441_RNC_BAC/ HNCGN-NORTH/NODEB-CL0934_1_U/
UCELL-12652 RETSUBUNIT-0+1
HNCGN-SOUTH/ENODEB-BA0WER0_GUL/ HNCGN-SOUTH/ENODEB-BA053098_GUL/
CELL-1 RETSUBUNIT-0+1
Table 9: Huawei
cell dn ret dn
E3SUB-Bangalore/SubNetwork-RREN1/MeCon- E3SUB-Bangalore/SubNetwork-RREN1/MeCon-
text-RREN1/ManagedElement-1/RncFunction-1/ text-UARBCO/ManagedElement-UARBCO/
UtranCell-2004AGKOSK Equipment-1/AntennaUnitGroup-2/AntennaN-
earUnit-2100/RetSubUnit-1
cell dn ret dn
SubNetwork=RREN1,MeContext=RREN1, SubNetwork=RREN1,MeContext=UARBCO,
ManagedElement=1,RncFunction=1, ManagedElement=UARBCO,
UtranCell=2004AGKOSK Equipment=1,
AntennaUnitGroup=2,AntennaNearUnit=2100,
RetSubUnit=1
Cell dn RET DN
PLMN-Bangalore/MRBTS-26009/LNBTS-123/LN- PLMN-Bangalore/MRBTS-26009/RET-2
CEL-234
The plan name generated in EdenNet and The plan name generated in EdenNet is different from
pushed to OSS are the same. what is pushed to the OSS through AC mediation.
For example:
In EdenNet, Adapted modules and EdenNet In AC integration, EdenNet and AC check the validi-
modules creates plan, which may contain in- ty of plans generated by the modules. If the entry for
valid parameter information. EdenNet pushes any MO is not correct in the plan file, EdenNet will
the plan to the OSS and let it fail with valida- filter out those invalid entries. EdenNet then contin-
tion failure step at the OSS.
EdenNet creates the plan per OSS level and EdenNet creates one plan per module execution
these plans are visible in the EdenNet Provi- containing all the changes belonging to all OSS
sioning Logs tab in GUI. (regions) integrated in the AC mediation layer. AC
splits the combined plan per OSS level.
The operator can view the KPI chart per OSS The operator cannot view the KPI chart per OSS
(region level) integrated in EdenNet. level. The operator can view one chart for all re-
gions that belong to same the vendor (aggregated
data) in one single graph.
EdenNet supports the configuration of user la- Configuration of user label is not supported.
bel for the cells.
EdenNet fetches and stores the CM metadata EdenNet does not fetch the CM metadata online
directly from the OSS system. from the OSS. It builds and stores the information
based on the offline CM metadata available in AC.
Note: Valid for Nokia and Ericsson
(3G and 4G).
EdenNet does the MO based CM upload at EdenNet does the CM upload for the whole region
defined intervals. (not MO level) at every defined interval (default is 6
hours). To change the CM upload frequency, contact
For example:
Nokia technical support team. This is valid for Erics-
• eNodeBs and RNCs - every 6 hours son and Huawei.
• Cell - every 4hours
Nokia data is always in real time synch with AC lay-
• Relation - every 2 hours
er through notifications and with bulk CM upload
once in a day.
Note: Nokia NetAct sends the notification for every create, update, and delete operation of
CM managed objects, even if the change is triggered by an EdenNet user or not. In this way,
EdenNet and AC is always in sync with NetAct. EdenNet triggers full CM upload from NetAct
with the help of AC once in 24 hours. This will benefit the operators and each instance of the
module will run with up to date data. There is no need to parse the complex feedback logs
generated during plan provisioning that is initiated via raccli interface in direct OSS integra-
tion.
The EdenNet and Adapted modules need not create or modify regional external cells and add the
cell information while creating or modifying relations. These modules have to put the actual target
or neighbor cell dn in the adjacentCell parameter or targetCelldn parameter (non-network),
while creating or modifying relations. There is no need for any other mandatory parameters unless the
operator specifically asks for it.
Note: The adjacentCell parameter is used for non-Nokia vendors and targetCelldn
parameter for Nokia.
Hence, the regional external cells are not stored in the EdenNet database directly. If any module wants
to fetch the regional external cells from the AC CM layer, they can query using SDK APIs.
Table 20: External cell handling describes the external cell handling in direct OSS and AC integration.
In EdenNet, only ANR module creates external EdenNet modules deal with changes in the cell and
cells that belong to the same OSS region. creates or modifies the relation MOs but not the ex-
ternal cells.
EdenNet directly stores all the global external cells in it's database. For example, EXUCE is the MO
type to represent 3G global external cells.
There is no specific handling of the special In AC integration, forward slash '/ ' has a special
character, forward slash '/' in DN. meaning and it can be present as the MO instance
identifier value. EdenNet replaces '/ ' with '|\\' value.
EdenNet does not change the reference DN The reference DN parameters values will contain
parameter values. the 3GPP MO names instead of vsData prefixes.
19 PLMN identity
As per the 3GPP specification, MCC and MNC (as part of PLMN identity) are represented in string, but
EdenNet treats them as integer. If an operator or nearby regions have MNC as both 001 and 01, then
EdenNet treats them as 1. This is the existing behavior in EdenNet with direct OSS and AC based in-
tegrations. However, the new CM AC layer of EdenNet treats MNC and MCC as string.
20 CM Operation logs
CM Operation logs describes the difference in the CM operation log process for direct OSS and AC
based integrations.
The CM upload and download provision opera- The CM operations towards OSS can be viewed
tions that directly interface with the EMS/OSS are in the AC CM Operation Manager UI.
available in the region specific cm.cache and cm.
main logs present in the EdenNet VMs. So, the
operator knows about the steps of the operation
and can troubleshoot in case of failure.
21 NE version compatibility
Table 24: NE version compatibility describes EdenNet's support for non-compatible NE versions in di-
rect OSS and AC based integrations.
In direct OSS integration, if the operator has up- In AC based integration, the support for non-com-
graded to a non-compatible NE version, but there patible NE version is possible by mapping to the
are no changes related to EdenNet modules and latest EdenNet version to avoid any functionality
functionality, then EdenNet will continue to sup- breaks. Contact Nokia technical support team to
port the non-compatible NE version till the official configure this mapping.
compatible EdenNet version is available. This is
because the CM metadata is fetched online from
Ericsson and Nokia EMS/OSS.
22 Glossary
Table 25: Glossary describes the common terms used in EdenNet AC integrations.
Term Description
AC Advanced Configurator
CM Configuration Management
DB EdenNet Database
DN Distinguished Name
MO Managed Object
UI User Interface