An introduction to JCA in Javaworld gives a good overview of the Java Connector 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 | ||
Kodo JDO can be deployed through JCA in any JCA-compliant application server. The next section demonstrates how to deploy Kodo on JBoss.
For information on deploying to other JCA-compliant application servers see Section 4.3, “Installing Kodo JCA” in the J2EE Tutorial.
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 JDO as a service in a managed environment. If you want to deploy Kodo JDO 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 DBDictionaryClass properties.
Copy the updated jca/kodo-service.xml to the deploy directory of your JBoss installation.