Geronimo Plugins: Extensions for the Apache Geronimo Application Server

Application-Managed JPA for Geronimo 1.1 Web Apps

This plugin adds support for Application-Managed JPA to Geronimo 1.1.x. It currently supports Web Applications, which may include a JPA persistence.xml file (e.g. at WEB-INF/classes/META-INF/persistence.xml believe it or not, or in a JAR file in WEB-INF/lib) and JPA entity classes. When the web application is deployed, the JPA EntityManagerFactory is available in JNDI, at java:comp/env/jpa/(Persistence Unit Name)

In order for the JPA system to connect to a database, you should set up a database connection pool in Geronimo, which should be used only by the JPA provider (not used separately from application code). The name of this pool should be entered as a non-jta-data-source in the persistence.xml file. Additionally, the transaction-type should always be set to RESOURCE_LOCAL in the persistence.xml.

Finally, note that you must install at least one JPA provider plugin in addition to this plugin. If no JPA providers are installed then no JPA applications can be deployed.

Last updated on 10/11/2006

Oracle XA Driver for Console

This plugin adds an Oracle XA driver option to the database pools configuration screen in the console. This means that when creating a new database pool, you can select and configure the Oracle XA driver. NOTE: you must install the standard Oracle JDBC driver into the Geronimo repository before you can create an Oracle database pool, and you'll have to select that driver JAR during the database pool configuration process.

This plugin uses the TranQL Oracle XA integration. For more information, see http://tranql.codehaus.org/

Last updated on 10/11/2006

TopLink JPA Provider for Geronimo

This plugin makes TopLink available as a JPA provider for the accompanying "Application-Managed JPA for Geronimo 1.1 Web Apps" plugin. Once this plugin is installed, you can deploy web applications using the TopLink JPA provider by specifying a provider of oracle.toplink.essentials.ejb.cmp3.EntityManagerFactoryProvider in your persistence.xml file.

Note that in order to install this plugin, you must have previously installed the TopLink JAR into Geronimo -- see the procedure in the prerequisite section for this plugin.

Last updated on 10/11/2006