13 Managing and Configuring the SNMP Service

This chapter describes how to configure and manage the Simple Network Management Protocol (SNMP) service.

Introduction

The SNMP service is responsible for collecting alarms and distributing them as SNMP traps.

Figure 13-1 SNMP Overview

The SNMP service acts as an internal alarm listener and sends traps (or notifications) to any registered SNMP trap listener. There is a 1:1 relationship between alarms and SNMP traps. The Management Information Base (MIB) file defining the SNMP traps is based on the content of the alarm.xml file.

Each individual alarm ID is used to generate the object identifier for each SNMP trap.

The SNMP traps sent consist of:

IANA-registered private enterprise ID + BEA ID + Oracle Communications Services Gatekeeper ID + “0” + alarm identifier

• The IANA-registered enterprise ID is configurable using Attribute: EnterpriseObjectIdentifier.

• The BEA ID is static, and the value is 140.

• The Oracle Communications Services Gatekeeper ID is static, and the value is 627.

• The alarm identifier is defined in alarm.xml, in the attribute id of the alarm element.

The MIB file BEA-WLNG-MIB is located in the sub-directory snmp in the domain directory.

Configuration and management

The following section describes the SNMPService.

Configure SNMPService

Table 13-1 lists the attributes used to configure the SNMP Service.

Table 13-1 Task Overview

To define	Use
The SNMP Community string.	Attribute: Community
Enterprise Object Identifier. This attribute has a default value and should normally not be changed.	Attribute: EnterpriseObjectIdentifier
SNMP version to use.	Attribute: SNMPVersion
Which alarm severity levels that shall be distributed as SNMP traps.	Attribute: SeverityFilter

Define trap receivers using Operation: addTrapReceiver.

Trap Receivers

Table 13-2 lists the operations on trap receivers.

Table 13-2 Task overview

To	Use
Add a trap receiver	Operation: addTrapReceiver
List defined trap receivers	Operation: listTrapReceivers
Delete an existing trap receiver	Operation: listTrapReceivers to list registered trap receivers. Use the ID as an input parameter in Operation: deleteTrapReceiver.

Reference: Attributes and Operations for SNMPService

Managed object: Container Services−>SNMPService

MBean: com.bea.wlcp.wlng.snmp.SNMPServiceMBean

Following is a list of attributes and operations for configuration and maintenance:

• Attribute: Community

• Attribute: EnterpriseObjectIdentifier

• Attribute: RepeatedTraps

• Attribute: SNMPVersion

• Attribute: SeverityFilter

• Operation: addTrapReceiver

• Operation: deleteTrapReceiver

• Operation: listTrapReceivers

Attribute: Community

Scope: Server

Format: String

Units: Not applicable

Specifies the SNMP community address.

Default value is private.

Attribute: EnterpriseObjectIdentifier

Scope: Server

Format: String

Units: Not applicable

Specifies the base enterprise object identifier used for the SNMP traps.

BEA ID and Oracle Communications Services Gatekeeper IDs are fixed and appended to this ID.

For each individual SNMP trap, the alarm ID for the alarm is appended per alarm.

Attribute: RepeatedTraps

Scope: Cluster

Format: int

Units: Not applicable

Specifies the number of times each SNMP trap is sent to each configured manager.

Attribute: SNMPVersion

Scope: Cluster

Format: int

Units: Not applicable

Specifies the SNMP version to use.

Enter:

• 0 to use SNMP v1.

• 1 to use SNMP v2.

Attribute: SeverityFilter

Scope: Cluster

Format: int

Units: Not applicable

Specifies the severity filter setting.

Only alarms with a severity that exceeds or is equal to the specified severity filter will cause a trap to be generated.

Enter:

• 4 to generate SNMP traps for CRITICAL alarms.

• 3 to generate SNMP traps for MAJOR and more severe alarms.

• 2 to generate SNMP traps for MINOR and more severe alarms.

• 1 to generate SNMP traps for WARNING and more severe alarms.

Operation: addTrapReceiver

Scope: Cluster

Adds a receiver for the SNMP traps. Returns an ID for the receiver.

Signature:

addTrapReceiver(Address: String, Port: int)

Table 13-3 describes these parameters.

Table 13-3 addTrapReceiver

Parameter	Description
Address	IP address for the trap receiver
Port	Port for the trap receiver

Operation: deleteTrapReceiver

Scope: Cluster

Deletes a previously added trap receiver.

Signature:

deleteTrapReceiver(id: int)

Table 13-4 describes this parameter.

Table 13-4 deleteTrapReceiver

Parameter	Description
id	ID of the trap receiver to delete. Use Operation: listTrapReceivers to list the IDs.

Operation: listTrapReceivers

Scope: Cluster

Displays a list of all registered trap receivers.

Signature:

listTrapReceivers()

This operation accepts no parameters.