Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 4 Getting Started : Configuring the Adapter Service Engine

Configuring the Adapter Service Engine
TIBCO ActiveMatrix Adapter Service Engine for Lotus Notes is configured with TIBCO Business Studio.
Configuration Task Sequence
To configure the adapter service engine, complete the following tasks:
 
Task A Start TIBCO Business Studio
To start TIBCO Business Studio:
1.
select Start > All Programs > TIBCO > TIBCO Business Studio 2.2 > TIBCO Business Studio
or
run the executable from the command line
AMX_HOME\BusinessStudio\TIBCOBusinessStudio.exe
run AMX_HOME/BusinessStudio/TIBCOBusinessStudio
2.
3.
The first time you run TIBCO Business Studio, it displays a Welcome screen. Dismiss the screen by clicking the Close button in the title bar.
Task B Create an Adapter Project
A project contains the configuration files that define runtime options for the adapter.
To create an adapter project:
1.
2.
In the New Project dialog, expand TIBCO ActiveMatrix Adapters, select Adapter Project as the wizard, and then click Next.
3.
4.
In the Assets pane, select the asset types that are required for your project. This example uses the default setting, that is, only the Adapters asset type is selected.
Figure 16 Select Asset Types
5.
To use different names, click Next, and then enter new names in corresponding fields.
Task C Create an Adapter Instance
An adapter instance can contain Publisher, Subscriber, RPC Server, RPC Client, Login, Logout, or all of them.
To create an adapter instance:
1.
In the Project Explorer, right-click Adapter Configurations, and then select New > Other from the shortcut menu.
2.
In the New dialog, expand TIBCO ActiveMatrix Adapters > Configurations, select LotusNotes Adapter, and then click Next.
3.
In the LotusNotes Adapter Configuration dialog, click Finish. This creates an adapter instance named, by default, LotusNotesAdapterConfiguration. You can change the name in the Configuration tab later.
Task D Create Lotus Notes Connection
To configure the connection parameters:
1.
a.
From the File menu, select New > Adapter Resources.
b.
In the Create New Adapters Resource dialog, expand Shared Resources, select Lotus Connection. Click Next.
c.
Select the parent folder for the Lotus Notes Connection shared resource. For example, the Shared Resources folder under the adapter project folder.
d.
Click Finish.
2.
3.
a.
b.
Click the Adapter Options tab.
c.
d.
Figure 17 Connection Configuration
e.
Task E Import Lotus Objects
 
1.
2.
In the Import dialog, expand TIBCO ActiveMatrix Adapter > Metadata, select Lotus Objects, and then click Next.
3.
4.
5.
6.
7.
Figure 18 Import Lotus Objects
8.
Click Finish.
Task F Configure a Service
The next step is to configure an adapter service that performs the publication, subscription, or request-response data passing operations for the adapter service engine.
1.
2.
3.
From the File menu, select Save to save the project information.
 
Configuring Lotus Notes Connection
This section explains the options of a connection configuration, and demonstrates how to set up different types of connections, as follows:
 
Lotus Domino Server Name
If the default TCP/IP port number or SSL port number for HTTP has been changed in IBM Domino Administrator, the port number should be specified in this field. For example, 192.168.66.10:8081. You need not do extra configuration in this field if the port number for DIIOP has been changed.
The name of the .nsf file. If the .nsf file resides in the local file system, specify the full path to access the database.
Bypass HTTP Service of Domino
If you select this checkbox, specify the full path of the IOR file, including the filename. For example, C:\Program Files\lotus\Domino\data\domino\html\diiop_ior.txt.
Enter the full path including the filename of the IOR file. The IOR file is used by the adapter to connect to the Domino server. The file should be on the local machine and the default location of the diiop_ior.txt is Domino_Installation_Home/data/domino/html.
You can also click the Set Bindings button to launch the Binding Editor and then pick substitution variables to bind with the properties.
Setting Up Remote Connection
Before proceeding with the steps listed in this section, see Setting Up Remote Connection for configurations to be completed in advance. The following steps guide you through a simple configuration to set up a remote connection:
1.
2.
3.
Empty the ID File field.
4.
5.
Select the Bypass HTTP Service of Domino checkbox if necessary. Use this option in the following conditions:
6.
If you selected the Bypass HTTP Service of Domino checkbox, browse to locate the IOR file in the IOR File field.
7.
8.
Click the Test Connection button to test the connection.
Setting Up SSL Connection
To secure the connection between the adapter and the remote Lotus Domino Server, you can set up an SSL connection.
Before proceeding with the steps listed in this section, see Setting Up Remote Connection for configurations to be completed in advance. The following tasks guide you through a simple configuration to set up an SSL connection. Note that the configurations described in Task A through Task E are for the design time connection.
 
Task A Create a Fragment Project
1.
2.
In the New Project dialog, expand Plug-in Development, select Fragment Project as the wizard, and then click Next.
3.
Figure 19 Create a Fragment Project
4.
In the Host Plug-in area, click the Browse button next to the Plug-in ID field, and select the com.tibco.adln.tpvl.ibmdrivers(1.0.0.003) plug-in. Then click OK.
5.
Figure 20 Configure the Fragment Project
6.
Click Finish.
7.
Click Yes to open the associated perspective when prompted.
8.
In the perspective of the fragment project, click the MANIFEST.MF tab. You should be able to find the following entry:
   Fragment-Host: com.tibco.adln.tpvl.ibmdrivers; bundle-version="(1.0.0, 2.0.0)"
Task B Import the Certificate JAR File
1.
2.
In the Import dialog, select General > File System, and then click Next.
3.
Click the Browse button next to the From directory field, locate the folder where the certificate JAR file resides. Select the checkbox next to the certificate JAR file. Click Finish.
Figure 21 Import Certificate JAR File
4.
Click the Runtime tab in the perspective.
5.
In the Classpath section, click Add to add the JAR file that is just imported.
6.
Figure 22 Configure the Runtime Tab
7.
Task C Create a Feature Project
1.
2.
In the New Project dialog, expand Plug-in Development, select Feature Project as the wizard, and then click Next.
3.
4.
5.
Click Yes to open the associated perspective when prompted.
6.
Click the Plug-ins tab. Ensure that the fragment is selected in the Plug-ins and Fragments list.
7.
Click the Versions button, select Copy versions from plug-in and fragment manifests, and then click Finish.
8.
In the Plug-in Details section, select the Unpack the plug-in archive after the installation checkbox.
9.
Task D Create Deployable Archive
1.
2.
In the Export dialog, select Plug-in Development > Deployable features, and then click Next.
3.
4.
In the Destination tab, select the Archive file radio button, and then click the Browse button to specify the path as well as file name of the archive file.
5.
Click Finish.
Task E Install Feature into TIBCO ActiveMatrix Environment
1.
Two folders are created after the extraction, one is named as features and the other is plugins.
2.
Copy the sub folder within the features folder to AMX_HOME/components/eclipse/features.
Copy the sub folder within the plugins folder to AMX_HOME/components/eclipse/plugins.
3.
4.
   tibcommander -Dfeature.name=featureID -f AMX_HOME/tools/scripts/addfeature.xml
where the parameter featureID can be found in TIBCO Business Studio, on the Overview tab of the feature project.
5.
Task F Enable SSL for Lotus Connection
1.
2.
3.
Empty the ID File field.
4.
5.
Select the Bypass HTTP Service of Domino checkbox if necessary. Use this option in the following conditions:
6.
If you selected the Bypass HTTP Service of Domino checkbox, browse to locate the IOR file in the IOR File field.
7.
Depending on the requirements, select the Enable SSL on HTTP checkbox or the Enable SSL on DIIOP checkbox.
Guidelines for Using SSL on HTTP
The IOR file is cached after the adapter gets it through a HTTP or HTTPS connection. If the adapter tries to get the IOR file through another HTTP or HTTPS connection from the same Domino server later, the cached IOR file will be used instead of getting a new one from the designated connection.
To avoid such a problem, follow the rules below when you need to access a Domino Server which enables both HTTP service and HTTPS service on it:
Do not add adapter instances with different connection types (HTTP or HTTPS) to the same TIBCO ActiveMatrix Adapter project.
If you have opened a project with HTTP connection in TIBCO Business Studio, open another project with HTTPS connection from a different workspace.
If you have changed the connection type (from HTTP to HTTPS or vice versa) for an adapter instance, restart TIBCO Business Studio for the change to take effect.
Setting Up Local Connection
Before proceeding with the steps listed in this section, see Setting Up Local Connection for configurations to be completed in advance. The following steps guide you through a simple configuration to set up a local connection:
1.
Empty the Lotus Domino Server Name field.
2.
In the Database field, enter the full path of the .nsf file that resides in the local file system.
3.
4.
Empty the Username field and the Password field.
5.
6.
7.
Click the Test Connection button to test the connection.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved