Modifying the Domino server

You must make the following modifications to the Domino server before you can run the adapter:

  1. Configure the server to run the Domino Internet Interoperability Protocol (IIOP) and HTTP server (for Web Applications), and configure the server to allow remote calls from an application. These changes are made with the Domino Administrator.
  2. Modify the NOTES.INI file on the Domino server.
  3. Copy the event table and associated files and the event listener to the required directories on the Domino server.
  4. Configure the event table.
  5. Make the NCSO.jar file accessible to the adapter.

Configuring changes with Domino Administrator

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.

HTTP

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.

IIOP

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.

Java/COM

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

Note:
The username configured for the adapter is the value for ApplicationUserName as configured with Connector Configurator Express. Refer to Application-specific configuration properties for more information.

Configure these as follows:

In R5:

  1. Select the Security tab.
  2. In the Java/COM Restrictions section, in the "Who can -" column under both "Run unrestricted Java/Javascript/COM" and "Run restricted Java/Javascript/COM," enter the ApplicationUserName that is configured in the Connector Configurator Express file, as well as the username(s) that will be specified in any incoming business objects, if applicable.

In R6:

  1. Select the Security tab.
  2. In the Programmability Restrictions section, in the "Who can -" column, enter the ApplicationUserName that is configured in the Connector Configurator Express file, as well as the username(s) that will be specified in any incoming business objects, if applicable, for the following item: Run restricted Java/Javascript/COM

Modifying NOTES.INI

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.

Note:
The event listener is a Domino Extension Manager library; therefore, the line should be entered on the same line in the NOTES.INI file as any other Domino Extension Manager libraries, separated from other entries by commas.

Copying files to the Domino server

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.
Note:
Copy this ONLY if your Domino server runs on OS/400 or Linux.

Copying event table files

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.

Copying the event listener

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.

Configuring the event table

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:

  1. From a Lotus Notes client, select File > Database > Open and select the Domino server name to be supported by this adapter.
  2. Select the BIALD_EventTable database. If it does not appear in the list, enter or browse for BIALD_EventTable.nsf in the Filename field. The window appears similar to the following:
    Shows Open Database field with targeted database selected.
  3. Click Open. The following window is displayed:
    Shows window with Event Table views  (EventArchiveView, EventConfiguration View, and EventTableView displayed in left panel; EventConfigurationView selected. Related buttons to select across top of window are Empty Trash, Move to Trash, and New Configuration
  4. Select EventConfigurationView from the navigation view in the left panel.
  5. Select New Configuration from the menu bar. The following table appears:

    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.

  6. In the Database Path field , enter the path of the database that you want the adapter to monitor. The path should be relative to your Domino server root directory/Data. For example, using the graphic shown above, if the database is called Buyer and the path is Domino server root/Data/BusApp/Buyer.nsf, enter BusApp/Buyer.nsf in the Database Path field.
  7. In the Event Type row, select the verb types or verb type combination that will enable the adapter to monitor the desired event types, as follows:
    For the adapter to monitor: Select:
    Create events Create and Update
    Delete events Delete
    Update events Update

    Note:
    It is not possible for the adapter to monitor Create events without also monitoring Update events. For monitoring Create events, using the checkbox, select Create and Update.
  8. Select File > Save to save the configuration, then close the event table database.

Making NCSO.jar accessible

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.

Location of NCSO.jar

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.

Modifying the startup script

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.

Note:
Windows is the only system that requires you to point the NCSO.jar file to the correct location.

Copyright IBM Corp. 2004