The adapter is deployed at the node level, and the application
provides a JNDI reference to the activation specification. You must
create the activation specification with the same JNDI name at the
cluster scope from the Process Administrative Console.
The adapter can be shared across multiple applications
Before you begin
The following steps are a necessary prerequisite to configure
and deploy the module.
- IBM® Integration Designer version 7.5.0.0 or
above.
- A clustered topology deployment environment on the IBM Business Process Manager or WebSphere® Enterprise Service Bus available
from IBM Integration Designer.
- Create a clustered topology deployment environment, as shown in
the following Gold Topology configuration figure.
Figure 1. Deployment environment
- Deploy the adapter and the adapter applications (EAR files) in
the AppTarget (the target that hosts the SCA container).
Figure 2. Deployment environment showing
server clusters
About this task
To create an application with the node level adapter and
activation specification properties specified in the module itself,
use the external service wizard.
Procedure
- In the Service Configuration Properties window,
from the Deploy connector project property
list, select On server for use by multiple applications.
- From the Connection properties list,
select Use JNDI lookup name configured on server.
- In the JNDI lookup name property
field, specify the JNDI name. Use this same JNDI name when you create
the activation specification from the Admin Console.
- Create the module as described in the Business
process management samples for WebSphere Adapters.
- In the Dependencies option for the
module, ensure that the Deploy with module option
is not selected for the adapter.
- If the server is not running, right-click your server in
the Servers view and select Start.
- When the server status changes to Started,
right-click the server and select . Log
on to the administrative console.
- To install the adapter at the node level, click . In the clustered
environment, you must install the adapter in each node separately.
- In the Resource adapters page, click Install
RAR.
- In the Install RAR file page, click Browse and navigate
to the RAR file for your adapter. Deploy the RAR on each node.
The RAR files are typically installed in the following path: IID_installation_directory/ResourceAdapters/adapter_name/adapter.rar
- For deployment at node level, do not select any Scope because
the scope is always Node. Click Next.
- Optional: In the Resource adapters page,
change the name of the adapter and add a description. Click OK.
- Click Save in the Messages box
at the top of the page.
- To install the RAR at the cluster level, click
- In the Resource adapters page, set
the Scope to Cluster,
and then click New.
- Select the RAR deployed at the node level, and then check if
the adapter RAR is now deployed at the cluster level. Deploy the application
after the adapter is deployed at the node level on the individual
nodes, and then at the cluster level.
- From the Deployment Manager Admin Console,
click Install applications to deploy the application.
- In the Admin Console, click to create the activation specification from the adapter
deployed at the cluster level.
- When installing the adapter, in the Name field,
you must enter the same name as defined in the RAR.
- In the JNDI name field, you must
enter the same name as given during the module creation.
- Click to
check if the JNDI reference on the adapter is same as the one specified
for the module.
- Click to set values for the activation
specification in the Admin Console.
- From the Deployment Manager Admin console,
click Install applications to deploy the application
after you deploy the RAR and create the activation specification.
- On the Step 2: Map modules to servers page,
select the module and click Next. The adapter
is not part of the deployed application.
Results
The resource adapter is deployed at the node level, with the
JNDI activation specification reference.