10.2. Using Kodo JDO via the Java Connector Architecture
Prev | Chapter 10. Enterprise Integration | Next

## 10.2. Using Kodo JDO via the Java Connector Architecture

### 10.2.1. Overview of the JCA

An introduction to JCA in Javaworld gives a good overview of the Java Connection Architecture:

| The JCA defines a standard set of interfaces that allows connectors to integrate with compliant application servers seamlessly. At the same time, another standard set of interfaces allows clients (or applications hosted by the application server) to use the connectors in a uniform way. Thus with JCA, connectors are portable across application servers, and clients are portable across connectors. |
--Tarak Modi |

### 10.2.2. Deploying on JBoss 3.0

JBoss 3.0 will automatically deploy the `kodo.rar` file (located in this distribution's `JCA/` directory) when it is placed in JBoss' `deploy/` directory. However, you will need to configure the parameters of the Resource Adaptor by creating a `kodo-service.xml` file in the JBoss `deploy/` directory. A template `kodo-service.xml` is provided with this distribution in the `JCA/` directory.

Note that while JBoss versions lower than 3.0 support the JCA, they provide no way to configure the `ManagedConnectionFactoryProperties`, which is the primary means of configuring Kodo as a service in a managed environment. If you want to deploy Kodo to JBoss 2.4.4 or lower, you will need to extract the `ra.xml` from the `kodo.rar` file, change the default values settings to match your configuration, and then repackage the files back into the `kodo.rar` file.

To deploy to JBoss, you must do the following:

- Copy `JCA/kodo.rar` to the `deploy/` directory of your JBoss installation.

- Edit `JCA/kodo-service.xml` to set up the configuration for your environment. In particular, you must set the `LicenseKey` property to your license key, and you will probably need to change the `ConnectionDriverName`, `ConnectionURL`, `ConnectionUserName`, `ConnectionPassword`, and `DictionaryName` properties.

- Copy the updated `JCA/kodo-service.xml` to the `deploy/` directory of your JBoss installation.

Prev | Up | Next
Chapter 10. Enterprise Integration | Home | Chapter 11. Kodo JDO Implementation Notes