How to use the SNMP agent

This section describes how to use the SNMP agent to monitor the InterChange Server system. Before you can use the SNMP agent, you must do the following:

This section covers the following topics:

Steps for starting the SNMP agent

Steps for stopping the SNMP agent

Steps for reconfiguring the SNMP agent

Steps for starting the SNMP agent

Perform the following steps to start the SNMP agent:
UNIX

To start, stop, or get status on the SNMP agent on UNIX, run the snmpagent_manager script.

If you run the SNMP agent on a UNIX operating system and the SNMP agent is configured to the default port (1161) or to any port number less than 1024, the port must not be in use and you must be root to run the SNMP startup script. If the SNMP agent is configured to a port number greater than or equal to 1024, a non-root user can start the script.

Steps for stopping the SNMP agent

Perform the following steps to stop the SNMP agent:
UNIX

Use the snmpagent_manager script.

Steps for reconfiguring the SNMP agent

Configuration information for the SNMP agent is stored in a configuration file named wbi_snmpagent.cfg in the <WebSphere Business Integration Install Dir>\snmp\config directory.

To change the default values, edit the file as necessary.

The values contained in the file are specified as:

ParameterName: value
 

Table 6 lists the parameters used for the operation of the SNMP agent.

Table 6. SNMP agent configuration file parameters
Parameter Description Values Default
TraceLevel Defines the verboseness of the trace information. 0-5 0
LogFile Path to the log file.
wbi_snmpagent.log, located in the <WebSphere Business Integration Install Dir>\snmp\log directory
AgentStateFile Path to the file that contains the agent's state.
wbi_snmpagent.sts, located in the <WebSphere Business Integration Install Dir>\snmp\state directory.
PollInterval Not all information required by the SNMP agent is available through callbacks, and certain information needs to be obtained through periodic polling. This parameter specifies the polling interval, in seconds 0 (no polling) and up 30
Port The port on which the SNMP agent listens for requests from SNMP managers A valid port number 1161 (the default SNMP port number for UNIX)
161 (the default SNMP port number for Windows)

If you want to make changes to the SNMP configuration, the SNMP Configuration wizard provides fields for the information in Table 6.. The wizard creates (or modifies) the wbi_snmpagent.cfg file based on the values in these fields.

After changing the configuration file, shut down the SNMP agent and restart it.

Copyright IBM Corp. 1997, 2004