Contents

The configuration of the CDO server with the CDO Hibernate Store consists of 2 parts: 1) a cdo-server.xml configuration file, 2) a launch configuration in Eclipse. The description here assumes that the CDO server will be started from Eclipse.

Example Project

This document discusses the setup and configuration of the CDO server. This page assumes that required plugins have been downloaded and installed and that they are correctly loaded/installed after restarting Eclipse.

This page uses the org.eclipse.emf.cdo.examples.hibernate.server project as an example. This development project can be downloaded from here:

There are 2 relevant (for configuration) files in this example project:

the config/cdo-server.xml (CDO as a default uses the cdo-server.xml in the config directory)

the CDOHibernateServer.launch file

You can start the CDO Server directly by right-clicking the CDHibernateServer.launch and then select: Run As > CDOHibernateServer.launch. The configuration file is discussed in some more detail.

Configuration file

An example configuration file is shown below. It consists of different sections:
acceptor definition: defines the communication protocol and port
repository: contains CDO properties, Teneo properties and Hibernate properties
store: within the repository tag a store is defined (type="hibernate") and a mapping provider is specified (teneo)

Here is the full listing:

<?xmlversion="1.0"encoding="UTF-8"?><cdoServer><!-- <acceptor type="http"/> --><acceptortype="tcp"listenAddr="0.0.0.0"port="2036"><!-- <negotiator type="challenge" description="/temp/users.db"/> --></acceptor><repositoryname="repo1"><propertyname="overrideUUID"value=""/><propertyname="supportingAudits"value="false"/><propertyname="verifyingRevisions"value="false"/><propertyname="currentLRUCapacity"value="10000"/><propertyname="revisedLRUCapacity"value="10000"/><!-- NOTE: the following properties are currently defined on repository level. In future builds of the CDO Hibernate store these properties are defined within the store and mappingProvider tags. --><!-- Teneo options: see: http://www.elver.org/hibernate/options.html or the org.eclipse.emf.teneo.PersistenceOptions class --><!-- The following value must be set normally like this, use this in your app also --><propertyname="teneo.mapping.cascade_policy_on_non_containment"value="PERSIST,MERGE"/><!-- some demo settings --><!-- using an external xml file for annotations, note this xml file is located in the org.eclipse.emf.cdo.examples.hibernate.annotations which is available on the cdo server by adding it to the CDOHibernateServer.launch configuration --><propertyname="teneo.mapping.persistence_xml"value="/META-INF/company_model_teneo_annotations.xml"/><!-- create tables for each subclass with joining to the parent table --><propertyname="teneo.mapping.inheritance"value="JOINED"/><!-- create an index for each fk --><propertyname="teneo.mapping.add_index_for_fk"value="true"/><!-- Hibernate properties , see: http://docs.jboss.org/hibernate/stable/core/reference/en/html_single/#configuration-optional --><propertyname="hibernate.hbm2ddl.auto"value="update"/><propertyname="hibernate.show_sql"value="false"/><propertyname="hibernate.connection.pool_size"value="10"/><propertyname="hibernate.cache.provider_class"value="org.hibernate.cache.HashtableCacheProvider"/><!-- Setting for hsqldb --><propertyname="hibernate.dialect"value="org.hibernate.dialect.HSQLDialect"/><propertyname="hibernate.connection.driver_class"value="org.hsqldb.jdbcDriver"/><propertyname="hibernate.connection.url"value="jdbc:hsqldb:mem:cdohibernate"/><propertyname="hibernate.connection.username"value="sa"/><propertyname="hibernate.connection.password"value=""/><propertyname="hibernate.connection.autocommit"value="true"/><!-- Setting for mysql <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLInnoDBDialect"/> <property name="hibernate.connection.driver_class" value="com.mysql.jdbc.Driver"/> <property name="hibernate.connection.url" value="jdbc:mysql://localhost:3306/cdohibernate"/> <property name="hibernate.connection.username" value="root"/> <property name="hibernate.connection.password" value="root"/> --><storetype="hibernate"><mappingProvidertype="teneo"></mappingProvider></store></repository></cdoServer>

This file is present in the config folder of the org.eclipse.emf.cdo.examples.hibernate.server project.

Note: as is noted in the config file, the location of the Teneo and Hibernate properties will change in future builds (with backward compatibility support). In the future the Teneo properties are placed within the mappingProvider tag and the Hibernate properties directly within the store tag.

Each of the different property sections is discussed in more detail.

Teneo Properties

Teneo supports many (40+) global properties to control the mapping logic itself, database artifact naming and entity naming. All the options are described in the [[Teneo/Hibernate/Configuration_Options|Teneo options] page.

The options are also described in the PersistenceOptions class. By installing the Teneo SDK, see the download and install section you will have the source code available in Eclipse. Check this class for textual representation of the options (which prefix to use).

One option: teneo.mapping.cascade_policy_on_non_containment, needs to be set to: PERSIST,MERGE. This is already done in the cdo-server.xml (and the example above).

Hibernate options

There are many hibernate options. The most important ones (to connect to the database) are shown above, there are however many more. Check out the documentation here.

Additional Hibernate or other Config files

There are cases where it is required to add additional Hibernate or EHCache or other configuration files to the CDO server. These files should be made visible to the hibernate plugin on the server.
To accomplish this the following has to be done:

place the files in a separate plugin

let this plugin depend on the org.eclipse.emf.cdo.server.hibernate plugin and possibly also on the hibernate plugin (select the correct hibernate plugin with version 3.3.2 or higher)

add this to the MANIFEST.MF of your project (this ensures that the hibernate store can see your files):

Eclipse-RegisterBuddy: org.eclipse.emf.cdo.server.hibernate

make sure that the configuration files are copied to the output folder, they should be listed in the build.properties in the bin.include/binary. In the examples project the files are placed in the META-INF directory which works fine.

export (in the MANIFEST.MF) the location containing the configuration file (not need if you place the files in META-INF).

The example project: org.eclipse.emf.cdo.examples.hibernate.server (see below) is configured to be visible in the CDO Server.

Database

The config file shown above (and in the examples project) defines that hsqldb should be used. This can easily be changed to another database. Make sure that the driver for the other database is available as a plugin.

Also note that Hibernate will not create a database, so if the store is used with another database server then the database needs to be created manually. The tables don't need to be created, this part is done by Hibernate.

Run Launch Config

The examples project contains an example CDOHibernateServer.launch configuration. To run it right click on it and then select: Run As > CDOHibernateServer.

The CDO launch config has a few special settings:

on the first page of the launch config the 'Program to run' should be set to: an application with selected the org.eclipse.emf.cdo.server.app.

on the second page the path to the config file is defined, make sure that it is set like this (see the selected text in the arguments):

The config file path points to the org.eclipse.emf.cdo.examples.hibernate.server/config, the cdo-server.xml is automatically found by CDO.

on the third page, for convenience the plugins are not selected individually but all plugins are selected.

If you want a more specific selection then you need to manually select the correct plugins. For the CDO runtime at least the following plugins need to be selected in the launch config:

org.eclipse.emf.cdo

org.eclipse.emf.cdo.common

org.eclipse.emf.cdo.examples.hibernate.server

org.eclipse.emf.cdo.server

org.eclipse.emf.cdo.server.hibernate

org.eclipse.emf.cdo.server.hibernate.teneo

org.eclipse.emf.cdo.server.net4j

org.eclipse.emf.cdo.net4j

org.eclipse.emf.cdo.net4j.tcp

org.eclipse.emf.cdo.net4j.util

In addition there are common platgorm plugins which need to be selected.