Adjusting the Configuration File for Sending SNMP Traps

Use

In the configuration file, you define details about the sending of the SNMP traps using the method CCMS_OnAlert_SNMP_TRAP_CFG, such as the recipients and the port to which the traps are to be sent, and the protocol with which they are to be sent.

Features

The values in the configuration file are determined using three levels:

Predefined default values
General default values of the configuration file (section [SNMP_DEFAULT])
Special values for a recipient host ([DESTINATION_<x>] sections)

These values have increasing priority from the top of the file to the bottom; that is, a value that is specified in a level with a higher value overwrites the value of a lower level.

You can set the following parameters in each of the above sections ([SNMP_DEFAULT] and [DESTINATION_<x>]):

Parameter	Meaning
`VERSION`	SNMP version (1, 2c, or 3)
`HOSTNAME COMMUNITY INFORM TIMEOUT RETRIES TRANSPORT PORT MIB_DIR`	Parameters whose names and meanings correspond to those of the method parameters for the method `CCMS_OnAlert_SNMP_TRAP` (see Setting Up the Sending of SNMP Traps)

Set the following parameters only if you are using SNMP version 3:

Parameter	Meaning
`USER_NAME`	Name of the SNMP user
`AUTH_PASSPHRASE`	Password of the SNMP user
`SECURITY_LEVEL`	Security level; the following levels are supported: `NoauthNoPriv`: No authentication, no encryption (Default) `authNoPriv`: Authentication, no encryption
`AUTH_PROTOCOL`	Procedure for authenticating the message (creation of a checksum used to ensure that the message was not changed); the `MD5` (Message Digest 5) procedure is supported
`SECURITY_ENGINE`	Engine ID of the application from which the SNMP traps are to be sent; this parameter is only required if `INFORM=0`, since the engine ID is generated during the communication if `INFORM=1`
`CONTEXT_ENGINE CONTEXT_NAME`	Reserved for internal use
`PRIV_PROTOCOL PRIV_PASSPHRASE`	Not yet supported

Activities

Specify the complete path of the adjusted configuration file in the method parameter CFG_FILE. Perform the usual adjustment and assignment of the method as described in Setting Up the Sending of SNMP Traps.

Example

There is a template with the default settings for the configuration file in the SNMPLIB archive. This template has the following content:

Sample Code

####################################################################
# Configuration File for trapsend_cfg executable                    
# trapsend_cfg can send SNMP traps to more than one destination     
#                                                                   
# How the values are set:                                           
#                                                                   
# Default Template [SNMP_DEFAULT] parameters specified here are     
# valid for all [DESTINATION_x] templates                           
#                                                                   
# default, if parameter is not set                                  
# VERSION    1                     TRANSPORT  UDP                   
# HOSTNAME   localhost             MIB_DIR    .                     
# PORT       162                   COMMUNITY  PUBLIC                
# TIMEOUT    1                     INFORM     0                     
# RETRIES    5                                                      
#                                                                   
# for v3 traps                                                      
# USER_NAME                        CONTEXT_ENGINE                   
# AUTH_PASSPHRASE                  CONTEXT_NAME                     
# AUTH_PROTOCOL                    PRIV_PROTOCOL                    
# SECURITY_LEVEL                   PRIV_PASSPHRASE                  
# SECURITY_ENGINE                                                   
#                                                                   
# Destination Template [DESTINATION_<X>] parameters set in          
# [SNMP_DEFAULT] can be overwritten here for a specific destination 
#                                                                   
####################################################################

# this is an example of a configuration file
[SNMP_DEFAULT]
HOSTNAME=ls3016
MIB_DIR=.

# send SNMP v1 trap to DESTINATION_0
[DESTINATION_0]
VERSION=1
COMMUNITY=PUBLIC
TIMEOUT = 3
RETRIES = 2
TRANSPORT =UDP
HOSTNAME=ls3016

# send SNMP v2 trap to DESTINATION_1
[DESTINATION_1]
VERSION=2c
INFORM=0

# send SNMP v3 trap to DESTINATION_2
[DESTINATION_2]
VERSION=3
INFORM=1
USER_NAME=myuser
AUTH_PASSPHRASE=mypassword

# send SNMP v3 trap to DESTINATION_3
[DESTINATION_3]
VERSION=3
INFORM=0
USER_NAME=myuser
AUTH_PASSPHRASE=mypassword
SECURITY_ENGINE=0x0102030405
HOSTNAME=ls3016
AUTH_PROTOCOL=MD5

Sending Alerts Using SNMP Traps start page