Configuring SNMP Version One Nbi
Configuring SNMP Version One Nbi
(VMware)
Nokia is committed to diversity and inclusion. We are continuously reviewing our customer documentation and consulting with standards
bodies to ensure that terminology is inclusive and aligned with the industry. Our future customer documentation will be updated accordingly.
This document includes Nokia proprietary and confidential information, which may not be distributed or disclosed to any third parties without
the prior written consent of Nokia.
This document is intended for use by Nokia’s customers (“You”/”Your”) in connection with a product purchased or licensed from any company
within Nokia Group of Companies. Use this document as agreed. You agree to notify Nokia of any errors you may find in this document;
however, should you elect to use this document for any purpose(s) for which it is not intended, You understand and warrant that any
determinations You may make or actions You may take will be based upon Your independent judgment and analysis of the content of this
document.
Nokia reserves the right to make changes to this document without notice. At all times, the controlling version is the one available on Nokia’s
site.
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.
Copyright and trademark: Nokia is a registered trademark of Nokia Corporation. Other product names mentioned in this document may be
trademarks of their respective owners.
© 2023 Nokia.
Contents
1 Setting filters....................................................................................................................................................4
1.1 Setting filters by modifying SNMP NBI configuration file..........................................................................4
1.1.1 Setting filterId.................................................................................................................................... 4
1.1.2 Setting correlationFilterResult...........................................................................................................4
1.1.3 Setting working set filter................................................................................................................... 5
1.1.3.1 Example 1: nms_conf.xml file with working set filter when except-hierarchy is present...........7
1.1.3.2 Example 2: nms_conf.xml file with working set filter when except-hierarchy is not present ... 10
1.1.4 Setting event type filter...................................................................................................................11
1.1.5 Setting object instance filter........................................................................................................... 15
1.1.6 Setting severity filter....................................................................................................................... 17
1.1.7 Setting alarm number filter............................................................................................................. 22
1.2 Setting filters by sending a filter request from the higher level system.................................................. 25
1.2.1 Setting event type filter...................................................................................................................25
1.2.2 Setting object instance filter........................................................................................................... 30
1.2.3 Setting severity filter....................................................................................................................... 31
4 Configurable items........................................................................................................................................ 51
1 Setting filters
This section describes the ways to set filters for the notifications received by the higher level system.
To change filterId
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nbi-snmp.properties
3. Set com.nsn.oss.nbi.fm.filterId according to the following format:
com.nsn.oss.nbi.fm.filterId=<value>
Note:
For more information on filterId, see Creating a filtering rule in Rule Explorer Help.
To change correlationFilterResult
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nbi-snmp.properties
3. Set correlationFilterResult according to the following format:
com.nsn.oss.nbi.fm.correlationFilterResult=<value>
Note:
For more information, see About Alarm Correlation in Rule Explorer Help.
For more information on configuring working set, see Managing working sets in Working Set Manager
Help.
Note: One higher level system supports only one working set filter rule.
1. Log in as omc user to the NetAct virtual machine (VM) where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nms_conf.xml
3. In the nms_conf.xml file, configure the working set filter according to the definition described
in Table 1: Description of the elements in the nms_conf.xml file and Table 2: Description of the
attributes in the nms_conf.xml file.
Occur-
Element Attribute Description Example
rence
• matchMode="Pre
fix" is valid.
• matchMode="ful
l" is invalid.
Occur-
Element Attribute Description Example
rence
The following examples describe the nms_conf.xml file configured with working set filter:
• Example 1: nms_conf.xml file with working set filter when except-hierarchy is present
• Example 2: nms_conf.xml file with working set filter when except-hierarchy is not present
Note:
• When a working set filter is configured with the except-hierarchy value, the
alarm synchronization, the alarm summary, or the topology notifications received by
the higher level system might be affected.
• For deleting or adding working set in the nms_conf.xml file, the working set rule
takes effect automatically after several minutes.
• When the NMS is configured with the working set filter, the number of current alarms
in alarmSummaryNotification might be affected.
• For modifying the working set in Working Set Manager or after new network
elements are integrated, the change of working set rule takes effect after 24 hours at
most.
The alarm or topology notifications received by the higher level system might not be
consistent with the new working set rule. To resolve this problem, see Internal work-
ing set cache is out of date in Troubleshooting Fault Management.
Expected outcome
The working set filter is configured in the SNMP NBI configuration file.
1.1.3.1 Example 1: nms_conf.xml file with working set filter when except-hierarchy is present
The following is a sample of the nms_conf.xml file in which one higher level system nms1 is
configured with working set ws1 and another higher level system nms2 is configured with working set
ws2:
</workingSet>
<NMS name="nms2" ip="192.168.1.11" port="163">
<workingSet name="ws2" filterMode="include" matchMode="prefix">
<except-hierarchy value="PLMN/MRBTS/LNBTS/LNCEL"/>
</workingSet>
</NMSConfig>
The working set ws1 is configured with the following distinguished names (DNs):
• PLMN-1/MRBTS-1
• PLMN-1/MRBTS-1/LNBTS-1/LNCEL-1
The working set ws2 is configured with the following distinguished names (DNs):
• PLMN-1/MRBTS-1
• PLMN-1/MRBTS-1/LNBTS-1/LNCEL-2
Based on the above nms_conf.xml file configuration with working set filter, Table 3: Example use
cases during which the distinguished name (DN) of the notification is sent to the higher level system
describes how the SNMP NBI uses the except-hierarchy value to send the incoming notification
DNs to the higher level systems.
Table 3: Example use cases during which the distinguished name (DN) of the notification is sent to the
higher level system
1.1.3.2 Example 2: nms_conf.xml file with working set filter when except-hierarchy is not present
The following is a sample of the nms_conf.xml file with working set filter when except-hierarchy
is not present:
<?xml version="1.0" encoding="UTF-8"?>
<NMSConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="nms_conf.xsd">
<NMS name="nms1" ip="192.168.1.10" port="162">
<workingSet name="workingset1" filterMode="include"
matchMode="full"/>
</NMS>
<NMS name="nms2" ip="192.168.1.11" port="162">
<workingSet name="workingset2" filterMode="exclude"
matchMode="prefix"/>
</NMS>
<NMS name="nms3" ip="192.168.1.11" port="162">
<workingSet name="workingset2" filterMode="exclude"
matchMode="full"/>
</NMS>
</NMSConfig>
• The distinguished name of the notification or its ancestors in workingset2 are not sent to nms2.
• The distinguished name of the notification in workingset2 is not sent to nms3.
Note: One higher level system supports only one event type filter rule.
1. Log in as omc user to the NetAct virtual machine (VM) where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nms_conf.xml
3. In the nms_conf.xml file, configure the event type filter according to the definition described
in Table 4: Description of the element in the nms_conf.xml file and Table 5: Description of the
attributes in the nms_conf.xml file.
• filterAll
• noEventTypeFilter
• communicationsAlarm
• qualityOfServiceAlarm
• processingErrorAlarm
• equipmentAlarm
• environmentalAlarm
• integrityViolationAlarm
• operationalViolation
Alarm
• physicalViolationAlarm
• securityServiceOrMechan
ismViolationAlarm
• timeDomainViolation
Alarm
• createNotification
• deleteNotification
• AVCNotification
• stateChangeNotification
• alarmSyncNotification
• syncEMSDataNotification
• syncNEDataNotification
• alarmSummaryNotifica
tion
• heartbeatNotification
• endOfSequenceNotifica
tion
• changedPeriodNotifica
tion
• startUpNotification
• shutDownNotification
• alarmNewNotification
• alarmAckChangedNotifica
tion
• alarmChangedNotification
• alarmCommentNotification
• alarmClearedNotification
Note:
Note:
The following is an example of the nms_conf.xml file configured with the event type filter:
</NMS>
<NMS name="nms3" ip="192.168.1.12" port="162">
<filters>
<eventType value="filterAll”/>
<objectInstance value=""/>
<severityType value="noSeverityFilter"/>
<alarmNumber value=""/>
</filters>
</NMS>
<NMS name="nms4" ip="192.168.1.13" port="162">
<filters>
<eventType value="noEventTypeFilter”/>
<objectInstance value=""/>
<severityType value="noSeverityFilter"/>
<alarmNumber value=""/>
</filters>
</NMS>
</NMSConfig>
In this example:
Expected outcome
The event type filter is configured in the SNMP NBI configuration file.
Note: One higher level system supports only one object instance filter rule.
1. Log in as omc user to the NetAct virtual machine (VM) where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nms_conf.xml
3. In the nms_conf.xml file, configure the object instance filter according to the definition described
in Table 6: Description of the element in the nms_conf.xml file and Table 7: Description of the
attributes in the nms_conf.xml file.
At-
Element Description Occurrence Example
tribute
The following is an example of the nms_conf.xml file configured with the object instance filter:
In this example:
Expected outcome
The object instance filter is configured in the SNMP NBI configuration file.
Note:
• One higher level system supports only one severity filter rule.
• When you filter alarms using the severity filter, the alarm severity displayed corresponds
to the Perceived Severity of the alarm.
1. Log in as omc user to the NetAct virtual machine (VM) where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nms_conf.xml
3. In the nms_conf.xml file, configure the severity filter according to the definition described
in Table 8: Description of the element in the nms_conf.xml file and Table 9: Description of the
attributes in the nms_conf.xml file.
• indeterminate
• cleared
• warnings
• minor
• major
• critical
• noSeverityFilter
• filterAll
Note:
filter_code.
To find the cor-
rect decimal filter
code, see Set-
ting severity fil-
ter. If you config-
ure the sever-
ityType val-
ue with a deci-
mal filter code,
then the deci-
mal filter code is
changed to the
corresponding
severityType
string value after
the nms_conf.
xml file is suc-
cessfully loaded.
• The severity-
Type element
must not contain
a combination of
string and dec-
imal filter code
value. For ex-
ample, <sever-
ityType
value="criti
cal,2"/> is in-
valid.
• If the severi-
tyType element
is configured
with duplicate
values, for ex-
ample, <sever-
ityType
value="criti
cal,critical"/
>, then the nms_
conf.xml file
configuration is
invalid.
Note:
The following is an example of the nms_conf.xml file configured with the severity type filter:
In this example:
Expected outcome
Note: One higher level system supports only one alarm number filter rule.
1. Log in as omc user to the NetAct virtual machine (VM) where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/nms_conf.xml
3. In the nms_conf.xml file, configure the alarm number filter according to the definition described
in Table 10: Description of the element in the nms_conf.xml file and Table 11: Description of the
attributes in the nms_conf.xml file.
• If you are
configuring
more than
one alarm
number in-
stance, then
each instance
must be sep-
arated by a
comma ( ,).
• If the alarm-
Number ele-
ment is con-
figured with
duplicate
values, for
example,
<alarmNum
ber val-
ue="999,
100,999"/
>, then the
nms_conf.
xml file con-
figuration is
invalid.
configured and
alarmNumber
value attribute is
configured, then
the default mode
value is added as
exclude after
the nms_conf.
xml file is suc-
cessfully loaded.
The following is an example of the nms_conf.xml file configured with the alarm number filter:
In this example:
• All the notifications of alarms with alarm number 999 and alarms with alarm numbers in the
range 100 to 200 are not sent to nms1.
• All the notifications of alarms with alarm number 999 are sent to nms2.
• All the notifications of alarms irrespective of alarm numbers are sent to nms3.
Expected outcome
The alarm number filter is configured in the SNMP NBI configuration file.
1.2 Setting filters by sending a filter request from the higher level
system
This section explains how to set the following filters:
• severity filter
• event type filter
• object instance filter
The above filters are independent of each other and take effect separately.
To set a filter, you need to send an SNMP SET request from the higher level system. NetAct provides a
tool to simulate the scenario of sending an SNMP SET request from the higher level system. For more
information on how to simulate this scenario, see step 5 in Integrating an external NMS by sending a
register request in Integrating NetAct to an External NMS Using SNMP Northbound Interface.
The following sections explains the required content, including OID and value, of the SNMP SET
request for setting each filter.
<NBISNMP_VM_FQDN>:16604
1.3.6.1.4.1.28458.1.26.2.1.1.1.1.5.<ascii_nms_name> s
<decimal_filter_code>
• <ascii_nms_name> is the name of higher level system in ASCII format. For example, the
ascii_nms_name of nms21 is 110.109.115.50.49 according to the following character and
ASCII mapping. <ascii_nms_name> must be no more than 100 ASCII characters.
Character ASCII
n 110
Character ASCII
m 109
s 115
2 50
1 49
Filter code is a thirty-digit binary number, and each digit represents the filter choice of one event type.
If the corresponding digit is 0, notifications of this event type are not filtered; if the corresponding digit
is 1, notifications of this event type are filtered.
The thirty event types are listed in order as follows, which are mapped to thirty-digit binary number
form high digit to low digit according to the filtering choice.
1 filterAll
2 noEventTypeFilter
3 filterCommunicationsAlarm
4 filterQualityOfServiceAlarm
5 filterProcessingErrorAlarm
6 filterEquipmentAlarm
7 filterEnvironmentalAlarm
8 filterIntegrityViolationAlarm
9 filterOperationalViolationAlarm
10 filterPhysicalViolationAlarm
11 filterSecurityServiceOrMechanismViolationAlarm
12 filterTimeDomainViolationAlarm
13 filterCreateNotification
14 filterDeleteNotification
15 filterAVCNotification
16 filterStateChangeNotification
17 filterAlarmSyncNotification
18 filterSyncEMSDataNotification
19 filterSyncNEDataNotification
20 filterAlarmSummaryNotification
21 filterHeartbeatNotification
22 filterEndOfSequenceNotification
23 filterChangedPeriodNotification
24 filterStartUpNotification
25 filterShutDownNotification
26 filterAlarmNewNotification
27 filterAlarmAckChangedNotification
28 filterAlarmChangedNotification
29 filterAlarmCommentNotification
30 filterAlarmClearedNotification
Example 1:
The following setting means no event type filter is applied, and the filter code is
010000000000000000000000000000. The decimal_filter_code is 268435456.
1 filterAll 0
2 noEventTypeFilter 1
3 filterCommunicationsAlarm 0
4 filterQualityOfServiceAlarm 0
5 filterProcessingErrorAlarm 0
6 filterEquipmentAlarm 0
7 filterEnvironmentalAlarm 0
8 filterIntegrityViolationAlarm 0
9 filterOperationalViolationAlarm 0
10 filterPhysicalViolationAlarm 0
11 filterSecurityServiceOrMechanismViolationAlarm 0
12 filterTimeDomainViolationAlarm 0
13 filterCreateNotification 0
14 filterDeleteNotification 0
15 filterAVCNotification 0
16 filterStateChangeNotification 0
17 filterAlarmSyncNotification 0
18 filterSyncEMSDataNotification 0
19 filterSyncNEDataNotification 0
20 filterAlarmSummaryNotification 0
21 filterHeartbeatNotification 0
22 filterEndOfSequenceNotification 0
23 filterChangedPeriodNotification 0
24 filterStartUpNotification 0
25 filterShutDownNotification 0
26 filterAlarmNewNotification 0
27 filterAlarmAckChangedNotification 0
28 filterAlarmChangedNotification 0
29 filterAlarmCommentNotification 0
30 filterAlarmClearedNotification 0
Example 2:
The following setting means only AlarmCommentNotification is filtered, and the filter code is
000000000000000000000000000010. The decimal_filter_code is 2.
1 filterAll 0
2 noEventTypeFilter 0
3 filterCommunicationsAlarm 0
4 filterQualityOfServiceAlarm 0
5 filterProcessingErrorAlarm 0
6 filterEquipmentAlarm 0
7 filterEnvironmentalAlarm 0
8 filterIntegrityViolationAlarm 0
9 filterOperationalViolationAlarm 0
10 filterPhysicalViolationAlarm 0
11 filterSecurityServiceOrMechanismViolationAlarm 0
12 filterTimeDomainViolationAlarm 0
13 filterCreateNotification 0
14 filterDeleteNotification 0
15 filterAVCNotification 0
16 filterStateChangeNotification 0
17 filterAlarmSyncNotification 0
18 filterSyncEMSDataNotification 0
19 filterSyncNEDataNotification 0
20 filterAlarmSummaryNotification 0
21 filterHeartbeatNotification 0
22 filterEndOfSequenceNotification 0
23 filterChangedPeriodNotification 0
24 filterStartUpNotification 0
25 filterShutDownNotification 0
26 filterAlarmNewNotification 0
27 filterAlarmAckChangedNotification 0
28 filterAlarmChangedNotification 0
29 filterAlarmCommentNotification 1
30 filterAlarmClearedNotification 0
Note: The filterAll and noEventTypeFilter impact the settings of other event types.
If the value of filterAll is 1, the values of all other event types must be set as 0. If the
values of noEventTypeFilter is 1, the values of all other event types must be set as 0.
For example, if the filter code is 110000000000000000000000000000 with decimal-
filter_code 805306368, the following error message shows:
Error in packet.
Reason: (badValue) The value given has the wrong type or length.
Failed object: SNMPv2-SMI::enterprises.28458.1.26.2.1.1.1.1.5.110.
109.115.49
• filterAVCNotification
• filterStateChangeNotification
• filterSyncEMSDataNotification
• filterSyncNEDataNotification
• filterAlarmCommentNotification
<NBISNMP_VM_FQDN>:16604
1.3.6.1.4.1.28458.1.26.2.1.1.1.1.6.<ascii_nms_name> s <DN>
• <ascii_nms_name> is the name of higher level system in ASCII format. For example, the
ascii_nms_name of nms21 is 110.109.115.50.49 according to the following character and
ASCII mapping. <ascii_nms_name> must be no more than 100 ASCII characters.
Character ASCII
n 110
m 109
s 115
2 50
1 49
<DN> is the distinguished name of the object whose notifications are filtered, and the notifications with
systemDN starting with <DN> are filtered.
For example:
Multiple object instances filters are supported, and the distinguished names of the objects are
separated by ,.
For example:
Besides filtering a specified object instance, the instance in the last object supports the wildcard
character *.
For example:
If <DN> is PLMN-1/MSC-*, all the notifications of MSC under PLMN-1 and its child objects are filtered.
Note:
In case of several filters, when one filter condition is satisfied, then the notification is filtered, for exam-
ple, if the event type filter indicates the filtering of only equipment notifications and environmental noti-
fications, but the object type filter indicates the filtering of some object instances, all notification types
generated by these object instances are filtered.
Note: When you filter alarms using the severity filter, the alarm severity displayed
corresponds to the Perceived Severity of the alarm.
<NBISNMP_VM_FQDN>:16604
1.3.6.1.4.1.28458.1.26.2.1.1.1.1.7.<ascii_nms_name> s
<decimal_filter_code>
• <ascii_nms_name> is the name of higher level system in ASCII format. For example, the
ascii_nms_name of nms21 is 110.109.115.50.49 according to the following character and
ASCII mapping. <ascii_nms_name> must be no more than 100 ASCII characters.
Character ASCII
n 110
m 109
s 115
2 50
Character ASCII
1 49
Filter code is an eight-digit binary number, and each digit represents the filter choice of one alarm
severity type. If the corresponding digit is 0, alarms of this severity type are not filtered; if the
corresponding digit is 1, alarms of this severity type are filtered.
These eight alarm severity types are listed in order as follows, and they are mapped to eight-digit bina-
ry number from high digit to low digit according to the filtering choice.
1 IndeterminateAlarms
2 ClearedAlarms
3 Warnings
4 MinorAlarms
5 MajorAlarms
6 CriticalAlarms
7 noSeverityFilter
8 filterAllAlarms
Example 2:
The following setting means no severity filter is applied. The filter code is 00000010, and the
decimal_filter_code is 2.
1 IndeterminateAlarms 0
2 ClearedAlarms 0
3 Warnings 0
4 MinorAlarms 0
5 MajorAlarms 0
6 CriticalAlarms 0
7 noSeverityFilter 1
8 filterAllAlarms 0
Note:
SNMP NBI supports two versions: v2c and v3. The default version is v3. For more informa-
tion, see Configurable items.
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running, and then switch to
the root user.
Note: To locate the right VM, see Locating the right virtual machine for a service in Ad-
ministering NetAct Virtual Infrastructure.
Expected Output:
Example output:
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running, and then switch to
the root user.
Note: To locate the right VM, see Locating the right virtual machine for a service in Ad-
ministering NetAct Virtual Infrastructure.
Expected Output:
Note:
Besides setting USM credential, you can also get USM credential, change security level
and change USM username with USM management tool.
Before changing the security level, make sure you have set the authentication and priva-
cy protocol, as well as their passphrases.
Expected output:
Note:
If the current version of SNMP NBI is v2c, the expected output is as below.
Note:
Two authentication protocols, MD5 and SHA, are supported. The default protocol is SHA.
You can choose the default protocol by pressing Enter directly. If you choose either MD5
or SHA, you need to set a passphrase.
Expected output:
Note: The password accepts alphanumeric characters and special characters including
~`!@#$%^&*()-_+=|:;,.<>?/.
Expected output:
Note:
Five privacy protocols are supported. The default protocol is AES128. You can choose
the default protocol by pressing Enter directly. You need to set a passphrase after choos-
ing any of the five protocols.
Expected output:
Note: The password accepts alphanumeric characters and special characters including
~`!@#$%^&*()-_+=|:;,.<>?/.
Expected output:
1. noAuthNoPriv
2. authNoPriv
3. authPriv
Enter the choice [3]:
Note:
If you chose MD5 or SHA in step 3, you can choose noAuthNoPriv or authNoPriv.
If you chose MD5 or SHA in step 3, and any of the five privacy protocols (DES, DESEDE,
AES128, AES192 and AES256) in step 5, you can choose any of the three security lev-
els.
Expected output:
Note:
Note: By default, notification enrichment function is disabled. Enabling this function may re-
duce the SNMP NBI notification forwarding throughput. When the notification forwarding
speed is 1000 events per second, the forwarding speed will be reduced if the SNMP notifi-
cation enrichment function is enabled. However, when the notification forwarding speed is
lower than 600 events per second, enabling this function has no impact on the forwarding
speed.
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running.
Note: To locate the right VM, see Locating the right virtual machine for a service in Ad-
ministering NetAct Virtual Infrastructure.
[omc]$ cd /etc/opt/oss/global/nbisnmp/conf/mf-conf/
[omc]$ vi snmp_notification_enrichment.xml
3. In the snmp_notification_enrichment.xml file, change the value of support to true for
the notifications which you want to enable the enrichment function.
Note: When the value of support is changed to true, a key-value pair is added as the
value for the nbiOptionalInformation field in the related notification. For exam-
ple, nbiOptionalInformation="NEName=my name is WBTS|originalAlar-
mId=12345678".
siteObjDN Distinguished name of the site ob- For a notification from PLMN-
ject, which the alarming object be- PLMN/RNC-1/WBTS-1, if
longs to, in the NetAct format. the site for WBTS is set to
SITEC-1/SITE-1, the siteObjDN
If the distinguished name of the
is SITEC-1/SITE-1.
site object does not exist, the value
of default attribute of siteObjDN
set in snmp_notification_
enrichment.xml is used.
controlObjSiteAddress The site address of the controlling For a notification from PLMN-
object instance. Controlling object PLMN/RNC-1/WBTS-1, if the
means the object plays an agent controlling object for WBTS is
role from NetAct point of view. It for- set to the parent RNC, and the
wards the notification information site of PLMN-PLMN/RNC-1 is
controlObjName The name of the controlling object For a notification from PLMN-
instance. PLMN/RNC-1/WBTS-1, if the
controlling object for WBTS is
If the name of the controlling
set to the parent RNC, the con-
object instance does not exist,
trolObjName is the name of
the value of default attribute of
PLMN-PLMN/RNC-1.
controlObjName set in snmp_
notification_enrichment.
xml is used.
• The per-
ceivedSever
ity of an alarm is
the current sever-
ity.
• The origi-
nalSeverity
of an alarm is
the severity with
which the alarm
was raised initial-
ly.
• When an alarm
is acknowl-
edged, there is
no change in the
severity of the
alarm.
• When an alarm
is cleared, the
perceivedSev-
erity of the
alarm changes to
clear.
• When an alarm is
raised with Major
severity, the fol-
lowing applies:
– The per-
ceivedSe
verity is
Major and
the origi-
nalSeveri-
ty is Inde-
terminate.
– When the
severity of
the alarm is
changed to
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running.
Note:
To locate the right VM, see Locating the right virtual machine for a service in Administer-
ing NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/
enrichment_tag_mapping.xml
Occur-
Element Attribute Description Example
rence
Occur-
Element Attribute Description Example
rence
In the example 1, the tag LTE and VNF are configured. If the DN of the notification matches the
rule of working set WORKINGSET_NAME_LTE in the prefix mode, the notification sent to higher
level system contains the enrichment tag LTE in the element nbiOptionalInformation as
follows:
nbiOptionalInformation="enrichmentTag=LTE"
nbiOptionalInformation="enrichmentTag=VNF"
In the example 2, the tag LTE is configured. If the DN matches the rule of working set
WORKINGSET_NAME1_LTE or WORKINGSET_NAME2_LTE in the prefix mode, the
notification sent to higher level system contains the enrichment tag LTE in the element
nbiOptionalInformation as follows:
nbiOptionalInformation="enrichmentTag=LTE"
Note:
• The configuration changes take effect automatically after one minute without
restarting the nbisnmp service.
• For modifying working set in Working Set Manager, or after new network elements
are integrated, the changes of working set rule take effect after 24 hours at most. To
make the changes take effect immediately, do the following:
1. Log in as the omc user to the NetAct VM where the nbicom service is running.
2. Refresh the cache manually by entering:
[omc]$ /opt/oss/Nokia-nbicom/bin/
nbicom_cache_refresh_tool.sh -r
An example output:
Status: ACCEPTED
Description: refresh is started
An example output:
Status: SUCCESS
Description: refresh is successful
Begin time: 2019-07-19T04:22:49+0300
End time: 2019-07-19T04:22:49+0300
1. Log in as the omc user to the NetAct VM where the nbisnmp service is running.
Note:
To locate the right VM, see Locating the right virtual machine for a service in Administer-
ing NetAct Virtual Infrastructure.
[omc]$ vi /etc/opt/oss/global/nbisnmp/conf/mf-conf/
enrichment_hierarchy.cf
Example 1:
PLMN/MRBTS
Example 2:
PLMN/MRBTS
PLMN/MRBTS/LNBTS
4 Configurable items
Table 15: Configurable items shows all the configurable items in /etc/opt/oss/global/nbisnmp/
conf/mf-conf/nbi-snmp.properties, and the file is located in NetAct VM where the nbisnmp
service is running. To locate the right VM, see Locating the right virtual machine for a service in
Administering NetAct Virtual Infrastructure.
Note:
You can edit the property file with omc permission. However, you need to restart SNMP NBI
service for some items before the changes can take effect. To restart SNMP NBI service,
first stop nbisnmp service, and then start nbisnmp service. For detailed instruction, see
Stopping SNMP NBI in Administering SNMP Northbound Interface and Starting SNMP NBI in
Administering SNMP Northbound Interface.
Restart SNMP NBI service for the following items before the changes can take effect.
Note: This
buffer is
memory-con-
suming, so it
should be set
to a reason-
able value.
For exam-
ple, for a 1G
JVM memory,
the maximum
size is 2000.
The following items will take effect automatically after the changing without restarting service.
Timestamp;AlarmNotificati
onType;DN;AlarmId;Specifi
cProblem;EventTime;
PerceivedSeverity;Probabl
eCauseCode
2021-12-03 10:59:20.
522;ALARM_NEW;PLMN-
1/BSC-1/BCF-1;
321;7555;2021-12-
03T10:59:17+02:00;minor;
123;
Timestamp;AlarmNo
tificationType;DN;
AlarmId;SpecificP
roblem;EventTime;
PerceivedSeverity;
ProbableCauseCode
2021-12-06
08:39:59.
068;ALARM_
LIST_REBUILT;
[Attribute
Not Supported];
[Attribute Not
Supported];0;2021
-12-
06T08:39:58+02:00
;critical;0;
time_stamp;event_
type;nbiObjectInstance;
nbiSpecificProblem;
nbiAlarmId;
2021-12-03 12:52:27.591;
nbiAlarmNewNotification;
PLMN-1/BSC-1/BCF-1;7560|
Alarm text;326
Note:
If the com.nokia.
oss.nbi.nbisnmp.
The com.nokia.oss.nbi.
nbisnmp.fm.eventlogging.
attributes property also
supports logging and displaying the
following additional attributes in the
event logging output:
• nbiEventTime
• nbiPerceivedSeverity
• nbiProbableCause
• nbiAlarmType
• nbiSequenceId
• nms
time_stamp;event_
type;nbiObjectInstance;
nbiEventTime;
nbiSpecificProblem;
nbiAlarmId;
nbiPerceivedSeverity;
nbiProbableCause;
nbiAlarmType;
nbiSequenceId;nms;
2021-12-03 12:52:27.
591;nbiAlarmNewNotificati
on;PLMN-1/BSC-1/BCF-
1;2021-12-3,12:52:27.
4,+2:0;7560|Alarm
Text;326;2;123;3;402;nms1
• time_stamp
• event_type
• nbiObjectIn-
stance
• nbiEventTime
• nbiSpecificProb
lem
• nbiAlarmId
• nbiPer-
ceivedSeverity
• nbiProbable-
Cause
• nbiAlarmType
• nbiSequenceId
• nms
Note:
com.nokia.oss.
nbi.nbisnmp.fm.
eventlogging.
attributes
= time_
stamp;event_
type;nbiObject
Instance;
nbiEventTime;
nbiSpecific
Problem;
nbiAlarmId;
nbiPerceived