# System Administrator’s Guide

# Managing and Configuring the SNMP service

The following section describes how to configure and manage the SNMP service.

- Configuration and management
- Reference: Attributes and Operations for SNMPService

## Introduction

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

Figure 12-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 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

### Configure SNMPService

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

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

## Reference: Attributes and Operations for SNMPService

Managed object: Container ServicesSNMPService

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

Below 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: n/a

Specifies the SNMP community address.

Default value is private.

### Attribute: EnterpriseObjectIdentifier

Scope: Server

Format: String

Units: n/a

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: n/a

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 trap 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 12-1 addTrapReceiver
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 12-2 deleteTrapReceiver
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()

Table 12-3 listTrapReceivers
listTrapReceivers
Parameter | Description
--- | ---
- | -