Apache OpenJPA 2.0.0-beta Plugin for Apache Geronimo 2.1 Server Copyright 2003-2010 The Apache Software Foundation -------------------------------------------------------------------------------- Notice - -------- When installing this plugin, additional artifacts that this plugin requires may also be installed. Please refer to the NOTICE and LICENSE files included in those artifacts (like the Apache OpenJPA JAR) for additional notices and licenses. Building - ---------- The build requires access to the Geronimo 2.1.3 server artifacts. The most dependable way to build, is to build the server locally first, by checking out from svn at - https://svn.apache.org/repos/asf/geronimo/server/tags/2.1.3/ You will need the same build tools as the 2.1.3 Server, such as: Maven 2.0.9 or later Java SE 6 - Note: Some features in OpenJPA 2.0 require Java SE 6 To build, run: mvn clean install Installing - ------------ The OpenJPA2 plugins can be installed on these levels of the Geronimo Server - 2.1.3, 2.1.4, 2.1.5-SNAPSHOT Note: Installing the OpenJPA2 plugins will replace the existing OpenJPA plugin. Using the Admin Console - 1) Start the server and log into the Admin Console - http://localhost:8080/console/ 2) Navigate to Applications -> Plugins 3) In the Install Plugins portlet, choose the installation Repository - a) If you built the plugin locally - file:/// b) To install from the Geronimo repo at Apache, then use Add Repository - http://geronimo.apache.org/plugins/openjpa2/ 4) Press the "Show Plugins in selected repository" button a) Select the following plugins to install which match your server version - Geronimo Plugins, OpenJPA2 :: CAR Geronimo Plugins, OpenJPA2 :: Deployer b) Press Install c) On the confirmation panel, press Install d) Once the plugins are installed, press Done 5) Start the following modules if they are not running - a) Navigate to Applications -> System Modules b) Verify the following are started and press the "Start" link if not - org.apache.geronimo.configs/persistence-jpa20-deployer//car org.apache.geronimo.configs/openjpa2//car org.apache.geronimo.configs/openejb-deployer//car org.apache.geronimo.configs/openejb//car 6) Restart the Server, so the loaded JPA 1.0 modules can be replaced with the new JPA 2.0 modules. Note: If you need to use the Offline Deployer, then perform the following manual steps first - 1) Edit the following file - var/config/offline-deployer-config.xml 2) Remove the module entry for the old JPA10 deployer Note: If you want to reinstall the same level of the OpenJPA2 plugins, you will need to uninstall the existing OpenJPA2 plugins and then delete the following directories from the server repository before reinstalling - org/apache/geronimo/configs/openjpa2 org/apache/geronimo/configs/persistence-jpa20-deployer org/apache/geronimo/modules/geronimo-openjpa2 org/apache/geronimo/modules/geronimo-persistence-jpa20 org/apache/geronimo/modules/geronimo-persistence-jpa20-builder Uninstalling - -------------- Using the Admin Console - 1) Start the server and log into the Admin Console - http://localhost:8080/console/ 2) Navigate to Applications -> System Modules a) Uninstall the plugins installed above - org.apache.geronimo.configs/persistence-jpa20-deployer/${version}/car org.apache.geronimo.configs/openjpa2/${version}/car b) Reinstall the original OpenJPA plugins by following the Installing steps above, but by selecting the following plugins to install instead - Geronimo Plugins, OpenJPA :: CAR Geronimo Plugins, OpenJPA :: Deployer c) Restart the Server