WebSphere Application Server uses the classes and other code that
comprise a Resource Adapter Archive (RAR) file to support the resource adapters
that you configure.
Before you begin
A RAR file, which is often called a J2EE Connector Architecture (JCA)
connector, must comply with the JCA Specification. Meet these requirements
by using a supported assembly tool (as described in the
Assembly tools
article)
to assemble a collection of Java archive (JAR) files, other runnable components,
utility classes, and so on, into a deployable RAR file. Then you are ready
to install your RAR file in Application Server.
About this task
A RAR file provides the classes and other code to support a resource
adapter for access to a specific enterprise information system (EIS), such
as the Customer Information Control System (CICS). Hence you configure resource
adapters for an EIS only after you install the appropriate RAR file.
Procedure
- Click Resources.
- Click Resource Adapters.
- Click Install RAR. The Install RAR button opens
a dialog for both installing a RAR file and configuring an associated resource
adapter. Only click New if you want to configure a new resource adapter
for a previously installed RAR file.
Important: When installing
a RAR file using this dialog, the scope you define on the Resource Adapters
page has no effect on where the RAR file is installed. You can install RAR
files only at the node level, which you specify on the Install RAR
page.
- Browse to find the appropriate RAR file.
- If your RAR file is located on your local workstation, select Local
path and browse to find the file.
- If your RAR file is located on your server, select Server path and
specify the fully qualified path to the file.
- Click Next.
- Enter the resource adapter name and any other properties needed
under General Properties. If
you install a JCA resource adapter that includes Native path elements,
consider the following: If you have more than one native path element, and
one of the native libraries (native library A) is dependent on another library
(native library B), then you must copy native library B to a system directory.
On some Windows systems and supported UNIX systems, an attempt
to load a native library does not look in the current directory.
- Click OK.