Configuring Resource Adapters

The content of this guide is the following:

  1. Target Audience and Content
  2. Principles
  3. Description and Examples

Target Audience and Content

The target audience for this guide is the Resource Adapter deployer. It describes the JOnAS specific deployment file(jonas-ra.xml).

Principles

Resource Adapters are packaged for deployment in a standard Java programming language Archive file called a rar file (Resource ARchive), which is described in the J2EE Connector Architecture specification.

The standard method of creating the jonas-ra.xml file is by using the RAConfig tool, for a complete description see RAConfig.

Description and Examples

The jonas-ra.xml contains JOnAS specific information describing deployment information, logging, pooling, jdbc connections and RAR config property values

Examples

The following portion of a jonas-ra.xml file shows the linking to a base rar file named BaseRar. All properties from the base rar will be inherited and any values given in this jonas-ra.xml will override the other values.

  <jonas-resource>
    <jndiname>rar1</jndiname>
    <rarlink>BaseRar</rarlink>
    <native-lib>nativelib</native-lib>
    <log-enabled>false</log-enabled>
    <log-topic>com.xxx.rar1</log-topic>
    <jonas-config-property>
      <jonas-config-property-name>ip</jonas-config-property-name>
      <jonas-config-property-value>www.xxx.com</jonas-config-property-value>
    </jonas-config-property>
    .
    .
  </jonas-resource>

The following portion of a jonas-ra.xml file shows the configuration of a jdbc rar file.

  <jonas-resource>
    <jndiname>jdbc1</jndiname>
    <rarlink></rarlink>
    <native-lib>nativelib</native-lib>
    <log-enabled>false</log-enabled>
    <log-topic>com.xxx.jdbc1</log-topic>
    <pool-params>
      <pool-init>0</pool-init>
      <pool-min>0</pool-min>
      <pool-max>100</pool-max>
      <pool-max-age>0</pool-max-age>
      <pstmt-max>20</pstmt-max>
    </pool-params>
    <jdbc-conn-params>
      <jdbc_check-level>2</jdbc_check-level>
      <jdbc-test-statement>select 1</jdbc-test-statement>
    </jdbc-conn-params>
    <jonas-config-property>
      <jonas-config-property-name>url</jonas-config-property-name>
      <jonas-config-property-value>jdbc:oracle:thin:@test:1521:DB1</jonas-config-property-value>
    </jonas-config-property>
    .
    .
  </jonas-resource>