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 "Simrel/Contributing to Simrel Aggregation Build"

(fix link)
(Install the b3 Aggregator)
Line 14: Line 14:
 
== Install the b3 Aggregator ==  
 
== Install the b3 Aggregator ==  
  
* For at least M1, we are going to stick to using the 0.1.x version of aggregator. In Eclipse 3.6.2 install the b3 aggregator editor from the following URL:
+
* Update as of 8/12/11: For at least Juno M1, we are going to continue using the 0.1.x version of aggregator. [We will (likely) update to 0.2.x aggregator (and evolve model) later during Juno cycle.]
  
  http://download.eclipse.org/modeling/emft/b3/updates-3.6/
+
::In Eclipse 3.6.2  install the b3 aggregator editor from the following URL:
  
We will (likely) update to 0.2.x aggregator (and evolve model) later during Juno cycle.  
+
  http://download.eclipse.org/modeling/emft/b3/updates-3.6/
  
 
* <del>Update as of 8/10/11: While following the following instruction, to work with Juno aggregation build files, it is recommended, if not required, to use the 0.2.x version of the b3 aggregator, running on Eclipse 3.7, installed from b3's "3.7 repo", at following URL: </del>
 
* <del>Update as of 8/10/11: While following the following instruction, to work with Juno aggregation build files, it is recommended, if not required, to use the 0.2.x version of the b3 aggregator, running on Eclipse 3.7, installed from b3's "3.7 repo", at following URL: </del>

Revision as of 16:09, 12 August 2011

These instructions outline how to contribute to the Juno aggregation build for the common repository. The instructions are very similar to the instructions for Indigo. There are the following, relatively small changes:

  • the recommended or required version of b3 aggregator is different (this will likely require two instances of Eclipse installed, each with their own workspace -- one for 'indigo' and one for 'juno'.
  • the main aggregation model file was renamed to a more generic term, "simrel.b3aggr"
  • the normal rename of any cvs projects, test packages or urls ... they will now have 'juno' in place of 'indigo'

If at anytime, there are questions, issues or problems, don't hesitate to ask on cross-project mailing list, or open a cross-project bug.

Checkout CVS juno.build project

Check out project org.eclipse.juno.build from dev.eclipse.org:/cvsroot/callisto. If you do not have write access to this repository location, contact the webmaster, explaining which project you are working with, and CC the Planning Council chairperson (currently david_williams@us.ibm.com).

Install the b3 Aggregator

  • Update as of 8/12/11: For at least Juno M1, we are going to continue using the 0.1.x version of aggregator. [We will (likely) update to 0.2.x aggregator (and evolve model) later during Juno cycle.]
In Eclipse 3.6.2 install the b3 aggregator editor from the following URL:
 http://download.eclipse.org/modeling/emft/b3/updates-3.6/
  • Update as of 8/10/11: While following the following instruction, to work with Juno aggregation build files, it is recommended, if not required, to use the 0.2.x version of the b3 aggregator, running on Eclipse 3.7, installed from b3's "3.7 repo", at following URL:
http://download.eclipse.org/modeling/emft/b3/updates-3.7/
  • Follow instructions to install the b3 Aggregator editor (and checkout the above mentioned CVS project). Tip: many find it preferable to have a separate workspace for this aggregation work, as it works with many p2 repositories and can add a lot of background processing as it works with all those repositories.
  • Open the file simrel.b3aggr using the Aggregator Model Editor
Tip: Having the model "loaded" and allowing it to update itself (staying current with latest contents of referenced repos) and syncing up the juno.build project on a regular basis, can often help you spot errors or inconsistencies with your own contributions, and allow fixes to be made before committing your own update to CVS.

For new project contributions

  • Tip: if you are nervous about making large changes you can always tag the CVS juno.build project before making large changes, so there is an obvious restore point. For example, you could tag with <youruserid>_pre<project>addition<datetime> or some such easily recognizable marker.
  • Create the following elements (New Child) under Aggregator Juno:
    • One or more Contacts (show Property View to specify Email and Name)
    • A Contribution (specify Label and link to Contact)
      • A Mapped Repository (specify Location: URL of your p2 repository)
        • Your Features (select name from features found in your repository, select Categories from pre-defined set, specify exact version to be included in aggregation under Version Range)
  • Select your Contribution and invoke Detach Resource from the context menu. Choose a filename like projectname.b3aggrcon (renaming this file at a later stage is not supported). For ease of bookkeeping, it is advisable to use the "exact" name of your project as it appears in the Eclipse Foundation databases, including top level and subproject names, as appropriate, for example, emf-validation.b3aggrcon is preferable to validation.b3aggrcon or webtools.b3aggrcon preferable to wtp.b3aggrcon.
  • Verify. To ensure that your contribution will not break the build, right-click on your contribution and select "Verify Repository".
  • Checkin. At this point, you are ready to checkin your contribution. You will need to synchronize and check in changes to the simrel.b3aggr file, as well as your projectname.b3aggrcon file.

Updating contributions

  • To change things like Contributors or Categories, or adding or removing features, you should use the b3 Aggregator with the top level simrel.b3aggr file ... as these things often have relationships that span files and you need to update, synchronize and checkin all effected files. Note: the Categories are normally only added or edited by Planning Council, so be sure large changes there have been discussed via bugzilla, etc. (You can do this via e-mail, or a bugzilla entry in cross-project category).
  • To changes values of feature versions, or repository URLs, you can directly change your projectname.b3aggrcon file with text editor (or build scripts) and check those in, in isolation. Of course, you can and should still use the b3 aggregator editor, and it is often desirable to do so, as it will do a "workbench build" and will tell you if something is wrong. For example, if the repository URL does not point to a valid repository, you'll know about it right away, if you use the b3 Aggregator Editor.
  • Note that contributions, features, and repositories can be enabled or disabled, via property page. This allows temporary changes with minimal disruption. For example, if you disable a contribution or feature, it will be left out of a category, without having to also edit the category). This is especially useful if there is a leaf component that is "broken" and should temporarily be omitted from the build. Important: One implication of this is you will need to sometimes re-enable your contribution or feature, even if you did not disable it. These are sometimes disabled by others -- without notice -- especially if a contribution or feature is causing build breaks for an extended period of time especially if there's been no communication explaining it or describing status or outlook on cross-project list. Of course, fixing the issue is the desired first choice, as disabling one contribution or feature will often require other contributions or features to be disabled simply because they depend on the broken one.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.