Anpassen der Konfigurationsdatei für den
Versand von SNMP-Traps
Verwendung
Sie benötigen in den folgenden Fällen eine Konfigurationsdatei, um den Versand der SNMP-Traps einzurichten:
· Bei Verwendung der Methode CCMS_OnAlert_SNMP_TRAP_CFG (verwenden Sie diese Methode, wenn Sie SNMP-Traps an mehr als einen Empfänger senden möchten, oder wenn Sie SNMP-Version 3 verwenden)
· Bei Versendung der SNMP-Traps als Funktion der CCMS-Agenten
In der Konfigurationsdatei legen Sie Details zum Versand der SNMP-Traps fest, also z. B. an welchen Empfänger, welchen Port und über welches Protokoll das Trap gesendet werden sollen.
Funktionsumfang
Die Werte in der Konfigurationsdatei werden über drei Ebenen ermittelt:
· Vordefinierte Default-Werte
· Allgemeine Default-Werte der Konfigurationsdatei (Abschnitt [SNMP_DEFAULT])
· Spezielle Werte für einen Empfänger-Host (Abschnitte [DESTINATION_<x>])
Dabei haben diese Werte von oben nach unten eine steigende Priorität, d. h. ein Wert, der in einer höherwertigen Ebene angegeben wird, überschreibt den Wert einer niedrigeren Ebene.
Im Einzelnen können Sie in jedem der o. g. Abschnitte ([SNMP_DEFAULT] und [DESTINATION_<x>]) die folgenden Parameter setzen:
Parameter |
Bedeutung |
VERSION |
SNMP-Version (1, 2c oder 3) |
HOSTNAME |
Parameter, deren Namen und Bedeutung den
Methodenparametern der Methode CCMS_OnAlert_SNMP_TRAP (siehe
|
Setzen Sie die folgenden Parameter nur dann, wenn Sie die SNMP-Version 3 verwenden:
Parameter |
Bedeutung |
USER_NAME |
Name des SNMP-Benutzers |
AUTH_PASSPHRASE |
Kennwort des SNMP-Benutzers |
SECURITY_LEVEL |
Sicherheitsstufe; unterstützt werden die folgenden Stufen: NoauthNoPriv: keine Authentifizierung, keine Verschlüsselung (Default) authNoPriv: Authentifizierung, keine Verschlüsselung |
AUTH_PROTOCOL |
Verfahren zur Authentifizierung der Nachricht (Erstellung einer Prüfsumme, mit der gesichert wird, dass die Nachricht nicht verändert wurde); unterstützt wird das Verfahren MD5 (Message Digest 5) |
SECURITY_ENGINE |
Engine-ID der Anwendung, von der die SNMP-Traps gesendet werden sollen; dieser Parameter wird nur bei INFORM=0 benötigt, da bei INFORM=1 die Engine-ID bei der Kommunikation generiert wird |
CONTEXT_ENGINE |
für interne Verwendung reserviert |
PRIV_PROTOCOL |
wird noch nicht unterstützt |
Aktivitäten
· Bei Versendung der SNMP-Traps als Funktion der CCMS-Agenten:
Geben Sie den vollständigen Pfad der angepassten Konfigurationsdatei im Parameter TrapSendFile an (siehe unter Versand und Empfang von SNMP-Traps durch CCMS-Agenten einrichten).
· Bei Versendung der SNMP-Traps über die Methode CCMS_OnAlert_SNMP_TRAP_CFG:
Geben Sie den vollständigen Pfad der angepassten
Konfigurationsdatei im Methodenparameter CFG_FILE
an. Die übrige Anpassung und Zuordnung der Methode nehmen Sie so vor wie in
Versand von
SNMP-Traps als Autoreaktionsmethode einrichten beschrieben.
Beispiel
Ein Template mit den Default-Einstellungen der Konfigurationsdatei gehört zum SNMPLIB-Archiv. Dieses Template hat den folgenden Inhalt:
####################################################################
# 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
