Difference between revisions of "EclipseLink/Installing and Configuring EclipseLink"

From Eclipsepedia

Jump to: navigation, search
m (clarified difference installations)
m (EclipseLink OSGi Bundles)
Line 44: Line 44:
 
! Description
 
! Description
 
|-  
 
|-  
| org.eclipse.persistence.core_1.0.jar
+
| org.eclipse.persistence.core
 
| This bundle provides EclipseLink's core library.  All other EclipseLink bundles (JPA, MOXy, SDO) are dependent on this bundle.  
 
| This bundle provides EclipseLink's core library.  All other EclipseLink bundles (JPA, MOXy, SDO) are dependent on this bundle.  
 
|-  
 
|-  
| org.eclipse.persistence.asm_1.0.jar
+
| org.eclipse.persistence.asm
 
| This bundle provides EclipseLink's version of the ASM library used for byte-code weaving in the core, JPA, SDO and MOXy bundles.  It is required when using any of those bundles.
 
| This bundle provides EclipseLink's version of the ASM library used for byte-code weaving in the core, JPA, SDO and MOXy bundles.  It is required when using any of those bundles.
 
|-  
 
|-  
| org.eclipse.persistence.antlr_1.0.jar
+
| org.eclipse.persistence.antlr
 
| This bundle provides EclipseLink's version of the ANTLR library used for JPQL parsing in the JPA and core bundles. It is required when using JPA.
 
| This bundle provides EclipseLink's version of the ANTLR library used for JPQL parsing in the JPA and core bundles. It is required when using JPA.
 
|-  
 
|-  
| org.apache.ant_1.7.0.jar
+
| org.eclipse.persistence.oracle
| This bundle provides ant functionality.
+
|-
+
| org.eclipse.persistence.oracle_1.0.jar
+
 
| This bundle provides support for extended Oracle database features (Timestamp extensions, Spatial types, Oracle XML Parser, XDB, Advanced Queueing, XDK, Oracle LOBs).
 
| This bundle provides support for extended Oracle database features (Timestamp extensions, Spatial types, Oracle XML Parser, XDB, Advanced Queueing, XDK, Oracle LOBs).
 
|-  
 
|-  
| javax.activation_1.1.0.jar <br>javax.jms_1.1.0.jar <br>javax.mail_1.4.0.jar <br>javax.resource_1.5.0.jar <br>javax.transaction_1.1.0.jar <br>javax.xml.rpc_1.1.0.v200706111329.zip <br>javax.xml.soap_1.3.0.jar <br>javax.xml.stream_1.0.0.jar
+
| javax.activation <br>
 +
javax.jms <br>
 +
javax.mail <br>
 +
javax.resource <br>
 +
javax.servlet <br>
 +
javax.transaction <br>
 +
javax.xml.rpc <br>
 +
javax.xml.soap <br>
 +
javax.xml.stream <br>  
 +
javax.xml.ws
 
| These bundles contain classes from Java specification. They have been converted to bundle format so they can be used in OSGi. Depending on the OSGi environment whether the running OSGi Environment EclipseLink contains those versions of the libraries listed, these bundles may or may not be necessary.
 
| These bundles contain classes from Java specification. They have been converted to bundle format so they can be used in OSGi. Depending on the OSGi environment whether the running OSGi Environment EclipseLink contains those versions of the libraries listed, these bundles may or may not be necessary.
 
|}
 
|}
Line 69: Line 75:
 
! Description
 
! Description
 
|-  
 
|-  
| javax.persistence_1.0.0.jar
+
| javax.persistence (version 1.99.0)
| This bundle provides JPA 1.0 version of the <tt>javax.persistence</tt> and <tt>javax.persistence.spi</tt> classes.  It allows compile dependencies to be solved, but does not allow JPA to be used as an OSGi service. You must not select this jar file for performing OSGi-based JPA.
+
|-
+
| javax.persistence_1.99.0.jar
+
 
| This bundle contains versions of the <tt>javax.persistence</tt> and <tt>javax.persistence.spi </tt> classes that have been updated to be OSGi friendly. OSGi users must use this bundle for performing OSGi-based JPA.
 
| This bundle contains versions of the <tt>javax.persistence</tt> and <tt>javax.persistence.spi </tt> classes that have been updated to be OSGi friendly. OSGi users must use this bundle for performing OSGi-based JPA.
 
|-  
 
|-  
| org.eclipse.persistence.jpa_1.0.jar
+
| org.eclipse.persistence.jpa
| This bundle supports JPA 1.0 functionality along with Extended JPA support using EclipseLink's annotations, PU properties, and query hints. The bundle also supports partial and complete EclipseLink-ORM.XML extensions of JPA.
+
| This bundle supports JPA functionality along with Extended JPA support using EclipseLink's annotations, PU properties, and query hints. The bundle also supports partial and complete EclipseLink-ORM.XML extensions of JPA.
 +
|-
 +
|org.eclipse.persistence.jpa.equinox<br>
 +
org.eclipse.persistence.jpa.equinox.weaving
 +
| These bundles implement byte code weaving support when running on [http://www.eclipse.org/equinox Equinox].
 +
|
 
|}
 
|}
 
<br>
 
<br>
Line 85: Line 93:
 
! Description
 
! Description
 
|-  
 
|-  
| org.eclipse.persistence.moxy_1.0.jar
+
| org.eclipse.persistence.moxy
 
| This bundle supports JAXB 2.0 using annotations and XML mapping file.
 
| This bundle supports JAXB 2.0 using annotations and XML mapping file.
 
|-  
 
|-  
| javax.xml.bind_2.0.0.jar
+
| javax.xml.bind
 
| This bundle contains the specification classes and interfaces augmented with support for discovering JAXB provider services.
 
| This bundle contains the specification classes and interfaces augmented with support for discovering JAXB provider services.
 
|}
 
|}
Line 98: Line 106:
 
! Description
 
! Description
 
|-  
 
|-  
| org.eclipse.persistence.sdo_1.0.jar
+
| org.eclipse.persistence.sdo
 
| This bundle supports Eclipse persistence SDO 2.1 classes.
 
| This bundle supports Eclipse persistence SDO 2.1 classes.
 
|-  
 
|-  
| commonj.sdo_2.1.0.jar
+
| commonj.sdo
 
| This bundle provides common SDO 2.1 classes.
 
| This bundle provides common SDO 2.1 classes.
 
|}
 
|}

Revision as of 13:16, 25 May 2009

Contents

Installing and Configuring EclipseLink

This document include the installation and configuration instructions for:


Installing EclipseLink

Use the following procedures to install EclipseLink. Before you proceed with the install, it is recommended that you must back up all existing project data.

Setting System Environment Variables

You must set the following system environment variables before installing EclipseLink:

  1. JAVA_HOME - Set JAVA_HOME to where you installed your Java SDK home directory. For example:
    • Windows example: JAVA_HOME = C:\JDK
    • UNIX example: JAVA_HOME = ...:/usr/java/jdk
  2. PATH - Set PATH to include JDK/bin directory. For example:
    • Windows example: PATH = C:\JDK\bin
    • UNIX example: PATH = ...:/usr/java/jdk/bin

Note: Ensure that a Java Virtual Machine (JVM) compatible with JDK 1.5 (or higher) is also installed on your machine


Installation

  1. Download the EclipseLink install archive zip file from the EclipseLink downloads page here. The zip file also includes EclipseLink Workbench, a graphical interface that allows you to configure descriptors and map your projects. It is a powerful tool if you are migrating from Oracle TopLink with classic or native ORM/OXM/EIS usage.
  2. Unpack the downloaded zip file in the desired installation directory. When you unzip the file, you’ll find an eclipselink subdirectory, with multiple subdirectories. This directory is your new ECLIPSELINK_HOME directory. For example:
    • Windows example: ECLIPSELINK_HOME = <INSTALL_DIR>/eclipselink
    • UNIX example: ECLIPSELINK_HOME = ...:/usr/el/<INSTALL_DIR>/eclipselink
  3. When unzipped, additional steps are required to run EclipseLink Workbench. For more information, see Configuring the Workbench Environment.


Installing EclipseLink OSGi

Use the following procedures to install EclipseLink OSGi plugins. Before you proceed with the install, it is recommended that you must back up all existing project data.

  1. Download the EclipseLink OSGi plugins archive zip from the EclipseLink downloads page here.
  2. Unpack the downloaded zip file in the desired installation directory. When you unzip the file, you’ll find a plugins subdirectory, with multiple jar files. These jar files are OSGi bundles required to run EclipseLink in OSGi.

EclipseLink OSGi Bundles

The following tables list the bundles included with EclipseLink OSGi:

NOTE: EclipseLink 1.0.1 ships with similar bundles but the version numbers on the org.eclipse.persistence.* bundles are 1.0.1 instead of 1.0.

EclipseLink Core Functionality

Bundle Description
org.eclipse.persistence.core This bundle provides EclipseLink's core library. All other EclipseLink bundles (JPA, MOXy, SDO) are dependent on this bundle.
org.eclipse.persistence.asm This bundle provides EclipseLink's version of the ASM library used for byte-code weaving in the core, JPA, SDO and MOXy bundles. It is required when using any of those bundles.
org.eclipse.persistence.antlr This bundle provides EclipseLink's version of the ANTLR library used for JPQL parsing in the JPA and core bundles. It is required when using JPA.
org.eclipse.persistence.oracle This bundle provides support for extended Oracle database features (Timestamp extensions, Spatial types, Oracle XML Parser, XDB, Advanced Queueing, XDK, Oracle LOBs).
javax.activation

javax.jms
javax.mail
javax.resource
javax.servlet
javax.transaction
javax.xml.rpc
javax.xml.soap
javax.xml.stream
javax.xml.ws

These bundles contain classes from Java specification. They have been converted to bundle format so they can be used in OSGi. Depending on the OSGi environment whether the running OSGi Environment EclipseLink contains those versions of the libraries listed, these bundles may or may not be necessary.


EclipseLink JPA

Bundle Description
javax.persistence (version 1.99.0) This bundle contains versions of the javax.persistence and javax.persistence.spi classes that have been updated to be OSGi friendly. OSGi users must use this bundle for performing OSGi-based JPA.
org.eclipse.persistence.jpa This bundle supports JPA functionality along with Extended JPA support using EclipseLink's annotations, PU properties, and query hints. The bundle also supports partial and complete EclipseLink-ORM.XML extensions of JPA.
org.eclipse.persistence.jpa.equinox

org.eclipse.persistence.jpa.equinox.weaving

These bundles implement byte code weaving support when running on Equinox.


EclipseLink Moxy

Bundle Description
org.eclipse.persistence.moxy This bundle supports JAXB 2.0 using annotations and XML mapping file.
javax.xml.bind This bundle contains the specification classes and interfaces augmented with support for discovering JAXB provider services.


EclipseLink SDO

Bundle Description
org.eclipse.persistence.sdo This bundle supports Eclipse persistence SDO 2.1 classes.
commonj.sdo This bundle provides common SDO 2.1 classes.