CommuniGate Pro
Version 5.4
Services
 
 
SNMP

SNMP Module

The CommuniGate Pro Server maintains a set of Statistics Elements containing information about the Server activity. These Elements can be be accessed via the built-in SNMP server ("agent").

The SNMP agent receives requests from SNMP clients ("managers") and either returns the information about internal states, counters, problems, or modifies the internal settings by a client request.

The Setting up MRTG for CommuniGate Pro document should help you configure the popular freeware SNMP manager.

Configuring the SNMP Module

By default, the CommuniGate Pro SNMP agent is not activated.

Use the WebAdmin Interface to configure the SNMP Module. Open the Services pages in the Settings realm, and open the SNMP page:

Processing
Log Level: Listener
Password:
Trap Password:
Trap Protocol:
Log
Use this setting to specify what kind of information the SNMP agent should put in the Server Log. Usually you should use the Major or Problems (non-fatal errors) levels. But when you experience problems with the SNMP agent, you may want to set the Log Level setting to Low-Level or All Info: in this case protocol-level or link-level details will be recorded in the System Log as well.

The SNMP agent records in the System Log are marked with the SNMP tag. Please note that SNMP is a binary protocol, so all low-level data is presented in the hexadecimal form.

listener
Use this link to open the UDP Listener page and specify the port number and local network address for the SNMP agent, and access restrictions for that port. When the port number is set to 0, the SNMP agent is disabled.
By default SNMP Manager programs send requests to the UDP port 161.
If your server computer is already running some other SNMP agent, you may want to specify a non-standard port number here and reconfigure your SNMP Manager software to use that port number.
Password
Use this setting to specify the SNMP "community name". The CommuniGate Pro SNMP agent accepts only those SNMP requests that contain the proper "community name" data.
Trap Password
This setting specifies an alternative SNMP "community name". The CommuniGate Pro SNMP agent accepts SNMP requests containing this "community name", and remembers the network (IP) addresses those requests have come from. The module then can send SNMP Traps to all remembered addresses.
Trap Protocol
This setting specifies the SNMP protocol version to use when sending SNMP Traps.

Accessing the Server MIB

The MIB (Management Information Base) is a text file describing the internal objects the SNMP agent can display, monitor, and/or modify. You need the CommuniGate Pro MIB file to properly configure the SNMP client ("manager") you want to use for server monitoring.

Different versions of the CommuniGate Pro software support different sets of internal objects, and CommuniGate Pro Server generates its MIB by a user request, presenting the most current information.

To access the CommuniGate Pro MIB file, use the WebAdmin interface to access the CGatePro-MIB.txt file:
http://yourservername:8010/CGatePro-MIB.txt

Save this file to a monitoring workstation disk and use it to configure your SNMP manager software.

Sending SNMP Traps

The SNMP module can send Traps on certain Events. See the Statistics Triggers section for more details. Traps can be sent to the network addresses explicitly specified in the Event Handler settings and/or to all remembered network addresses - addresses from which SNMP requests with the "Trap Password" community name have been received.

The SNMP module sends Traps using the SNMP protocol version specified with the Trap Protocol setting.

CommuniGate® Pro Guide. Copyright © 1998-2012, Stalker Software, Inc.