Professional Documents
Culture Documents
Netconf Manager Adaptor, System Administrator Guide
Netconf Manager Adaptor, System Administrator Guide
Administrator Guide
Disclaimer
The contents of this document are subject to revision without notice due to
continued progress in methodology, design and manufacturing. Ericsson shall
have no liability for any error or damage of any kind resulting from the use
of this document.
Trademark List
Contents
3 Configuration Tasks 5
3.1 Installation Directory Structure 5
3.2 Netconf Manager Adaptor Process 5
3.3 Parameter Handling 5
3.4 Upgrade/Install Impacts ( for NMA Load Balanced Nodes
Changes) 12
4 Logging 15
4.1 NMA Load Balanced Nodes Changes 18
6 MIM Switching 21
8 Corrective Maintenance 25
8.1 Corrective Maintenance for the Netconf Manager Adaptor 25
9 Action Support 27
10 Troubleshooting 29
10.1 Troubleshooting Netconf Manager Adaptor 29
10.2 Next Line Support 29
Glossary 31
Reference List 33
Note: 1. PICO is the RBS 6401 offering from the RBS family.
• System Administrator.
1.2 Prerequisites
It is assumed that users of this document:
NM and NMA is now scaled horizontally with multiple MCs. No of MCs will be
determined during installation/upgrade based on number of PICO and TCU cell
count given in system.ini. In 14B onwards 1:1 mapping is maintained between
NMA and NM. In future releases the mapping can be modified to m:n if required
with minimal design changes. Multiple adapters will be exposed to CS and
WMA and each adapter will be a separate MC. All the MCs possess same
functionality and capable of managing any NETCONF based node.
3 Configuration Tasks
/opt/ericsson/nms_nma/
2. bin: Contains scripts for starting the NMA managed component as well as
script for downloading MIM files from the node.
Note: A restart of the MC is required if the any of the above parameters are
changed.
/opt/ericsson/nms_cif_pas/bin
Result:
Name Value
notificationHandlerMaxPoolSize 20
sftp_port "22,31310,38830"
numberofretriesforbatch 5
mimFileDirLoc "/var/filem/nbi_root"
sgsnSynchPriority 1
partialSyncCorePoolSize 10
ecimMOMappingFile "/opt/ericsson/nms_umts_wranmom/dat/ECIM_Ma
neSupervisionTimeOut 5
partialSyncTimeOut 5
prbsFullSyncMaxPoolSize 10
nodeNotificationLimit 10000
maxMOsForOneTrans 500
fullSyncTimeout 10
fullSyncCorePoolSize 20
sftp_file_path "/opt/ericsson/nms_nma/bin/SFTP_Script.sh"
epgFullSyncCorePoolSize 5
epgFullSyncMaxPoolSize 5
prbsFullSyncCorePoolSize 10
nonEPGFullSyncMaxPoolSize 5
nonEPGFullSyncCorePoolSize 5
csconnectionmgrsize 120
partialSyncMaxQueueSize 5000
systemnotificationlimit 50000
batchSizePerCSTX 100
csTransactionTimeout 240
nePingIntervalMinutes 15
neSupervisionCorePoolSize 10
dirtyAttributeWriterInterval 30
ecimSynchPriority 1
synchPriority "false"
ecimBlackListedMIMsFile "/opt/ericsson/nms_umts_wranmom/dat/ECIM_Bl
partialSyncMaxPoolSize 10
neSupervisionMaxPoolSize 10
notificationHandlerCorePoolSize 20
notificationHandlerTimeOut 5
nmaadm_password "nmaadm"
To Add Number of PICO LTE cells and PICO WCDMA cells in the UTRAN
(WRAN+LTE) Network
• /opt/ericsson/nms_netconf/bin/netconfManager.pl upgrade
• /opt/ericsson/nms_nma/bin/netconfAdaptor.pl upgrade
Note: 1. Till 14A.1, there was just one NMA/NM MCs which used to manage
all the COM/ECIM nodes along with SGSN nodes. From 14 B onwards
the operator will need to configure multiple NMA/NM MC’s on its server
for PICO and TCU support. The additional NMA/NM MC’s will be
created based on the PICO [LTE + WCDMA] and TCU cell count once
user follows above steps.
2. WCDMA PICO cells , LTE PICO and TCU Cells should less than or
equal to WRAN , LTE and TCU cells respectively in all scenarios.
4 Logging
Logging is used for fault-localizing. The log level of all the logs in NMA by
default is INFO. Changes of log level to DEBUG should be done only when fault
information is to be sent to Ericsson.
NMA logs are updated in 6 different files. The different log files being updated
are:
1. /var/opt/ericsson/nms_nma/neSupervision.log
2. /var/opt/ericsson/nms_nma/full_sync.log
3. /var/opt/ericsson/nms_nma/notification.log
4. /var/opt/ericsson/nms_nma/exception.log
5. /var/opt/ericsson/nms_nma/nms_nma.log
6. /var/opt/ericsson/nms_nma/partial_sync.log
All the logs have INFO as the default log level. The log level can changed for
individual log file. For example, the config parameters for full_sync.log file are:
log4j.category.full.sync=INFO, FULLSYNC
log4j.additivity.full.sync=false
log4j.appender.FULLSYNC=org.apache.log4j.RollingFileAppender
log4j.appender.FULLSYNC.File=/var/opt/ericsson/nms_nma/log/full_sync.log
log4j.appender.FULLSYNC.MaxFileSize=10240KB
log4j.appender.FULLSYNC.MaxBackupIndex=5
log4j.appender.FULLSYNC.layout=org.apache.log4j.PatternLayout
log4j.appender.FULLSYNC.layout.ConversionPattern=%d{dd.MM.yyyy
HH:mm:ss,SSS} %-5p %X - %m%n
The first line mentions the log level. It should be changed to DEBUG when
collecting logs for sharing with Ericsson. It takes around a minute for the log
level to take effect. After changing the log level wait for one minute and then
execute the use case for which error is being observed which is the full synch
of a node. The full_sync.log file doesn't capture the logs at real time. The full
synch related log messages are collected and cached and once the synch is
completed the messages are marked ready for being written. A separate thread
that runs once every 30 seconds updates these messages into the full_sync.log
file. In case any issue with respect to the synch status of a node is observed
then along with full_sync.log file, exception.log file be also shared.
The logging level can be set globally or per package. The default global logging
level is INFO. The available logging levels are shown in .
log4j.rootLogger=INFO, R
log4j.category.com.ericsson.oss.common.nma.notification=INFO, NOTI
log4j.additivity.com.ericsson.oss.common.nma.notification=false
log4j.appender.NOTI=org.apache.log4j.RollingFileAppender
log4j.appender.NOTI.File=/var/opt/ericsson/nms_nma/log/notification.log
log4j.appender.NOTI.MaxFileSize=10240KB
log4j.appender.NOTI.MaxBackupIndex=5
log4j.appender.NOTI.layout=org.apache.log4j.PatternLayout
log4j.appender.NOTI.layout.ConversionPattern=%d{dd.MM.yyyy HH:mm:ss,SSS} %-5p %X
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=/var/opt/ericsson/nms_nma/log/nms_nma.log
log4j.appender.R.MaxFileSize=10240KB
log4j.appender.R.MaxBackupIndex=5
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{dd.MM.yyyy HH:mm:ss} %-5p %X - %m%n
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{dd.MM.yyyy HH:mm:ss} %-5p %X -
log4j.category.full.sync=INFO, FULLSYNC
log4j.additivity.full.sync=false
log4j.appender.FULLSYNC=org.apache.log4j.RollingFileAppender
log4j.appender.FULLSYNC.File=/var/opt/ericsson/nms_nma/log/full_sync.log
log4j.appender.FULLSYNC.MaxFileSize=10240KB
log4j.appender.FULLSYNC.MaxBackupIndex=5
log4j.appender.FULLSYNC.layout=org.apache.log4j.PatternLayout
log4j.appender.FULLSYNC.layout.ConversionPattern=%d{dd.MM.yyyy HH:mm:ss} %-5p %X
log4j.category.partial.sync=INFO, PARTIALSYNC
log4j.additivity.partial.sync=false
log4j.appender.PARTIALSYNC=org.apache.log4j.RollingFileAppender
log4j.appender.PARTIALSYNC.File=/var/opt/ericsson/nms_nma/log/partial_sync.log
log4j.appender.PARTIALSYNC.MaxFileSize=10240KB
log4j.appender.PARTIALSYNC.MaxBackupIndex=5
log4j.appender.PARTIALSYNC.layout=org.apache.log4j.PatternLayout
log4j.appender.PARTIALSYNC.layout.ConversionPattern=%d{dd.MM.yyyy HH:mm:ss} %-5p
log4j.category.exception.log=INFO, ERROR_LOG
log4j.additivity.exception.log=false
log4j.appender.ERROR_LOG=org.apache.log4j.RollingFileAppender
log4j.appender.ERROR_LOG.File=/var/opt/ericsson/nms_nma/log/exception.log
log4j.appender.ERROR_LOG.MaxFileSize=10240KB
log4j.appender.ERROR_LOG.MaxBackupIndex=5
log4j.appender.ERROR_LOG.layout=org.apache.log4j.PatternLayout
log4j.appender.ERROR_LOG.layout.ConversionPattern=%d{dd.MM.yyyy HH:mm:ss} %-5p %
log4j.category.ne.supervision=INFO, NESUPERVISION
log4j.additivity.ne.supervision=false
log4j.appender.NESUPERVISION=org.apache.log4j.RollingFileAppender
log4j.appender.NESUPERVISION.File=/var/opt/ericsson/nms_nma/log/neSupervision.lo
log4j.appender.NESUPERVISION.MaxFileSize=10240KB
log4j.appender.NESUPERVISION.MaxBackupIndex=5
log4j.appender.NESUPERVISION.layout=org.apache.log4j.PatternLayout
2. If a COM/ECIM node doesn't support notifications then the time at which the
synch is completed is updated for lostSynchronisation field of MeContext
MO. The mirrorMIBsynchStatus is marked as DISCOVERED and the
connectionStatus is marked as DISCONNECTED. In case of synch failure
the lostSynchronisation field is not updated and the mirrorMIBsynchStatus
is marked as UNSYNCHRONIZED whereas the connectionStatus is
marked as DISCONNECTED.
6 MIM Switching
1. Each Schema MO on the node holds the data for one MIM fragment that
the node supports. Alternatively, one Schema MO is defined for each of the
MIM fragment that the node supports.
4. If the MIM file for the version specified in the Schema MO is not present
on the OSS then NMA first reads the RanosCompatibilityInfo_Ecim.xml file
in /opt/ericsson/nms_umts_wranmom/dat directory. This file contains the
versions that are compatible with the version of the MIM present on the
OSS. If the version specified in Schema MO is neither explicitly supported
by OSS nor compatible as per RanosCompatibilityInfo_Ecim.xml then NMA
tries to download the MIM file from the node. The download location is
mentioned in the location attribute. The value mentioned in the location
attribute is taken as it is for downloading the MIM file.
5. The MIM file is downloaded onto the OSS server in the below directory:
/var/opt/ericsson/nms_nma/fc/
6. The file is downloaded and saved in the OSS with the name
mimName_mimVersion_mp.xml. The MIM name is established using the
Schema MO whereas the MIM version is the best compatible version. A
Ranoscompatibility file is generated which takes into account only the MOs
and attributes that the version on the OSS supports.
NMA then again tries to ping the node after 15 minutes. In case if it fails even
the second time then the next attempt i.e. the 3rd) is skipped. In short, the retry
interval increases from 15min ->30min -> 45 min -> 60 min(at max) and the
interval time increases on two successive failure.
8 Corrective Maintenance
Note: Netconf Manager Adaptor does not support warm restart of the
Managed Component (nma). Selecting warm restart has no effect on
Netconf Manager Adaptor, cold restart should be used instead.
9 Action Support
10 Troubleshooting
This chapter describes how to extract data required by the local Ericsson help
desk, in the event of faults or problems, that cannot be solved as outlined in the
previous chapter, occurring.
3. Keep a record of what other applications are running when the fault occurs.
4. Depending on what traces are required, and how tracing was initiated, go
to the relevant directory to obtain the trace file.
5. Forward the content of the relevant trace file(s) with a description of the
problem, using normal fault reporting procedures.
• Reproduce the fault with logging level set to DEBUG or ALL, and trace
type set to 0-199, as described in.
• Keep a record of what other applications are running when the fault occurs.
Glossary
Glossary
The OSS Glossary is available in Reference
[1].
Reference List