You must make the following modifications to the Domino server before you can run the adapter:
The Domino server must be configured to accept remote calls from an application for the adapter to operate. Configuration is done with the Domino Administrator (refer to your Lotus Domino administration documentation for details). The following sections describe what must be configured. Make sure that the server is restarted after these changes are made so that they will take effect.
The HTTP server (for Web Applications) must be enabled on the Domino server. Refer to your Lotus Domino administration documentation for more information on how to set this up.
The Domino Internet Interoperability Protocol (IIOP, sometimes called DIIOP) must be enabled. Make sure that a TCP/IP port number is configured and enabled for IIOP.
You must configure the username that is configured for the adapter, as well as the username(s) that will be specified in any incoming business objects, (if applicable) to run restricted and unrestricted Java agents (and methods, for R6).
Configure these as follows:
In R5:
In R6:
Add one of the following lines to the NOTES.INI file on the Domino server, depending on the operating system:
On Windows: EXTMGR_ADDINS=nbiald.dll
On OS/400: EXTMGR_ADDINS=libbiald.so
On Linux: EXTMGR_ADDINS=libbiald.so
This enables the Domino server to call the event listener at startup.
You must copy the event table files and the event listener from the
%ProductDir%/connectors/Domino/dependencies directory on
the adapter host computer to the required directories on the Domino
server. The following table lists the files
and where they must be copied:
Table 4. Files to copy into Domino server directories
Directory to copy to | File | Description |
---|---|---|
Domino data directory |
BIALD_EventTable.nsf | Event table |
Domino data directory |
BIALD_emptytrash.gif BIALD_movetotrash.gif BIALD_newconfig.gif |
Event table bitmaps (appear if event table is viewed through Lotus Notes Client). |
Copy the following: | ||
Domino server root | nbiald.dll | Event listener for Windows
systems. Copy this only if your Domino server runs on Windows. |
Domino server root | libbiald.so | Event Listener for OS/400 and Linux.
|
Copy the following files from their installation directory to the Domino data directory:
BIALD_EventTable.nsf
BIALD_emptytrash.gif
BIALD_movetotrash.gif
BIALD_newconfig.gif
For Windows systems:
The default for the data directory is c:\Lotus\Domino\Data.
For OS/400 systems:
The default for the data directory is /Domino/dominoServerName/data, where dominoServerName is the name of the Domino server.
For Linux systems:
The default for this data directory is /local/notesdata.
Copy the event listener from the installation directory (%ProductDir%/connectors/Domino/dependencies) to the Domino server root directory.
This will be one of the following files, depending on the operating system on which the Domino server is run:
For Windows systems: nbiald.dll
Typically, the root directory to which you will install is as follows, c:\lotus\domino.
For OS/400 systems:
You must create a symbolic link using the following CL command: ADDLNK OBJ('/QSYS.LIB/QWBISVR43.LIB/LIBBIALD.SRVPGM') NEWLNK('/QIBM/UserData/LOTUS/NOTES/LIBBIALD.SRVPGM')
For Linux systems: libbiald.so
Upon installation, this file is located in %CROSSWORLDS%/connectors/Domino/dependencies
Once configured for execution, copy this file to/opt/lotus/notes/latest/linux.
To allow the adapter's event listener to monitor events that occur on the Domino server, you must configure the adapter's event table. The event table is a Lotus Domino database file which you can open from a Lotus Notes client.
To configure the event table:
The WebSphere Business Integration Adapter for Lotus Domino Configuration Table appears showing the left column, "Event Info," and the right column, "Value." Under Event Info, there are two labeled rowsl: Database Path, and below it, Event Type.
Enter the Database path in the right column in the first row. Using the checkbox, select whether to Create, Delete, or Update events (in that order) from the second row.
For the adapter to monitor: | Select: |
---|---|
Create events | Create and Update |
Delete events | Delete |
Update events | Update |
The file NCSO.jar is part of the Lotus Domino Toolkit for Java/CORBA, which should have come with your Lotus Domino server. (The file should be available on the Domino server and on Notes clients.) NCSO.jar contains the Lotus Domino API (known as Domino Objects for Java ). You must update the adapter startup script to point to this file.
Typically, NSCO.jar resides in the following directory on the Domino server:
DirectoryName\Data\domino\java
where DirectoryName is the name of the Domino server directory or the Notes client directory.
Change the following line in the adapter startup script to point to NCSO.jar.
On Windows: Change
set DOMINOCLASSES=C:\Notes\Data\domino\java\NCSO.jar
to
set DOMINOCLASSES=directoryname\NSCO.jar
where
directoryname is the name of the directory containing NCSO.jar.