Difference between revisions of "CDO/MongoDB Store"

From Eclipsepedia

< CDO
Jump to: navigation, search
(Installation)
(Installation)
Line 16: Line 16:
 
== Installation ==
 
== Installation ==
  
As the legal review is still pending as of now the CDO MongoDBStore can not be contributed to the CDO SDK. Consequently it is not yet part of the (Indigo) release train. But it is installable from the [http://www.eclipse.org/cdo/downloads/updates.php CDO Downloads] page.
+
The MongoDB driver bundle that is shipped with CDO is '''not identical''' to the one that is originally distributed via [http://www.mongodb.com]. The [http://dev.eclipse.org/svnroot/modeling/org.eclipse.emf.cdo/trunk/plugins/com.mongodb/src/org/bson/io/UTF8Encoding.java UTF-8 conversion class] had to be replaced by a version that uses the JRE mechanism to fulfill the legal requirements of the Eclipse Foundation. Performance degradation or misbehaviour may result. It is highly recommended that you download and deploy the original version of the MongoDB driver via
 
+
[http://www.mongodb.org/display/DOCS/Java+Language+Center].
The MongoDB driver bundle is available at, e.g., [http://net4j.sourceforge.net/update http://net4j.sourceforge.net/update]. Ensure that you either install it '''before'' you try to install the CDO MongoDBStore or at least add this URL to the list of enabled software sites in your p2 preferences. Please also note that currently the MongoDB 2.4 OSGi bundle that is available on MongoDB's own pages has incorrect manifest entries. Please vote for [http://jira.mongodb.org/browse/JAVA-272 http://jira.mongodb.org/browse/JAVA-272].
+
  
 
== cdo-server.xml ==
 
== cdo-server.xml ==

Revision as of 01:42, 6 April 2011

The CDO MongoDB store is an implementation of a CDO Store that allows to store models and meta models to MongoDB databases.

The current implementation supports all CDO 4.0 features with the following exceptions:

  • NoExternalReferences (hence no meta references)
  • NoQueryXRefs (hence no ensureReferentialIntegrity)
  • NoLargeObjects
  • NoFeatureMaps
  • NoHandleRevisions
  • NoRawAccess (hence no offline support)
  • NoBranching
  • NoCrashRecovery

This document will help users setup their environment and configure CDO to work with MongoDB.

Installation

The MongoDB driver bundle that is shipped with CDO is not identical to the one that is originally distributed via [1]. The UTF-8 conversion class had to be replaced by a version that uses the JRE mechanism to fulfill the legal requirements of the Eclipse Foundation. Performance degradation or misbehaviour may result. It is highly recommended that you download and deploy the original version of the MongoDB driver via [2].

cdo-server.xml

The type identifier of the store configuration is "mongodb":

 <store type="mongodb">
   <property name="uri" value="mongodb://localhost"/>
   <property name="db" value="specificDB"/>
   <property name="drop" value="false"/>
 </store>

The "db" property is optional. If omitted, the repository name is used as MongoDB database name.

The "drop" property is optional. If the value is "true" the MongoDB database is dropped before the store is activated.



Wikis: CDO | Net4j | EMF | Eclipse