CDO Source Installation (CVS, deprecated)

(Includes Net4j Source installation)

Introduction

This page explains how to install an Eclipse workspace that is ready to be used to develop and build CDO and Net4j (subsequently subsumed as CDO workspace).

The CDO workspace will be configured with a dedicated JDK, connected with a dedicated target platform to be built against and associated with a dedicated API Baseline to be checked for API compliance against.

As a consequence of the usage of a dedicated target platform you're free to choose any version of Eclipse as your IDE, recent versions preferred. We are using latest I-builds of Eclipse and some tools like Mylyn.

We are using a common development folder C:\develop on the local file system which is the parent folder of the IDE installation/extensions, the workspaces folder and the downloads folder. It looks like:

With this new version of the setup instructions most of the complicated steps like downloading needed prerequisites, unzipping and copying them are automated by an Ant script (which is described in the bootstrap chapter. There are still the deprecated manual CDO Source Installation instructions available for archive purposes.

The following instructions assume that you want to work on the HEAD development stream. You'll have to adjust the bootstrap steps to switch to another stream or version. It is further assumed that you have basic knowledge about JDT and PDE.

Bootstrap

• Create the host workspace folder C:\develop\ws\cdo in the file system
• Start your Eclipse IDE with C:\develop\bin\eclipse\eclipse.exe -data C:\develop\ws\cdo
• Switch to the Plug-in Development perspective
• Import your existing preferences (optional)
• Configure a JDK 1.5 of your choice on the Installed JREs preference page
• Download the bootstrap Team PSF and store it somewhere in your file system (we use C:\develop\ws\cdo)
• Import the downloaded [file://C:\develop\ws\cdo\bootstrap.psf bootstrap Team PSF]:
  
  
  

Target Platform

• In your Eclipse IDE open the Preferences dialog via the Window menu and go to the page Target Platforms
• Enter the new target platform Location C:\develop\ws\cdo\metadata\.target:
  
  
  
• Press the Reload button (just to be sure)
• Finally verify the Plug-ins list and press the Ok button

API Baseline

• In your Eclipse IDE open the Preferences dialog via the Window menu and go to the page API Baselines and press the Add Baseline... button
• Enter the Name and Location information:
  
  
  
• Verify the Plug-ins/bundles list and press the Finish button to return to the Preferences dialog:
  
  
  
• Leave the Preferences dialog by pressing the Ok button

Source Checkout

• Checkout all projects (Net4j and CDO) with one of the maintained Team Project Set files
  • HEAD: pserver.psf or extssh.psf
  • R1_0_maintenance (for which you might need a different target platform!): pserver.psf or extssh.psf

3rd Party Stuff

Download the Hibernate JARs and copy them into the org.eclipse.emf.cdo.server.hibernate.libraries bundle in the workspace. (This step will be handled similarly to the MySQL and Hsqldb driver jars in the near future)

---

Wikis: CDO | Net4j | EMF | Eclipse