web server - Borland Technical Publications

Deployment Descriptors for the Resource Adapter
Configuring ra-borland.xml
The ra-borland.xml file contains information required for deploying a Resource Adapter
to the Borland Enterprise Server. Certain attributes need to be specified in this file in
order to deploy the RAR file. This functionality is consistent with the equivalent .xml
extensions for EJBs, EARs, WARs, and client components for the Borland Enterprise
Server.
Until Borland-specific deployment properties are provided in the ra.borland.xml file, the
RAR cannot be deployed to the server. The following attributes must be specified first
in ra-borland.xml:
■
■
■
■
■
■
■
■
■
■
Name of the connection factory
Description of the connection factory
JNDI name bound to the connection factory
Reference to a separately deployed connection factory that contains Resource
Adapter components which can then be shared with the current Resource Adapter.
Directory where all shared libraries should be copied
Connection pool properties:
■
■
■
busy-timeout: the number of seconds to wait before a busy connection is
released. The default is 600 seconds
idle-timeout: a pooled connection remaining in an idle state for a period of time
longer than this timeout value should be closed. All idle connections are checked
for expiration every 60 seconds. The value of the idle-timeout is given in
seconds. The default is 600 seconds.
wait-timeout: the number of seconds to wait for a free connection. The default is
30 seconds.
Values for configuration properties defined in a element of the Sun
standard Resource Adapter deployment descriptor
Mapping of security principals for Resource Adapter/EIS sign-on processing. This
mapping identifies resource principals to be used when requesting EIS connections
for applications that use container-managed security and for EIS connections
requested during initial deployment.
A flag to indicate whether logging is required for the ManagedConnectionFactory or
ManagedConnection classes.
The file to store logging information for the two aforementioned classes
Configuring the element in ra-borland.xml
The optional element allows you to associate multiple deployed
Resource Adapters with a single deployed Resource Adapter. This provides for linking
and reusing resources already configured in a base Resource Adapter to another
Resource Adapter, modifying only a subset of attributes. Use of the
element avoids duplication of resources (for example, classes, JARs, images, etc.)
where possible. Any values defined in the base Resource Adapter deployment are
inherited by the linked Resource Adapter unless otherwise specified.
Chapter 27: Using VisiConnect 267