CDO Source Installation (deprecated)
(Includes Net4j Source installation)
Go to the new version of this document which describes a much more automated mechanism to install a CDO workspace!
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 (Buckminster is on the wish list to save you from reading this page).
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:
Download the following packages to the C:\develop\downloads folder:
- Latest build of Eclipse 3.5 (for example from eclipse project downloads)
- Latest build of EMF 2.5 All-In-One SDK (for example from EMF Downloads)
- Latest build of Teneo 1.1 (for example from Teneo Downloads)
- Latest build of Orbit (for example from Orbit Downloads)
- Spring Framework Core 2.5.4 (for example from SpringSource)
- Spring Framework Beans 2.5.4 (for example from SpringSource)
- Spring Framework Context 2.5.4 (for example from SpringSource)
- MySQL Connector/J 5.1 (for example from MySQL.com)
- HSQL Database Engine 1.8 (for example from SourceForge.net)
As of writing this (shortly after Ganymede release) most of the Eclipse packages do not have the mentioned latest builds available. In such cases you can temporarily revert to the respective Ganymede release builds:
- Create the host workspace folder C:\develop\ws\cdo
- Start your IDE with C:\develop\bin\eclipse\eclipse.exe -data C:\develop\ws\cdo
Eclipse should come up with an empty workspace. The folder C:\develop\ws\cdo\.metadata should have been created behind the scenes:
Java Development Kit
- Open the Preferences dialog via the Window menu and go to the page Installed JREs
- Install a JDK 1.5 of your choice:
- To install the target platform of your CDO workspace create the folder C:\develop\ws\cdo\.metadata\.target in the file system.
- Unzip the Eclipse SDK package from the downloads folder to the .target folder:
- Unzip the Orbit package from the downloads folder to the .target folder
- Unzip the EMF SDK package from the downloads folder to the .target folder
- Unzip the Teneo SDK package from the downloads folder to the .target folder
- Copy the Spring Framework JARs from the downloads folder to the .target\eclipse\plugins folder
- Create a com.mysql.jdbc_5.1.6 bundle within your workspace and export it to the target platform (detailed instructions)
- Follow the same instructions to create and export an org.hsqldb.jdbc_126.96.36.199 bundle.
- 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\eclipse:
- Press the Reload button (just to be sure)
- Finally verify the Plug-ins list and press the Ok button
- Unzip the Net4j 1.0.0 SDK package from the downloads folder to the .metadata folder
- Unzip the CDO 1.0.0 SDK package from the downloads folder to the .metadata folder
- Rename the resulting folder C:\develop\ws\cdo\.metadata\eclipse to C:\develop\ws\cdo\.metadata\.baseline in the file system.
- 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
- 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)