No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

eSight V300R010C00SPC200, 300, and 500 Self-Service Integration Guide 11

Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Configuring Local eSight Information

Configuring Local eSight Information

Configure the SNMP NBI parameters for interconnection with the third-party system.

Some SNMP object information is configured on the web page and in the configuration file, as listed in Table 1. The configuration using the configuration file takes effect after the eSight is restarted. The configuration on the web page is recommended.

Table 4-6 Configuration entry

Task

Web Page

Configuration File

Configuring the Third-Party System Information

  1. Choose System > System Settings > Northbound Integration from the main menu.
  2. Choose Third-party System Settings from the navigation tree and configure the NBI parameters.
  3. Choose Alarm Filter Settings from the navigation tree and set the filter criteria for the alarms reported over SNMP.

The SNMP NBI configuration file snmpagent.xml is saved in eSight installation directory/AppBase/etc/nbi/snmp.

For the configuration method, see the related details in section 3.2.

Configuring SNMP Agent Information

  1. Choose System > System Settings > Northbound Integration from the main menu.
  2. Choose Local System Settings from the navigation tree and configure the SNMP agent parameters.

Configuring SNMPv3 Information

  1. Choose System > System Settings > Northbound Integration from the main menu.
  2. Choose Third-party System Settings from the navigation tree and click SNMP Global Parameter Settings.

Configuring the Heartbeat Period

Not supported

Configuring the SNMP inform Mode

  1. Choose System > System Settings > Northbound Integration from the main menu.
  2. Choose Third-party System Settings from the navigation tree and click SNMP Global Parameter Settings.

Configuring SNMP Agent Information

The SNMP agent runs on the eSight. It performs operations on the eSight based on requests from the third-party system and reports real-time alarm traps to the third-party system. SNMP agent parameters include the IP address and port used to receive requests from the third-party system, IP address and port used to send traps, and common configurations.

Configuration Item

<common name="common">
<param name="Agent_IP">127.0.0.1</param>
<param name="Agent_Port">4700</param>
<param name="TrapSendIP">127.0.0.1</param>
<param name="TrapSendPort">31920</param>
<param name="SupportedMIB">MIB2</param>
<param name="TrapSendInterval">0</param>
<param name="TimeType">0</param>
<param name="TimeFormat">3</param>
<param name="StringSize">4096</param>
<param name="ActiveAlarm">1</param>
<param name="TrapCoding">UTF-8</param>
<param name="PDUTrace">0</param>
<param name="SupportRootAlarm">0</param>
</common>

Parameter

Parameter

Configuration Item Path

Description

Default Value

Agent_IP

snmpagent/common/Agent_IP

Indicates the IP address that runs SNMP services.

  • If there is only one IP address on the operating system, the default value 127.0.0.1 is used. That is, the IP address that runs SNMP services is the IP address of the operating system.
  • If an OS has multiple IP addresses, set this parameter to the IP address that can be used to communicate with the third-party system.

127.0.0.1

Agent_Port

snmpagent/common/Agent_ Port

Indicates the port that runs SNMP services. This parameter does not need to be changed.

4700

TrapSendIP

snmpagent/common/TrapSendIP

Indicates the source IP address used to send traps and informs.

If an OS has multiple IP addresses, set this parameter to the IP address that can be used to communicate with the third-party system.

127.0.0.1

TrapSendPort

snmpagent/common/TrapSendPort

Indicates the source port used to send traps and informs. If the value is invalid, a random port will be used.

31920

TrapSendInterval

snmpagent/common/TrapSendInterval

Indicates the interval at which traps are sent to the third-party system. The value ranges from 0 to 1000 ms.

This parameter is invalid for informs.

0

TimeFormat

snmpagent/common/TimeFormat

Indicates the format of the alarm time VB field. The options are as follows:

  • 0: UTC time in the format of %Y/%m/%d - %H:%M:%SZ
  • 1: local time without the time zone in the format of %Y/%m/%d - %H:%M:%S
  • 2: local time with the time zone in the format of %Y/%m/%d - %H:%M:%S,%TZ[DST]
  • 3: UTC time in the format of %Y-%m-%d %H:%M:%S
  • 4: local time in the format of %Y-%m-%d %H:%M:%S %TZ TZ %DST DST

3

TimeType

snmpagent/common/TimeType

Indicates the type of the time at which alarms are reported. The options are as follows:

  • 0: UTC time
  • 1: eSight server time

0

StringSize

snmpagent/common/StringSize

Indicates the maximum characters that can be fixed in a VB field.

4096

ActiveAlarm

snmpagent/common/ActiveAlarm

Specifies whether current alarms or active alarms are queried.

  • 0: Current alarms (alarms that have not cleared and alarms that have cleared but not acknowledged) are queried.
  • 1: Active alarms (alarms that have not cleared) are queried.

1

TrapCoding

snmpagent/common/TrapCoding

Indicates the coding format of traps to be reported. The options are UTF-8, GBK, and ISO-8859-1.

UTF-8

SupportRootAlarm

snmpagent/common/SupportRootAlarm

Specifies whether root alarms are supported.

  • 0: Root alarms are not supported. All alarms will be reported or queried.
  • 1: Root alarms are supported. Only root alarms will be reported or queried.

Currently only 0 is available. That is, all alarms will be reported or queried.

0

NEFDNDelimiter

snmpagent/common/ NEFDNDelimiter

Indicates the separator for the NE FDNs. This configuration item is used together with the NEFDNFilter field for identifying multiple NE FDNs in the NEFDNFilter field. By default, this configuration item is not displayed in the configuration file. When an NMS user sets SNMP information on the SNMP NBI configuration page on a client, the SMP process adds the configuration item to the snmpagent.xml configuration file and issues a value as the separator of the NEFDNFilter field.

NA

PDUTrace

snmpagent/common/TrapCoding/PDUTrace

Specifies whether data sent to the third-party system is recorded.

  • 0: Data sent to the third-party system is not recorded.
  • 1: Data sent to the third-party system is recorded.

0

As the ports less than 1024 are restricted on Linux, the parameters Agent_Port and TrapSendPort can not be configured the value less then 1024, otherwise the function will be abnormal. The default values of the two ports are suggested to use.

Configuring SNMPv3 Information

If SNMPv3 is configured in configuring Third-Party system information, you must configure the security level, authentication protocol, and encryption protocol.

Configuration Item

<v3trap name="v3trap">
<param name="Level">3</param>
<param name="AuthProtocol">2</param>
<param name="PrivProtocol">2</param>
<param name="EngineID"></param>
<param name="EngineIDMatchRFC">1</param>
</v3trap>

Parameter

Parameter

Configuration Item Path

Description

Default Value

Level

snmpagent/v3trap/Level

Indicates the available security levels. The options are:

  • 1: NoAuth and NoPriv
  • 2: Auth and NoPriv
  • 3: Auth and Priv

3

AuthProtocol

snmpagent/v3trap/AuthProtocol

Indicates the authentication protocol configured for SNMPv3. The options are as follows:

  • 1: MD5
  • 2: SHA
NOTE:

The MD5 encryption algorithm is insecure. SHA is recommended because it is secure.

2

PrivProtocol

snmpagent/v3trap/PrivProtocol

Indicates the encryption protocol configured for SNMPv3. The options are as follows:

  • 1: DES
  • 2: AES
NOTE:

Using AES is recommended because of its higher security than DES.

2

EngineID

snmpagent/v3trap/EngineID

Indicates the EngineID value configured for SNMPv3. It can be set to an IPv4 address or a character string.

NOTE:
  • If EngineID is specified, its length must be from 5 to 27 characters. Otherwise, its value is empty by default.
  • For an HA system, you are advised to set EngineID to a valid character string to ensure that the EngineIDvalue does not change after switchover.

no default value

EngineIDMatchRFC

snmpagent/v3trap/EngineIDMatchRFC

Indicates the report mode of EngineID. The options are as follows:
  • 0: indicates that the configured EngineID value is reported as the actual EngineID value.
  • 1: indicates that the configured EngineID value will be reported after being converted into a value that complies with the RFC specifications.

1

Configuring the Heartbeat Period

The SNMP NBI periodically sends heartbeat traps to the third-party system so that the third-party system can determine whether the communication with the SNMP NBI is normal.

Configuration Item

<heartbeat name="heartbeat">
<param name="Enable">1</param>
<param name="Interval">60</param>
<param name="Lable">SNMP Agent</param>
</heartbeat>

Parameter

Parameter

Configuration Item Path

Description

Default Value

Enable

/snmpagent/heartbeat/Enable

Specifies whether heartbeat traps are sent.

  • 0: heartbeat traps are not sent.
  • others: heartbeat traps are sent.

1

Interval

/snmpagent/heartbeat/Interval

Indicates the interval at which heartbeat traps are sent. The value ranges from 3 to 3600 seconds. If the value is incorrect or is 0, the default value 60 is used.

60

Lable

/snmpagent/heartbeat/Lable

Indicates the identifier of a heartbeat trap.

SNMP Agent

Configuring the SNMP inform Mode

Notifications are reported in trap or inform mode. In trap mode, alarms are reported immediately after they are received, regardless of whether the third-party system responds to previous alarms. In inform mode, alarms are reported only after the third-party system responds to previous alarms. If the inform mode is used and parameters on the third-party system are incorrect, multiple connections will be attempted, which consumes a large number of resources and reduces the efficiency of the SNMP agent.

Configuration Item

<inform name="inform">
<param name="Enable">0</param>
<param name="Timeout">5</param>
<param name="Retries">3</param>
<param name="CacheSize">10000</param>
</inform>

Parameter

Parameter

Configuration Item Path

Description

Default Value

Enable

snmpagent/inform/Enable

Specifies whether alarms are reported in inform mode.

  • 0: Alarms are reported in trap mode.
  • 1: Alarms are reported in inform mode.

0

Timeout

snmpagent/inform/Timeout

Indicates the timeout period for reporting informs. The default value is 5, and the minimum value is 1. The unit is second.

5

Retries

snmpagent/inform/Retries

Indicates the maximum times for retransmitting an inform. The minimum value is 0.

3

CacheSize

snmpagent/inform/CacheSize

Indicates the cache size for real-time alarms. The value ranges from 10000 to 50000.

10000

  • Actually,Northbound SNMP Interface will continue to resend the informs until sending successfully.

Configuring Alarm Trap Attributes

eSight can report alarms to the upper-layer NMS in real time. This requires the configuration of the alarm fields.

Configuration Item

<MIB2 name="MIB2">
<param name="CsnType">0</param>
<param name="isInternational">0</param>
</MIB2>

Parameter Description

Parameter

Configuration Item Path

Description

Default Value

CsnType

snmpagent/MIB2/CsnType

Indicates the type of the reported alarm sequence number. The options are as follows:

  • 1: Integer
  • Other values: String

0

isInternational

snmpagent/MIB2/isInternational

Indicates the severity standards to which the reported alarm conforms. The options are as follows:

  • 0: Huawei standards

    The following alarm severities are specified:

    (1) Critical

    (2) Major

    (3) Minor

    (4) Warning

    (5) Indeterminate

    (6) Clear

  • 1: International standards

    The following alarm severities are specified:

    (0) Indeterminate

    (1) Critical

    (2) Major

    (3) Minor

    (4) Warning

    (5) Clear

0

omsCompatibility

snmpagent/MIB2/omsCompatibility

Indicates the compatible specifications. It has impact only on AlarmType and AlarmClearCategory.

If this configuration item is not set, the eSight specifications are used.

  • 0: The eSight specifications are used.
  • 1: The OMS specifications are used.

If the configuration item is set to other values, the value 0 is used. After modifying the value, you need to restart eSight.

0

Trap function customization

SupportCDNStandard

snmpagent/MIB2/SupportCDNStandard

Indicates whether the content delivery network (CDN) management standards of China Telecom are supported.

By default, this parameter is not set in the configuration file.

  • 0: Not supported
  • 1: Supported

-

  • The preceding fields are valid only when MIB2 is configured to be loaded in Configuring Local eSight Information.
  • By default, the parameter of the customized alarm function is not provided in the configuration file. You need to add the configuration item, for example, <param name="SupportCDNStandard">1</param>, to the configuration file to enable the customization function.

SNMP Alarm Fields

eSight can report alarms to the upper-layer NMS in real time. This section describes the formats of alarm fields, which cannot be configured.

Configuration Item

<MIB2 name="MIB2">
<Mib name="Mib">
<param name="VB1">Csn</param>
<param name="VB2">Category</param>
<param name="VB3">OccurTime</param>
<param name="VB4">MOName</param>
<param name="VB5">ProductID</param>
<param name="VB6">NEType</param>
<param name="VB7">NEDevID</param>
<param name="VB8">DevCsn</param>
<param name="VB9">ID</param>
<param name="VB10">Type</param>
<param name="VB11">Level</param>
<param name="VB12">Restore</param>
<param name="VB13">Confirm</param>
<param name="VB14">AckTime</param>
<param name="VB15">RestoreTime</param>
<param name="VB16">Operator</param>
<param name="VB17">ExtendInfo</param>
<param name="VB18">Probablecause</param>
<param name="VB19">Proposedrepairactions</param>
<param name="VB20">SpecificProblems</param>
<param name="VB21">ClearOperator</param>
<param name="VB22">ObjectInstanceType</param>
<param name="VB23">ClearCategory</param>
<param name="VB24">ClearType</param>
<param name="VB25">ServiceAffectFlag</param>
<param name="VB26">AdditionalInfo</param>
<param name="VB27">GroupID</param>
</Mib>
</MIB2>

Parameter Description

Parameter

Configuration Item Path

OID

Description

Default Value

Alarm VB fields

VB1

/snmpagent/MIB2/Mib/VB1

x.1

Indicate the alarm sequence number.

Csn

VB2

/snmpagent/MIB2/Mib/VB2

x.2

Indicates the alarm category.

Category

VB3

/snmpagent/MIB2/Mib/VB3

x.3

Indicates the alarm occurring time.

OccurTime

VB4

/snmpagent/MIB2/Mib/VB4

x.4

Indicates the name of the device where the alarm occurs.

MOName

VB5

/snmpagent/MIB2/Mib/VB5

x.5

Indicates the product series of the device where the alarm occurs.

ProductID

VB6

/snmpagent/MIB2/Mib/VB6

x.6

Indicates the type of the device where the alarm occurs.

NEType

VB7

/snmpagent/MIB2/Mib/VB7

x.7

Indicates the device ID.

NEDevID

VB8

/snmpagent/MIB2/Mib/VB8

x.8

Indicates the sequence number of the faulty device.

DevCsn

VB9

/snmpagent/MIB2/Mib/VB9

x.9

Indicates the alarm type ID.

ID

VB10

/snmpagent/MIB2/Mib/VB10

x.10

Indicates the alarm type.

Type

VB11

/snmpagent/MIB2/Mib/VB11

x.11

Indicates the alarm severity.

Level

VB12

/snmpagent/MIB2/Mib/VB12

x.12

Indicates the alarm clearance ID.

Restore

VB13

/snmpagent/MIB2/Mib/VB13

x.13

Indicates the alarm acknowledging ID.

Confirm

VB14

/snmpagent/MIB2/Mib/VB14

x.14

Indicates the time when an alarm is acknowledged.

AckTime

VB15

/snmpagent/MIB2/Mib/VB15

x.15

Indicates the time when an alarm is cleared.

RestoreTime

VB16

/snmpagent/MIB2/Mib/VB16

x.16

Indicates the user who acknowledges the alarm.

Operator

VB17

/snmpagent/MIB2/Mib/VB17

x.27

Indicates the extended information that contains alarm location information.

ExtendInfo

VB18

/snmpagent/MIB2/Mib/VB18

x.28

Indicates the alarm cause.

Probablecause

VB19

/snmpagent/MIB2/Mib/VB19

x.29

Indicates the troubleshooting suggestions.

Proposedrepairactions

VB20

/snmpagent/MIB2/Mib/VB20

x.30

Indicates the detailed alarm cause.

Specificproblems

VB21

/snmpagent/MIB2/Mib/VB21

x.46

Indicates the user who clears the alarm.

ClearOperator

VB22

/snmpagent/MIB2/Mib/VB22

x.47

Indicates the instance type for the alarm object.

ObjectInstanceType

VB23

/snmpagent/MIB2/Mib/VB23

x.48

Indicates the alarm clearance category.

ClearCategory

VB24

/snmpagent/MIB2/Mib/VB24

x.49

Indicates the alarm clearance type.

ClearType

VB25

/snmpagent/MIB2/Mib/VB25

x.50

Indicates the operation impact flag of the alarm.

ServiceAffectFlag

VB26

/snmpagent/MIB2/Mib/VB26

x.51

Indicates the additional alarm information.

AdditionalInfo

VB27

/snmpagent/MIB2/Mib/VB27

x.17

Alarm Group ID.

IMAPNorthboundAlarmParas1

GroupID

Download
Updated: 2019-12-13

Document ID: EDOC1100044386

Views: 21414

Downloads: 93

Average rating:
This Document Applies to these Products

Related Version

Related Documents

Share
Previous Next