Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "CDO Source Installation (CVS, deprecated)"

(Target Platform)
(Introduction)
 
(90 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''(Includes Net4j Source installation)'''
+
== Introduction ==
<br>
+
This tutorial describes how to install the CDO workspace using [http://www.eclipse.org/buckminster/ Buckminster]. This deprecated version checks out the workspace projects from CVS. The new '''SVN''' version can be found [[CDO Source Installation|here]].
<br>
+
__TOC__
+
<br>
+
==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 [[#Java Development Kit|JDK]], connected with a dedicated [[#Target Platform|target platform]] to be built against and associated with a dedicated [[#API Baseline|API Baseline]] to be checked for API compliance against.
+
== Prepare the IDE ==
 +
Download and install Eclipse 3.6 from http://download.eclipse.org/eclipse/downloads
  
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 [http://www.eclipse.org/mylyn Mylyn] ([http://www.eclipse.org/buckminster Buckminster] is on the wish list to save you from reading this page).
+
Then open a fresh development workspace.
  
We are using a common development folder <tt>C:\develop</tt> 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:<br>[[Image:DevelopFolder.png]]
+
[[Image:Cdo_install1.png]]
  
<br>
 
==Downloads==
 
Download the following packages to the <tt>C:\develop\downloads</tt> folder:
 
* Latest build of '''Eclipse 3.5''' (for example from [http://download.eclipse.org/eclipse/downloads eclipse project downloads])
 
* Latest build of '''EMF 2.5''' All-In-One SDK (for example from [http://www.eclipse.org/modeling/emf/downloads/index.php?project=emf&showAll=0&showMax=5 EMF Downloads])
 
* Latest build of '''Teneo 1.1''' (for example from [http://www.eclipse.org/modeling/emf/downloads/index.php?project=teneo&showAll=0&showMax=5 Teneo Downloads])
 
* Latest build of '''Orbit''' (for example from [http://download.eclipse.org/tools/orbit/downloads Orbit Downloads])
 
* '''Spring Framework Core 2.5.4''' (for example from [http://www.springsource.com/repository/app/bundle/version/detail?name=org.springframework.core&version=2.5.4.A SpringSource])
 
* '''Spring Framework Beans 2.5.4''' (for example from [http://www.springsource.com/repository/app/bundle/version/detail?name=org.springframework.beans&version=2.5.4.A SpringSource])
 
* '''Spring Framework Context 2.5.4''' (for example from [http://www.springsource.com/repository/app/bundle/version/detail?name=org.springframework.context&version=2.5.4.A SpringSource])
 
* '''MySQL Connector/J 5.1''' (for example from [http://dev.mysql.com/downloads/connector/j/5.1.html MySQL.com])
 
* '''HSQL Database Engine 1.8''' (for example from [http://sourceforge.net/project/showfiles.php?group_id=23316 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:<br>[[Image:DownloadsFolder.png]]
+
Add the following plug-ins from the Helios p2 repository (http://download.eclipse.org/releases/helios)
  
<br>
+
Install the following:
==Workspace==
+
* EMF 2.6 SDK
* Create the host workspace folder <tt>C:\develop\ws\cdo</tt>
+
* Buckminster 3.6 Core
* Start your IDE with <tt>C:\develop\bin\eclipse\eclipse.exe -data C:\develop\ws\cdo</tt>
+
* Buckminster 3.6 CVS Support
 +
* Buckminster 3.6 PDE Support
 +
* GMF 1.4 SDK
  
Eclipse should come up with an empty workspace. The folder <tt>C:\develop\ws\cdo\.metadata</tt> should have been created behind the scenes:<br>[[Image:EmptyWorkspace.png]]
 
  
<br>
+
[[Image:Cdo_install2.png]]
==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:<br>[[Image:InstalledJREs.png]]
+
  
<br>
+
[[Image:Cdo_install3.png]]
  
==Target Platform==
+
'''Hint:''' You may alternatively install from the buckminster update site (the helios update site did not work in my case). Add '''http://download.eclipse.org/tools/buckminster/updates-3.6''' to your update sites and select the required bundles.
* To install the target platform of your CDO workspace create the folder <tt>C:\develop\ws\cdo\metadata\.target</tt> in the file system.
+
* Unzip the Eclipse SDK package from the <tt>downloads</tt> folder to the <tt>.target</tt> folder:<br>[[Image:TargetPlatform.png]]<br><br>
+
* Unzip the Orbit package from the <tt>downloads</tt> folder to the <tt>.target</tt> folder
+
* Unzip the EMF SDK package from the <tt>downloads</tt> folder to the <tt>.target</tt> folder
+
* Unzip the Teneo SDK package from the <tt>downloads</tt> folder to the <tt>.target</tt> folder
+
* Copy the Spring Framework JARs from the <tt>downloads</tt> folder to the <tt>.target\eclipse\plugins</tt> folder
+
* Create a com.mysql.jdbc_5.1.6 bundle within your workspace and export it to the target platform ([[Create and Export MySQL JDBC driver bundle|detailed instructions]])
+
* Follow the same instructions to create and export a org.hsqldb.jdbc_1.8.0.10 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'' <tt>C:\develop\ws\cdo\metadata\.target\eclipse</tt>:<br>[[Image:TargetPlatformPrefs.png]]<br><br>
+
* Press the ''Reload'' button
+
  
<br>
+
Now you have prepared your IDE with the required tools.
  
==API Baseline==
+
== Create the Target Platform ==
  
 +
For the target platfrom first create an empty project called "_target".
  
<br>
+
[[Image:Cdo_install4.png]]
==Source Checkout==
+
  
  
<br>
+
Now create an empty target definition that Buckminster later can fill with the needed plug-ins (Windows->Preferences->Plugin Development->Target Platform)
==3rd Party Stuff==
+
  
  
<br>
+
[[Image:Cdo_install5.png]]
----
+
 
Wikis: [[CDO]] | [[Net4j]] | [[EMF]] | [[Eclipse]]
+
 
 +
Insert the name for the target platform.
 +
 
 +
[[Image:Cdo_install6.png]]
 +
 
 +
 +
 
 +
Click 'Add'.
 +
 
 +
[[Image:Cdo_install7.png]]
 +
 
 +
 
 +
 
 +
Add the directory location ${workspace_loc}/_target.
 +
 
 +
[[Image:Cdo_install8.png]]
 +
 
 +
 
 +
Activate the platform.
 +
 
 +
[[Image:Cdo_install9.png]]
 +
 
 +
== Create the API Baseline ==
 +
 
 +
Now we need to create an API baseline. First, create a new workspace project called "_baseline"
 +
 
 +
[[Image:Cdo_export_targetdef0.png]]
 +
 
 +
* Download a fresh [http://download.eclipse.org/eclipse/downloads/drops/R-3.6-201006080911/index.php Eclipse 3.6], extract and run it.
 +
* Install all features from [http://net4j.sourceforge.net/update/ http://net4j.sourceforge.net/update/].
 +
* Install all features from [http://download.eclipse.org/modeling/emf/cdo/updates/3.0-releases/ http://download.eclipse.org/modeling/emf/cdo/updates/3.0-releases/].
 +
* Copy or move the ''plugins/'' folder from the new Eclipse installation into the ''_baseline'' workspace project.
 +
* Delete the rest of the new Eclipse installation.
 +
 
 +
Now we must add the API baseline. Open the <i>Preferences</i> (Window->Preferences) and open the "API Baselines" page.
 +
 
 +
[[Image:Cdo_export_targetdef3.png]]
 +
 
 +
Click "Add Baseline...". Give it the name ''CDO 3.0 GA Baseline'' and choose the path to your ''_baseline'' project as destination. Then the API baseline is created and set active for your workspace.
 +
 
 +
[[Image:Cdo_export_targetdef4.png]]
 +
 
 +
== Bootstrap the Releng Project ==
 +
 
 +
Now you need to bootstrap the releng project.
 +
 
 +
http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/pserver/_bootstrap.psf?root=Modeling_Project&view=co
 +
 
 +
Committers use:
 +
http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/extssh/_bootstrap.psf?root=Modeling_Project&view=co
 +
 
 +
Right click the Package Explorer and choose Imort->Team Project Set. Select the downloaded _bootstrap.psf
 +
 
 +
[[Image:Cdo_install10.png]]
 +
 
 +
[[Image:Cdo_install11.png]]
 +
 
 +
[[Image:Cdo_install12.png]]
 +
 +
 
 +
 
 +
Note, if you want to work on CDO 3.0 switch the branch with Team|Switch to "R3_0_maintenance" branch (not tag!)
 +
 
 +
== Materialize the Sources and the Target Platform ==
 +
 
 +
To materialize the sources right-click the local.mspec, select Buckminster|Import...
 +
 
 +
[[Image:Cdo_install15.png]]
 +
 
 +
While the following dialog is running go and fetch a coffee, or two, or three...
 +
 
 +
 
 +
[[Image:Cdo_install16.png]]
 +
 
 +
Finally hit the 'Finish' button
 +
 
 +
[[Image:Cdo_install14.png]]
 +
 
 +
== Updating the Workspace ==
 +
 
 +
You can update your development workspace with re-importing the local.mpec as described above. Then the whole workspace and the target platform are updated.
 +
 
 +
Note, that re-importing doesn't update your source from CVS repository.

Latest revision as of 14:56, 18 January 2011

Introduction

This tutorial describes how to install the CDO workspace using Buckminster. This deprecated version checks out the workspace projects from CVS. The new SVN version can be found here.

Prepare the IDE

Download and install Eclipse 3.6 from http://download.eclipse.org/eclipse/downloads

Then open a fresh development workspace.

Cdo install1.png


Add the following plug-ins from the Helios p2 repository (http://download.eclipse.org/releases/helios)

Install the following:

  • EMF 2.6 SDK
  • Buckminster 3.6 Core
  • Buckminster 3.6 CVS Support
  • Buckminster 3.6 PDE Support
  • GMF 1.4 SDK


Cdo install2.png

Cdo install3.png

Hint: You may alternatively install from the buckminster update site (the helios update site did not work in my case). Add http://download.eclipse.org/tools/buckminster/updates-3.6 to your update sites and select the required bundles.

Now you have prepared your IDE with the required tools.

Create the Target Platform

For the target platfrom first create an empty project called "_target".

Cdo install4.png


Now create an empty target definition that Buckminster later can fill with the needed plug-ins (Windows->Preferences->Plugin Development->Target Platform)


Cdo install5.png


Insert the name for the target platform.

Cdo install6.png


Click 'Add'.

Cdo install7.png


Add the directory location ${workspace_loc}/_target.

Cdo install8.png


Activate the platform.

Cdo install9.png

Create the API Baseline

Now we need to create an API baseline. First, create a new workspace project called "_baseline"

Cdo export targetdef0.png

Now we must add the API baseline. Open the Preferences (Window->Preferences) and open the "API Baselines" page.

Cdo export targetdef3.png

Click "Add Baseline...". Give it the name CDO 3.0 GA Baseline and choose the path to your _baseline project as destination. Then the API baseline is created and set active for your workspace.

Cdo export targetdef4.png

Bootstrap the Releng Project

Now you need to bootstrap the releng project.

http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/pserver/_bootstrap.psf?root=Modeling_Project&view=co

Committers use: http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/extssh/_bootstrap.psf?root=Modeling_Project&view=co

Right click the Package Explorer and choose Imort->Team Project Set. Select the downloaded _bootstrap.psf

Cdo install10.png

Cdo install11.png

Cdo install12.png


Note, if you want to work on CDO 3.0 switch the branch with Team|Switch to "R3_0_maintenance" branch (not tag!)

Materialize the Sources and the Target Platform

To materialize the sources right-click the local.mspec, select Buckminster|Import...

Cdo install15.png

While the following dialog is running go and fetch a coffee, or two, or three...


Cdo install16.png

Finally hit the 'Finish' button

Cdo install14.png

Updating the Workspace

You can update your development workspace with re-importing the local.mpec as described above. Then the whole workspace and the target platform are updated.

Note, that re-importing doesn't update your source from CVS repository.

Back to the top