Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be 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"

(63 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Introduction ==
+
To provision the same development environment that the CDO developers use follow these simple steps:
This tutorial describes how to install the CDO workspace using [http://www.eclipse.org/buckminster/ Buckminster]. This new version checks out the workspace projects from '''SVN'''. The deprecated CVS version can be found [[CDO Source Installation (CVS, deprecated)|here]].
+
  
== Prepare the IDE ==
+
# Download and start the [[Eclipse Installer]].
Download and install Eclipse 3.7 from http://download.eclipse.org/eclipse/downloads
+
# Drag [https://git.eclipse.org/c/cdo/cdo.git/plain/releng/org.eclipse.emf.cdo.releng/CDOConfiguration.setup this link] and drop it on the installer's title area. Alternatively, copy the location of the previous link and apply it to the Eclipse Installer either via the menu in the upper right in simple mode or via the left-most toolbar button to the upper right in advanced mode.
 +
# Review and/or edit the variable values that the installer presents.
 +
# Click the Next/Finish buttons until the installation starts.
  
Then open a fresh development workspace.
 
  
[[Image:Cdo_source1.png]]
+
You can update your development workspace by pulling the latest updates into your CDO Git clone and selecting the '''Perform Setup Tasks...''' action in the '''Help''' menu.
 
+
 
+
Select the Indigo p2 repository:
+
* http://download.eclipse.org/releases/indigo
+
 
+
Install the following features:
+
* EMF - Eclipse Modeling Framework SDK
+
* Buckminster - Core
+
* Buckminster - Subversive Support
+
* Buckminster - PDE Support
+
* Graphical Editing Framework Zest Visualization Toolkit SDK
+
* Graphical Modeling Framework SDK (needed for CDO Dawn)
+
* Subversive SVN Team Provider (you'll be prompted to install a connector from Polarion when you first use Subversive to access a Subversion repository)
+
 
+
Note that, as of Indigo M5, Buckminster no longer participates in the release train. Please install from:
+
* http://download.eclipse.org/tools/buckminster/updates-3.6
+
* http://download.cloudsmith.com/buckminster/external-3.6 (for headless support)
+
 
+
 
+
[[Image:Cdo_source2.png]]
+
 
+
[[Image:Cdo_install3.png]]
+
 
+
[[Image:Cdo_source4.png]]
+
 
+
[[Image:Cdo_source5.png]]
+
 
+
'''Hint:''' You may alternatively install from the buckminster update site. Subclipse support is available there. Add '''http://download.eclipse.org/tools/buckminster/updates-3.7''' to your update sites and select the required features.
+
 
+
'''Hint:''' If you have trouble with the subversive installation from the indigo update site (e.g. the adapters won't install) try using the subversive update site directly 
+
'''http://download.eclipse.org/technology/subversive/0.7/update-site/'''
+
 
+
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".
+
 
+
[[Image: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)
+
 
+
 
+
[[Image:Cdo_install5.png]]
+
 
+
 
+
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 an API baseline will be created. Non-committers may skip this section.
+
 
+
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 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 checkout the releng project (Buckminster releng component). Download an appropriate Subversive Team Project Set file:
+
 
+
{| cellspacing="1" cellpadding="2" border="1" width="200"
+
|-
+
| <br>
+
| Users<br>
+
| Committers<br>
+
|-
+
| 4.0<br>
+
| [http://dev.eclipse.org/svnroot/modeling/org.eclipse.emf.cdo/trunk/releng/org.eclipse.emf.cdo.releng/psf/bootstrap.psf Download]<br>
+
| [http://dev.eclipse.org/svnroot/modeling/org.eclipse.emf.cdo/trunk/releng/org.eclipse.emf.cdo.releng/psf/bootstrap-committers.psf Download]<br>
+
|-
+
| 3.0<br>
+
| [http://dev.eclipse.org/svnroot/modeling/org.eclipse.emf.cdo/branches/R3_0_maintenance/releng/org.eclipse.emf.cdo.releng/psf/bootstrap.psf Download]<br>
+
| [http://dev.eclipse.org/svnroot/modeling/org.eclipse.emf.cdo/branches/R3_0_maintenance/releng/org.eclipse.emf.cdo.releng/psf/bootstrap-committers.psf Download]<br>
+
|}
+
 
+
Select File->Import... and choose the Team Project Set import wizard. Select the downloaded bootstrap.psf
+
 
+
[[Image:Cdo install10.png]]
+
 
+
[[Image:Cdo install11.png]]
+
 
+
[[Image:Cdo install12.png]]
+
 
+
<br>
+
 
+
== 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.
+

Revision as of 06:08, 2 February 2018

To provision the same development environment that the CDO developers use follow these simple steps:

  1. Download and start the Eclipse Installer.
  2. Drag this link and drop it on the installer's title area. Alternatively, copy the location of the previous link and apply it to the Eclipse Installer either via the menu in the upper right in simple mode or via the left-most toolbar button to the upper right in advanced mode.
  3. Review and/or edit the variable values that the installer presents.
  4. Click the Next/Finish buttons until the installation starts.


You can update your development workspace by pulling the latest updates into your CDO Git clone and selecting the Perform Setup Tasks... action in the Help menu.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.