Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

IBM Lotus Domino

 

You can integrate an IBM Lotus® Domino®® device with JSA. An IBM Lotus Domino device accepts events by using SNMP.

Setting Up SNMP Services

To set up the SNMP services on the IBM®Lotus®Domino® server:

  1. Install the Lotus® Domino® SNMP Agent as a service. From the command prompt, go to the Lotus®\Domino® directory and type the following command:

    Insnmp -SC

  2. Confirm that the Microsoft SNMP service is installed.
  3. Start the SNMP and LNSNMP services. From a command prompt, type the following commands:
    • net start snmp

    • net start lnsnmp

  4. Select Start >Program >Administrative Tools >Services to open the Services MMC
  5. Double-click on the SNMP service and select the Traps tab.
  6. In the Community name field, type public and click add to list.
  7. In the Traps destinations section, select Add and type the IP address of your JSA. Click Add.
  8. Click OK.
  9. Confirm that both SNMP agents are set to Automatic so they run when the server boots.

Setting Up SNMP in AIX

Make sure TCP/IP and SNMP are properly installed and configured on the server.

You must log in as a root user.

  1. Stop the LNSNMP service with the following command:

    lnsnmp.sh stop

  2. Stop the SNMP subsystem with the following command:

    stopsrc -s snmpd

  3. Configure SNMP to accept LNSNMP as an SMUX peer. Add the following line to /etc/snmpd.peers

    "Lotus Notes Agent" 1.3.6.1.4.1.334.72 "NotesPasswd"

  4. Configure SNMP to accept an SMUX association from LNSNMP. Add the following line to /etc/snmpd.conf or /etc/snmpdv3.conf

    smux 1.3.6.1.4.1.334.72 NotesPasswd

  5. Start the SNMP subsystem with the following command:

    startsrc -s snmpd

  6. Start the LNSNMP service with the following command:

    lnsnmp.sh start

  7. Create a link to the LNSNMP script

    ln -f -s /opt/ibm/lotus/notes/latest/ibmpow/lnsnmp.sh /etc/lnsnmp.rc

  8. Configure LNSNMP service to start during the system restart. Add the following line to the end of /etc/rc.tcpip

    /etc/lnsnmp.rc start

Starting the Domino Server Add-in Tasks

After you configure the SNMP services, you must start the Domino® server add-in tasks.

Use the following procedure for each Domino® partition.

  1. Log in to the Domino® Server console.
  2. To support SNMP traps for Domino® events, type the following command to start the Event Interceptor add-in task:

    load intrcpt

  3. To support Domino® statistic threshold traps, type the following command to start the Statistic Collector add-in task:

    load collect

  4. Arrange for the add-in tasks to be restarted automatically the next time that Domino® is restarted. Add intrcpt and collect to the ServerTasks variable in Domino®'s NOTES.INI file.

Configuring SNMP Services

You can configure SNMP services:

Configurations might vary depending on your environment. See your vendor documentation for more information.

  1. Open the Domino® Administrator utility and authenticate with administrative credentials.
  2. Click the Files tab, and the Monitoring Configuration (events4.nsf) document.
  3. Expand the DDM Configuration Tree and select DDM Probes By Type.
  4. Select Enable Probes, and then select Enable All Probes In View. Note

    You might receive a warning when you complete this action. This warning is a normal outcome, as some of the probes require more configuration.

  5. Select DDM Filter.

    You can either create a new DDM Filter or edit the existing DDM Default Filter.

  6. Apply the DDM Filter to enhanced and simple events. Choose to log all event types.
  7. Depending on the environment, you can choose to apply the filter to all servers in a domain or only to specific servers.
  8. Click Save. Close when finished.
  9. Expand the Event Handlers tree and select Event Handlers By Server.
  10. Select New Event Handler.
  11. Configure the following parameters:
    • Basic - Servers to monitor: Choose to monitor either all servers in the domain or only specific servers.

    • Basic - Notification trigger: Any event that matches the criteria.

    • Event - Criteria to match: Events can be any type.

    • Event - Criteria to match: Events must be one of these priorities (Check all the boxes).

    • Event - Criteria to match: Events can have any message.

    • Action - Notification method: SNMP Trap.

    • Action - Enablement: Enable this notification.

  12. Click Save. Close when finished.

    You are now ready to configure the log source in JSA.

Configuring Your IBM Lotus Domino Device to Communicate with JSA

JSA does not automatically discover incoming syslog events from your IBM®Lotus®Domino® device.

You must manually create a log source from the Admin tab in JSA.

  1. Click the Admin tab.
  2. Click the Log Sources icon.
  3. Click Add.
  4. In the Log Source Name field, type a name for your log source.
  5. From the Log Source Type list, select IBM® Lotus® Domino®.
  6. From the Protocol Configuration list, select SNMPv2.
  7. Configure the following values:

    Table 1: SNMPv2 Protocol Parameters

    Parameter

    Description

    Log Source Identifier

    Type an IP address, host name, or name to identify the SNMPv2 event source.

    IP addresses or host names are recommended as they allow JSA to identify a log file to a unique event source.

    Community

    Type the SNMP community name required to access the system containing SNMP events.

    Include OIDs in Event Payload

    Clear the value from this check box.

    When selected, this option constructs SNMP events with name-value pairs instead of the standard event payload format.

  8. Click Save.
  9. On the Admin tab, click Deploy Changes.