Use the following procedures to install EclipseLink for Java SE and EE development. Installation instructions for OSGi development are provided in another section. 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:

+

−

# <tt>JAVA_HOME</tt> - Set <tt>JAVA_HOME</tt> to where you installed your Java SDK home directory. For example:

+

−

#* Windows example: <tt>JAVA_HOME = C:\JDK</tt>

+

−

#* UNIX example: <tt>JAVA_HOME = ...:/usr/java/jdk</tt>

+

−

# <tt>PATH</tt> - Set <tt>PATH</tt> to include <tt>JDK/bin</tt> directory. For example:

+

−

#* Windows example: <tt>PATH = C:\JDK\bin</tt>

+

−

#* UNIX example: <tt>PATH = ...:/usr/java/jdk/bin</tt>

+

−

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

+

−

+

−

+

−

===Installation===

+

−

# Download the EclipseLink install archive zip file from the EclipseLink downloads page [http://www.eclipse.org/eclipselink/downloads 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.

+

−

# Unpack the downloaded zip file in the desired installation directory. When you unzip the file, you’ll find an <tt>eclipselink</tt> subdirectory, with multiple subdirectories. This directory is your new ECLIPSELINK_HOME directory. For example:

# When unzipped, additional steps are required to run EclipseLink Workbench. For more information, see [[Using%20Workbench%20(ELUG)#Configuring the Workbench Environment|Configuring the Workbench Environment]].

+

−

+

−

== Installing EclipseLink OSGi ==

+

−

EclipseLink OSGi bundles are made available both as a zip and, starting in Galileo, as an Eclipse P2 update site.

+

−

+

−

=== Install from Update Site ===

+

−

You can install EclipseLink binary and source bundles into your Eclipse IDE install from either the [http://download.eclipse.org/releases/galileo Galileo update site] (in the EclipseRT Target Platform Components category) or EclipseLink update site (URL tbd).

** If developing in Eclipse with PDE you can place the downloaded bundles into your <ECLIPSE_HOME>\dropins folder. However, if developing with PDE it's recommended to install EclipseLink using the update site approach.

+

−

+

−

=== EclipseLink OSGi Bundles ===

+

−

The following tables list the bundles included with EclipseLink OSGi:<br><br>

+

−

NOTE: The specific names of the bundles will be suffixed with a release and build number. Those numbers will vary depending upon what release you download.

+

−

+

−

'''EclipseLink Core Functionality'''

+

−

{|{{BMTableStyle}}

+

−

|-{{BMTHStyle}}

+

−

! 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.

| 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.

+

−

|}

+

−

<br>

+

−

'''EclipseLink JPA'''

+

−

{|{{BMTableStyle}}

+

−

|-{{BMTHStyle}}

+

−

! Bundle

+

−

! Description

+

−

|-

+

−

| javax.persistence (version 1.99.0)

+

−

| 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

+

−

| 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].