This topic describes how to deploy the five JCA adapters
running on WebSphere Process Server.
Before you begin
You must install these products before you can
install and deploy the adapter:
- WebSphere
Integration Developer V6.0 (WID)
- WebSphere Process Server administrative console
For
installation instructions, refer to <installation doc on the
Diamond web site?>
Note: The WID and the adapter must
be installed on the same machine.
Why and when to perform this task
The adapters can only be installed on machines with Windows
or Linux operating systems. From there they must be deployed to
Unix systems. Each adapter is installed as a RAR (Resource Adapter
Archive) file.
In principle, deploying the adapter is the same
as deploying any other component on the WebSphere Process Server (WPS).
For more information on deploying components on the WPS, see the
documentation for the WebSphere Integration Developer V6.0 (provide
URL).
Steps for this task
- Launch the WebSphere Integration Developer. For
details, refer to the documentation at <URL>.
- Create a project in WID and import the adapter RAR file
into the WID using File>Import. For details, refer to the
instructions in the WID documentation.
- Use the WID to add any external dependencies your adapter
has to the imported project. These are dependencies that the adapter
may have on the SAP/JDBC/Siebel/Flat Files/PeopleSoft applications
(adapter–specific).
- Copy the external dependencies into the
connectorModule in your WID project and add them to the project
as internal libraries. (This is necessary to get the dependencies
into the EAR file, which will later be exported.) For details, refer
to the WID documentation.
- [Each adapter developer will provide adapter-specific
details during adapter UT]
- Run the Enterprise Metadata Discovery (EMD) tool from
the WID. As you complete the process, you will enter all the information
necessary to configure the adapter for the first time. The output
from the EMD tool is saved to a business integration module, which
contains the business object (BO), the import file, the export file
and the WSDL.
- Use the WID to generate reference bindings for the SCA
component that EMD creates. [Suraksha to check and make sure that
the WID documentation describes this, otherwise we must show screens
to illustrate reference binding for the adapters.] For standalone
testing, you must create a standalone reference. This would allow
any external component to trigger operations to the SCA component.
- At this stage you have two choices.
- You can export the project to the WebSphere
Process Server as an Enterprise Application Archive (EAR) file,
using the WebSphere Process Server administration console. Launch
the WebSphere Process Server administration console and simply step
through the screens.
- You can select the project in the WID and deploy it
on a server that has been configured in the WID. Launch the WID
and simply step through the screens.
What to do next
The adapter is now ready for use. After you have deployed
the adapter, you can use the WPS Admin console to make any changes
required to adapter properties. You can also edit the import and
export files in WID and then redeploy the adapter.