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

Set up the SNMP services on the IBM Lotus Domino server to accept events:

  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

TCP/IP and SNMP must be properly installed and configured on the server before you set up SNMP in AIX.

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 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.

SNMPv2 Log Source Parameters for IBM Lotus Domino

If JSA does not automatically detect the log source, add an IBM Lotus Domino log source on the JSA Console by using the SNMPv2 protocol.

When using the SNMPv2 protocol, there are specific parameters that you must use.

The following table describes the parameters that require specific values to collect SNMPv2 events from IBM Lotus Domino:

Table 1: SNMPv2 log source parameters for the IBM Lotus Domino DSM

Parameter

Value

Log Source type

IBM Lotus Domino

Protocol Configuration

SNMPv2

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.