You set up WebSphere® Adapters, Version 6, using WebSphere Integration
Developer and then deploy adapter EAR files to WebSphere Process Server for MultiPlatforms.
Here is a high-level overview; for detailed adapter- and application-specific
procedures, see a WebSphere Adapter user guide.
Before you begin
Setting up a Websphere Adapter refers to the series of tasks you
perform prior to deploying it. These tasks include opening a connector project
in WebSphere Integration
Developer, creating adapter dependencies, and generating adapter artifacts.
The result of setting up an adapter is an EAR file. Deploying the adapter
refers to exporting the EAR file to a server that will run an instance of
the adapter.
Before you can set up and deploy the WebSphere Adapter,
you must install these products:
- A resource adapter archive (RAR) file for the WebSphere Adapter. You can install a WebSphere Adapter, Version 6.0, on
machines with Windows® or Linux® operating systems. (From there you
can transfer the WebSphere Adapter RAR file to a workstation where WebSphere Integration
Developer is installed.)
- WebSphere Integration
Developer V. 6
- WebSphere Process
Server
For WebSphere Integration Developer and WebSphere Process Server
installation instructions, refer to the following:
Why and when to perform this task
After successfully installing the RAR file for the WebSphere Adapter,
you are ready to import it into a WebSphere Integration Developer project
for set up prior to deploying it. The procedure presented here is intended
to describe set up and deployment steps for all WebSphere Adapters at
a high level. Your WebSphere Adapter may require additional steps.
For adapter-specific set up deployment instructions, see the user guide for
your WebSphere Adapter.
Steps for this task
- Launch the WebSphere Integration Developer. For details, refer
to the documentation at http://www.ibm.com/software/integration/wid/infocenter .
- Create a connector project in WebSphere Integration Developer (J2E
Perspective) and import the WebSphere Adapter RAR file using .
For details, refer to the instructions in the WebSphere Integration Developer documentation.
- Use WebSphere Integration
Developer to add any external dependencies your adapter has to the imported
project.
These are dependencies that the WebSphere Adapter may have on the
(adapter-specific) application that you are connecting to. Your WebSphere Adapter
user guide describes these dependencies, if any, and how to add them.
- Copy the external dependencies into the connectorModule in your WebSphere Integration
Developer project and add them to the project as internal libraries.
This is necessary to bundle the dependencies into the enterprise
application archive (EAR)
file, which will be exported. For details, refer to WebSphere Integration Developer documentation.
- Refer to the user guide for your WebSphere Adapter for additional and
specific steps.
- Run the enterprise metadata discovery tool
from WebSphere Integration
Developer in the Business Integration Perspective.
This will
generate business integration components that will be exported into the EAR
file. As you complete the process, you enter all the information necessary
to set up the adapter for the first time. The output from the enterprise metadata
discovery component is saved to a business integration module, which contains
the business object, the import file, the export file and more.
- Use WebSphere Integration
Developer to generate reference bindings for the component that the enterprise
service discovery wizard
creates.
For standalone testing, you must create a standalone
reference. This would allow any external component to trigger operations to
the component.
- Deploy the WebSphere Adapter EAR file:
- Export the project
to WebSphere Process
Server as an EAR file using the WebSphere Process Server administration
console.
Launch WebSphere Integration Developer, start
a server from WebSphere Integration
Developer, and step through the screens.
- Select the project in WebSphere Integration Developer and
deploy it to a server that has been configured in WebSphere Integration Developer.
Launch WebSphere Integration
Developer and step through the screens.
What to do next
After you have set up and deployed the adapter, you use WebSphere Process
Server administrative console to make any changes required to adapter properties. You
can also edit the import and export files in WebSphere Integration Developer and
then redeploy the adapter.