Installing the Adapter

Overview

This chapter explains how to install, upgrade, and uninstall IBM webMethods Adapter for Lotus Notes 6.0. The instructions use the IBM webMethods Installer and the IBM webMethods Uninstaller wizards. For complete information about the wizards or other installation methods, or to install other webMethods products, see Installing IBM webMethods Products On Premises for your release.

Requirements

For a list of the operating systems, Lotus Domino Server products, and webMethods products supported by Adapter for Lotus Notes 6.0, see IBM webMethods Adapters System Requirements.

Adapter for Lotus Notes 6.0 has no hardware requirements beyond those of its host Integration Server.

Installing Adapter for Lotus Notes 6.0

About this task

To install Adapter for Lotus Notes on AS/400, you must use the Installer's console mode, described in the Installing IBM webMethods Products On Premises for your release.

Note: If you are installing the adapter in a clustered environment, you must install it on each Integration Server in the cluster, and each installation must be identical. For more information about working with the adapter in a clustered environment, see Adapter for Lotus Notes in a Clustered Environment.

To install Adapter for Lotus Notes 6.0 :

Procedure

Download Installer .
If you are installing the adapter on an existing Integration Server, shut down Integration Server.
Start the Installer wizard.
Choose the webMethods release that includes the Integration Server on which to install the adapter. For example, if you want to install the adapter on Integration Server 9.12, choose the 9.12 release.
Specify the installation directory as follows:
- If you are installing on an existing Integration Server, specify the webMethods installation directory that contains the host Integration Server.
- If you are installing both the host Integration Server and the adapter, specify the installation directory to use.
  The Installer will install the adapter in the Integration Server_directory\packages directory.
In the product selection list, select Adapters > webMethods Lotus Notes Adapter 6.0. You can also choose to install documentation.
After installation is complete, configure the Domino Server to accept transactions from Integration Server. To do so, configure the HTTP and DIIOP tasks on the Domino Server, make sure the tasks are running, and make sure the tasks are listed in the notes.ini file in the Domino Server (for example, ServerTasks= task1,taskn ,http,diiop). For instructions, see your Domino Server administration documentation.
Set up the Adapter for Lotus Notes environment. To enable the Adapter for Lotus Notes to communicate with the Lotus Domino objects on the Domino Server, the adapter requires access to NCSO.jar, which is provided with the Lotus Domino Toolkit for Java/CORBA.
1. Go to the Integration Server_directory\instances\<instance_name>\packages\WmLotusNotesAdapter\code directory.
2. Create a jars\static directory.
3. Copy the NCSO.jar or NCSOW.jar file to the jars\static directory. The file is located in the directory where you installed the Domino Server (for example, LotusDomino_directory\data\domino\java).
Set up the Adapter for Lotus Notes environment for Integration Server 10.11 onwards.
The connections are not enabled as Integration Server 10.11 uses Java 11. The Lotus domino client uses IIOP (Internet Inter-ORB Protocol) to communicate with the Domino server. However, the CORBA modules (OMG CORBA API, an ORB implementation) is removed from Java 11 on Java SE Platform.
1. Download the GlassFish ORB implementation glassfish-corba-omgapi-4.2.3.jar from Maven https://mvnrepository.com/artifact/org.glassfish.corba/glassfish-corba-omgapi/4.2.3.
2. Copy the JAR file to the Integration Server_directory\instances\<instance_name>\packages\WmLotusNotesAdapter\code\jars directory.
3. Restart Integration Server if already started.

Upgrading to Adapter for Lotus Notes 6.0

About this task

You can upgrade to Adapter for Lotus Notes 6.0 from Adapter for Lotus Notes 1.0.x.

To upgrade from Adapter for Lotus Notes 1.0.x

Procedure

Alias management and other services that were available with Adapter for Lotus Notes 1.0.x are not available in Adapter for Lotus Notes 6.0 (see Unavailable Services and Records for a complete list). If your Adapter for Lotus Notes 1.0.x integrations use any services or records that are no longer available, disable or delete the corresponding flow steps in your integrations. If necessary, replace the functionality with other flow or Java services.

If you are not sure whether your integrations use any of the unavailable services or records, use the Find Dependents tool in Designer.

For instructions on this step, see the IBM webMethods Service Development Help for your release.
Create a list of each alias you currently use in Adapter for Lotus Notes 1.0.x. Include all information about the alias, including user, password, and host.
In Integration Server Administrator for Adapter for Lotus Notes 1.0.x, disable the LotusNotes 1.0.x package. Do not disable the user-defined package that contains your integrations. For instructions, see the IBM webMethods Integration Server Administrator’s Guide for your release.
Install Adapter for Lotus Notes 6.0 using the instructions in Installing Adapter for Lotus Notes 6.0.
In Integration Server Administrator for Adapter for Lotus Notes 6.0, configure a Adapter for Lotus Notes 6.0 connection for each alias you recorded in step 2. For instructions, see Adapter Connections.
In Designer, do the following:
1. Configure an adapter service that executes the createSession method in the lotus.domino.Session class for each connection object you created in step 5. For instructions, see Adapter Services.
2. Modify the wm.ln.authentication:login service in the WmLotusNotesAdapter package, as follows:
  - If you only have one alias, modify the wm.ln.authentication:login service to call the adapter service you created in step 6a.
  - If you have more than one alias, modify the signature of the wm.ln.authentication:login service to have an alias string as input. Based on the value of this string, the service should call the createSession adapter service that is associated with the corresponding connection for the alias provided.
  In either case, make sure the login service leaves a session object at the root level of the pipeline.
Perform acceptance testing to make sure the integrations, adapter connections, and adapter services are functioning correctly.

Unavailable Services and Records

The following services that were available with Adapter for Lotus Notes 1.0.x are not available in Adapter for Lotus Notes 6.0:

wm.ln.mimeEntity:transformXML
wm.ln.utils.alias:add
wm.ln.utils.alias:del
wm.ln.utils.alias:delAlias
wm.ln.utils.alias:edit
wm.ln.utils.alias:editAlias
wm.ln.utils.alias:get
wm.ln.utils.alias:getAlias
wm.ln.utils.alias:getAliasList
wm.ln.utils.alias:getCnfFile
wm.ln.utils.alias:saveAliasSettings
wm.ln.utils.alias:saveCnfFile

The following record is no longer available in Adapter for Lotus Notes 6.0:

wm.ln.utils.alias.recs:alias

For a list of all services provided with Adapter for Lotus Notes 6.0, see Built-In Services Reference.

Uninstalling Adapter for Lotus Notes 6.0

About this task

To uninstall Adapter for Lotus Notes 6.0

Procedure

Shut down the host Integration Server. You do not need to shut down any other webMethods products or applications that are running on your machine.
Start IBM webMethods Uninstaller, selecting the webMethods installation directory that contains the host Integration Server. In the product selection list, select Adapters > webMethods Lotus Notes Adapter 6.0. You can also choose to uninstall documentation.
Restart the host Integration Server.
Uninstaller removes all Adapter for Lotus Notes 6.0-related files that were installed. However, Uninstaller does not delete files created after you installed the adapter (for example, user-created or configuration files), nor does it delete the adapter directory structure. You can go to the Integration Server_directory\packages directory and delete the adapter directory.