Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Teneo/Hibernate/Download and Install"
(→Download and install using the update manager (for usage in Eclipse/OSGI)) |
(→Download and Install Teneo for usage within a Web Container) |
||
Line 54: | Line 54: | ||
== Download and Install Teneo for usage within a Web Container == | == Download and Install Teneo for usage within a Web Container == | ||
− | For usage within a web container it is | + | For usage within a web container the following jar files are required. You can find these files in the download zips (within the eclipse/plugins directory of the zip file) or in the plugins folder of your eclipse installation, after installing through the update files: |
+ | |||
+ | * EMF jar files: | ||
+ | ** org.eclipse.emf.ecore | ||
+ | ** org.eclipse.emf.common | ||
+ | ** org.eclipse.emf.ecore.xmi | ||
+ | |||
+ | * Teneo jar files: | ||
+ | ** org.eclipse.emf.teneo | ||
+ | ** org.eclipse.emf.teneo.annotations | ||
+ | ** org.eclipse.emf.teneo.hibernate: this plugin is probably installed as a folder in Eclipse, you can create a jar file by zipping this folder and changing the extension to .jar. Note this plugin contains a jar file org.eclipse.emf.teneo.hibernate.extra.jar which needs to be placed/copied outside of the plugin into the classpath (see the next bullet). | ||
+ | ** org.eclipse.emf.teneo.hibernate.extra.jar: this jar file is present in the ** org.eclipse.emf.teneo.hibernate plugin, it should be copied from there to your classpath | ||
+ | ** org.eclipse.emf.teneo.hibernate.mapper | ||
+ | |||
+ | * Dependencies: it is probably best to download [http://www.hibernate.org hibernate], [http://commons.apache.org/logging/ commons-logging] and a jdbc driver directly. You can however also find these jar files in the eclipse/plugins directory after installing through the update manager. | ||
+ | |||
+ | For a web container these jar files should be placed in the WEB-INF/lib directory of your web application. | ||
== Download and Install Example Projects for Tutorials == | == Download and Install Example Projects for Tutorials == |
Revision as of 06:43, 23 January 2010
Contents
The installation method for Teneo depends on the target environment(Eclipse/OSGI or web container). Both cases are discussed on this page. This page also describes where to find the example projects used in the tutorials in the wiki.
Teneo is build and tested on Eclipse 3.5 (Teneo 1.1.*) and Eclipse 3.6 (Teneo 1.2.*). This page assumes that you have a running Eclipse 3.5/3.6 available.
Dependencies
To run Teneo you need the following software:
- EMF 2.5 (Teneo 1.1.*) or 2.6 (Teneo 1.2.*)
- Hibernate 3.3.2 and its dependencies
- Apache commons logging
- JDBC driver
Some dependencies can not be downloaded from eclipse.org because of licensing differences. Teneo provides an update site with the required dependencies: http://www.elver.org/eclipse/update.
Download and install using the update manager (for usage in Eclipse/OSGI)
To download and install Teneo and its dependencies, use the following update sites:
- EMF 2.5: http://download.eclipse.org/modeling/emf/updates/releases/ (this site also lists Teneo builds, but is better to use a recent maintenance build, see the interim site below)
- EMF 2.6: http://download.eclipse.org/modeling/emf/updates/interim/
- Teneo (1.1.2 and 1.2.*): http://download.eclipse.org/modeling/emf/updates/interim/
- Hibernate and other dependencies: http://www.elver.org/eclipse/update
It is best to combine EMF 2.5 with a Teneo 1.1.2 maintenance build.
The EMF update site, select the EMF/XSD SDK:
The Teneo update site will look similar to this image. Select the Teneo Hibernate SDK, for EMF 2.6 select the 1.2.* versions):
The elver update site lists the Hibernate, dom4j and a number of JDBC plugins (select them all):
Creating your own Hibernate plugin
The Teneo dependencies can be downloaded from the Teneo dependency update site (http://www.elver.org/eclipse/update). However, if you want to make your own Hibernate/library plugin there is one specific setting which needs to be set in your plugin. Make sure to add the following line to the MANIFEST.MF of the Hibernate/libraries plugin you create:
Eclipse-BuddyPolicy: dependent
This is required otherwise the Hibernate libraries can not find your model classes when performing runtime class enhancement. See here for more information. Note that also other Eclipse-BuddyPolicy settings can be used (and can make sense in production environments) but the 'dependent' setting is the safest one.
Download directly
Teneo can be downloaded directly from this page. Note that it is always better to use a maintenance build, also for maintenance builds all the test cases pass. Maintenance builds are listed a bit lower on the download page.
Download and Install Teneo for usage within a Web Container
For usage within a web container the following jar files are required. You can find these files in the download zips (within the eclipse/plugins directory of the zip file) or in the plugins folder of your eclipse installation, after installing through the update files:
- EMF jar files:
- org.eclipse.emf.ecore
- org.eclipse.emf.common
- org.eclipse.emf.ecore.xmi
- Teneo jar files:
- org.eclipse.emf.teneo
- org.eclipse.emf.teneo.annotations
- org.eclipse.emf.teneo.hibernate: this plugin is probably installed as a folder in Eclipse, you can create a jar file by zipping this folder and changing the extension to .jar. Note this plugin contains a jar file org.eclipse.emf.teneo.hibernate.extra.jar which needs to be placed/copied outside of the plugin into the classpath (see the next bullet).
- org.eclipse.emf.teneo.hibernate.extra.jar: this jar file is present in the ** org.eclipse.emf.teneo.hibernate plugin, it should be copied from there to your classpath
- org.eclipse.emf.teneo.hibernate.mapper
- Dependencies: it is probably best to download hibernate, commons-logging and a jdbc driver directly. You can however also find these jar files in the eclipse/plugins directory after installing through the update manager.
For a web container these jar files should be placed in the WEB-INF/lib directory of your web application.