MONITORING


Using NET-SNMP with the Domino SNMP Agent
On the Linux® and Solaris® platforms, the IBM® Lotus® Domino™ SNMP Agent uses the SMUX protocol, per RFC 1227, to communicate with the system's Master SNMP Agent. Some Linux distributions include a Master SNMP Agent that supports the SMUX protocol; others do not. The Solaris Master SNMP Agent does not support the SMUX protocol, making it necessary to substitute a Master SNMP Agent that does. This is true even with Solaris 10, which includes its own version of the NET-SNMP Master Agent, but without SMUX support. On the Linux and Solaris platforms, Domino includes a suitable NET-SNMP Master Agent, called NET-SNMPD, already configured to support the SMUX protocol and the Domino SNMP Agent.

Follow the instructions below to use the NET-SNMPD provided with Domino.

Note Before using NET-SNMPD, disable any existing Master SNMP Agent. For information on disabling an existing Master SNMP Agent, see your Master SNMP Agent's documentation.

Installing NET-SNMPD on Linux

Log on as the root user and then install NET-SNMPD on Linux as follows:

1. Install the NET-SNMPD files. Enter this command, changing the Domino executable path if necessary:


2. Arrange for NET-SNMPD to be restarted after a reboot.

3. Do one of these:


You have completed the installation of NET-SNMPD on Linux. Configure and start NET-SNMPD as explained below.

Installing NET-SNMPD on Solaris

Log on as the root user and then Install NET-SNMPD on Solaris as follows:

1. Install the NET-SNMPD files. Enter this command, changing the Domino executable path if necessary:


2. Arrange for NET-SNMPD to be restarted after a reboot. Enter these commands:
You have completed the installation of NET-SNMPD on Solaris. Configure and start NET-SNMPD as explained below.

Configuring NET-SNMPD

Update the /etc/net-snmpd.conf file with appropriate trap destinations and community names for your remote management infrastructure. Trap destinations are set using the trapsink directive. Community names are set using the rocommunity and rwcommunity directives.

Manually Starting and Stopping NET-SNMPD

To start NET-SNMPD, log on as the root user and enter this command:


To stop NET-SNMPD, log on as the root user and enter this command:
How NET-SNMPD was Created

The NET-SNMP package, which is distributed by http://www.net-snmp.org, contains a variety of tools for SNMP, however, Domino only includes the NET-SNMP Master Agent.

For Domino, the NET-SNMP 5.0.7 package was configured and built with the following options:


The resulting agent/snmpd was used as the NET-SNMPD for Domino.

Creating and Configuring your own NET-SNMP Master Agent

Because the UCD-SNMP and NET-SNMP packages, which are distributed by http://www.net-snmp.org, contain many optional components, you may want to create and/or configure your own Master SNMP Agent for use with Domino. To do so, invoke the source configure script with the following option, to include SMUX support:


Add the following line to the snmpd.conf file:
Note If you use the NET-SNMPD provided with Domino, you do not need to create or configure your own NET-SNMP Master Agent. Both have been done for you.

See also