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:
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
Confirm that the Microsoft SNMP service is installed.
Start the SNMP and LNSNMP services. From a command prompt, type the following commands:
net start snmp
net start lnsnmp
Select Start >Program >Administrative Tools >Services to open the Services MMC
Double-click on the SNMP service and select the Traps tab.
In the Community name field, type public and click add to list.
In the Traps destinations section, select Add and type the IP address of your JSA. Click Add.
Click OK.
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.
Stop the LNSNMP service with the following command:
lnsnmp.sh stop
Stop the SNMP subsystem with the following command:
stopsrc -s snmpd
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"
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
Start the SNMP subsystem with the following command:
startsrc -s snmpd
Start the LNSNMP service with the following command:
lnsnmp.sh start
Create a link to the LNSNMP script
ln -f -s /opt/ibm/lotus/notes/latest/ibmpow/lnsnmp.sh /etc/lnsnmp.rc
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.
Log in to the Domino Server console.
To support SNMP traps for Domino events, type the following command to start the Event Interceptor add-in task:
load intrcpt
To support Domino statistic threshold traps, type the following command to start the Statistic Collector add-in task:
load collect
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.
Open the Domino Administrator utility and authenticate with administrative credentials.
Click the Files tab, and the Monitoring Configuration (events4.nsf) document.
Expand the DDM Configuration Tree and select DDM Probes By Type.
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.
Select DDM Filter.
You can either create a new DDM Filter or edit the existing DDM Default Filter.
Apply the DDM Filter to enhanced and simple events. Choose to log all event types.
Depending on the environment, you can choose to apply the filter to all servers in a domain or only to specific servers.
Click Save. Close when finished.
Expand the Event Handlers tree and select Event Handlers By Server.
Select New Event Handler.
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.
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:
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. |