![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
Task A Start TIBCO Business StudioAMX_HOME\BusinessStudio\TIBCOBusinessStudio.exe
−
2. In the Workspace Launcher, accept the default workspace or browse to or create a new workspace. Click OK.
3. The first time you run TIBCO Business Studio, it displays a Welcome screen. Dismiss the screen by clicking the Close buttonin the title bar.
Task B 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.
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
−
− To use different names, click Next, and then enter new names in corresponding fields.Task C Create an Adapter InstanceAn adapter instance can contain Publisher, Subscriber, RPC Server, RPC Client, Login, Logout, or all of them.
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.
a.
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.
b. Click the Adapter Options tab.
c. In the Runtime Connection section, click Connection Configuration.
d. Figure 17 Connection Configuration
e. Click OK.Task E Import Lotus Objects
1. From the File menu, select Import.
2. In the Import dialog, expand TIBCO ActiveMatrix Adapter > Metadata, select Lotus Objects, and then click Next.
4. In the Download Location filed, browse to select the download location. For example, proj/Shared Resources.
6.
7. In the Lotus Objects Import Wizard dialog, select the objects you want to import from the Lotus Objects pane.Figure 18 Import Lotus Objects
8. Click Finish.Task F Configure a ServiceThe 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. In the adapter instance editor, click the Adapter Services tab.
2. Click the corresponding buttons to add the services you want to use. See Adapter Services for how to configure different services.
3. From the File menu, select Save to save the project information.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 selected, the adapter runtime will read from the specified file instead of using HTTP service of Domino to get the IOR.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. Enable SSL on HTTP Enable SSL on DIIOP You can also click the Set Bindings button to launch the Binding Editor and then pick substitution variables to bind with the properties.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. In the Lotus Domino Server Name field, enter the host name or IP address of the machine that hosts the Lotus Domino Server.
2. In the Database field, enter the name of the .nsf file to be accessed.
3. Empty the ID File field.
4. Enter the username and password to log into Lotus Domino Server in the Username field and the Password field.
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.
8. Click the Test Connection button to test the 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. In the New Fragment Project dialog, enter a name for the project. Leave the other options unchanged. Click Next.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:
2.
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. In the Exported Packages section, click Add to add the package.Figure 22 Configure the Runtime TabTask 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.
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.Task D Create Deployable Archive
1.
2.
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.
2.
−
−
3. where the parameter featureID can be found in TIBCO Business Studio, on the Overview tab of the feature project.
1. In the Lotus Domino Server Name field, enter the host name or IP address of the machine that hosts the Lotus Domino Server.
2. In the Database field, enter the name of the .nsf file to be accessed.
3. Empty the ID File field.
4. Enter the username and password to log into Lotus Domino Server in the Username field and the Password field.
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.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.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.
4.
7. Click the Test Connection button to test the connection.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |