This page is for '''developers''' of the June 2009 Galileo Simultaneous Release. If you are a consumer of the Release, perhaps a tester or an early adopter, you'll want [[Galileo Simultaneous Release/For Users | Galileo Simultaneous Release For Users]]. Note that [http://www.eclipse.org/projects/galileo.php the master page on the eclipse.org site] points here.

+

This page is for '''developers''' of the June 2009 Galileo Simultaneous Release. Note that [http://www.eclipse.org/projects/galileo.php the master page on the eclipse.org site] points here.

</div></div>

</div></div>

+

+

{{Succession Box|

+

before=[[Ganymede]]|

+

title=Galileo|

+

years=2009|

+

after=[[Helios]]

+

}}

===Project Plan===

===Project Plan===

−

A roll up project plan for projects participating in the Galileo simultaneous release is found here: http://www.eclipse.org/projects/project-plan.php?projectid=galileo

+

A roll up project plan for projects participating in the Galileo [[Simultaneous Release]] is found here: http://www.eclipse.org/projects/project-plan.php?projectid=galileo

===Requirements For Participation===

===Requirements For Participation===

Line 121:

Line 128:

|-

|-

| New &amp; Noteworthy

| New &amp; Noteworthy

−

| Must have new & noteworthy for each milestone. Must be something readable and usable not just a static list of all the bugs, e.g. [http://download.eclipse.org/eclipse/downloads/drops/R-3.4-200806172000/whatsnew3.4/eclipse-news.html platform]. Corollary: individual new &amp; noteworthy should be linked in to the collective New & Noteworthy.

+

| Must have [[Architecture Council/New and Noteworthy|New &amp; Noteworthy]] for each milestone. Must be something readable and usable not just a static list of all the bugs, e.g. [http://download.eclipse.org/eclipse/downloads/drops/R-3.4-200806172000/whatsnew3.4/eclipse-news.html platform]. Corollary: individual new &amp; noteworthy should be linked in to the collective New & Noteworthy.

| align="center" | RC

| align="center" | RC

| align="center" | Manual

| align="center" | Manual

Line 208:

Line 215:

'''Hopefully''' there will '''not by ''ANY'' differences''' between RC4, and RC5 ... but, some projects may find they have to make doc additions, readme files, etc., so ... this just provides a way that such changes can be consistently marked, tracked, etc., to better keep everyone informed about what might be different between RC4 and the RC5 (the final released code). [Note: it's probably obvious, but this does not mean "RC5" should be part of the final zip file names or anything. those can still be what ever "final" name they would always have.]

'''Hopefully''' there will '''not by ''ANY'' differences''' between RC4, and RC5 ... but, some projects may find they have to make doc additions, readme files, etc., so ... this just provides a way that such changes can be consistently marked, tracked, etc., to better keep everyone informed about what might be different between RC4 and the RC5 (the final released code). [Note: it's probably obvious, but this does not mean "RC5" should be part of the final zip file names or anything. those can still be what ever "final" name they would always have.]

As with Ganymede, reporting on status will be done using a wiki table.

As with Ganymede, reporting on status will be done using a wiki table.

+

</del>

−

* [[Galileo/Signoffs]]

+

We have decided that instead of affirmative signoffs, projects should post exceptions to the cross-project dev mailing list.

====Conference Calls====

====Conference Calls====

Line 238:

Line 246:

* Open a new [https://bugs.eclipse.org/bugs/enter_bug.cgi?assigned_to=cross-project.inbox%40eclipse.org&product=Community&component=Cross-Project Cross-Project] bug

* Open a new [https://bugs.eclipse.org/bugs/enter_bug.cgi?assigned_to=cross-project.inbox%40eclipse.org&product=Community&component=Cross-Project Cross-Project] bug

−

===Galileo Builds===

+

===Galileo Builds and P2 repository ===

A number of utilities have been written to automate the assembly of Callisto '06, Europa '07, Ganymede '08 and now Galileo '09 builds. These are available in their own CVS respository. You can find more information about how this is organized and individual project responsibilities for the build on this [[Galileo/Build | Galileo Build]] page (with old information on the [[Ganymede/Build | Ganymede Build]] and [[Europa/Build | Europa Build]] pages).

A number of utilities have been written to automate the assembly of Callisto '06, Europa '07, Ganymede '08 and now Galileo '09 builds. These are available in their own CVS respository. You can find more information about how this is organized and individual project responsibilities for the build on this [[Galileo/Build | Galileo Build]] page (with old information on the [[Ganymede/Build | Ganymede Build]] and [[Europa/Build | Europa Build]] pages).

−

'''The [[Galileo/Build | Galileo Build]] page is where you go to learn how to add your project to the Galileo build.'''

+

And with Galileo we are using the [[Buckminster Galileo Builder]].

−

To obtain the latest published bits from Galileo, use this URL: http://download.eclipse.org/releases/galileo

+

The [[Galileo/Contributing_to_Galileo_Build | Contributing to Galileo Build]] page is where you go to learn how to add your project to the Galileo build.

−

===Coordinated Service Releases (TBD)===

+

==== p2 Repository ====

−

These dates are to be determined.

+

To obtain the latest published bits from Galileo, use this URL:

+

+

http://download.eclipse.org/releases/galileo

+

+

It contains the latest milestone, release candidate, eventually the release itself, and then eventually service releases.

+

+

To obtain the latest working version, as we build up to a milestone or release, you can test the site at

+

+

http://download.eclipse.org/releases/staging

+

+

===Coordinated Service Releases ===

+

+

==== SR1 ====

+

GA: 9/25/09 (last Friday of September)

+

+

In the SR1 rampdown, as shown in the following table, there will be 4 RCs, each spanning one week, with projects staging themselves into the build just one day apart.

+

+

Projects may elect not to participate in a particular RC, but have an obligation to fix any build problems that is related to their code or p2 repository.

+

+

RC1 will be in the middle of August, several weeks earlier than previous years, just to make sure we can still build, etc. Subsequent RCs dates are similar to [[Ganymede#Coordinated_Service_Releases| previous years]], except a "quiet" final week is also planned. (It is normally pretty quiet anyway ... this just formalizes it).

+

+

The Final week before GA will not have any further builds or contributions, but instead be reserved for final adopter testing and preparation and only emergency fixes for very serious regressions will be considered.

+

+

The 'promote' day (9/24) will be the day projects put final zips in their final spot (without displaying them) so they can propagate through the mirroring system. Similar for the p2 repository -- it will be replaced on 9/24 with the new content so it can start mirroring. Note: there is no plan to retain multiple versions in the common discovery repository (unless someone volunteers to do what's required to make that happen). At noon on 9/25 projects can make their final maintenance releases visible.

Project Plan

Requirements For Participation

Projects that are part of Galileo agree to abide by the following requirements. Note: the EMO will remove projects that do not meet the required constraints.

For a report of overall Galileo status, see this report. Note: this report is bugzilla intensive, so please use sparingly.

Must Do

Galileo Release "Must Do" Items

Category

Item

Description

Target Milestone

Verification Method

Master Bug

Participation

Intent

Projects must have stated and demonstrated their intent to join Galileo by the M4+0 date. Projects do so by adding themselves to bug 251715 and asking to have their project-specific bugs created as clones of each of those referenced in this table.

At least one person from each project must subscribe to cross-project bug inbox, i.e. edit Bugzilla prefs to watch "cross-project.inbox@eclipse.org". Build team members (or their designated alternates) from each project will provide communication channels: phone, mail, IM, IRC and will be available during the milestone integration periods.

Projects must have a written ramp down policy by M6+0, linked in the table above pending inclusion of ramp down element in the XML project plan. (One of the issues identified with this guideline is that its not so much the ramp down policy of how many votes are needed for each bug fix that we need to be consistent on, but rather the meaning of each of the milestones and release candidates. See Platform 3.4 Endgame plan as a guideline. See also Galileo Final Daze.)

Projects should leverage only published APIs of dependencies. As a Release Review requirement, all deviations must be documented. Additionally, rectification for the issues should be listed as part of a migration plan, with bugs listed where APIs need to be provided by dependent projects. Perhaps a '99 44/100% Pure APIs' indicator for projects with no improper usage can be used to advertise the 'cleanest' projects? ;)

All plug-ins (bundles) must use the true bundle form. That is, provide a manifest.mf file, and not rely on the plugin.xml file being 'translated' into a manifest.mf file at initial startup. See bug 130598. With that, empty plugin.xml files in the presence of a manifest.mf file should not be included in a bundle.

Projects must use jar'ed plug-ins (with unpack=false) unless authorized by the planning council for technical reasons. Nested jars should be avoided if possible since it creates problems for projects that has dependencies to such plug-ins. The OSGi runtime is fine with it but the compiler is not able to handle classpaths that contain nested jars. In case only one nested jar exists, it is often better to expand the contents of that jar into the root folder (i.e. unnest the jar). If a plug-in contains large files that are frequently used (opened and closed), a jar'ed plug-in might degrade performance significantly since the file must be decompressed each time it is opened.

Any new third-party plug-ins that are common between projects must be consumed via Orbit; the final Galileo release will not have duplicate third-party libraries (note that this only applies to identical versions of the libraries; thus if project A requires foo.jar 1.6 and project B uses foo.jar 1.7, that's ok).

Projects must optimize their own update site using pack200 to reduce bandwidth utilization and provide a better update experience for users. With the introduction of p2, project update sites must generate metadata (artifact and content repository info).

Must have New & Noteworthy for each milestone. Must be something readable and usable not just a static list of all the bugs, e.g. platform. Corollary: individual new & noteworthy should be linked in to the collective New & Noteworthy.

This means that users can load any subset of the Galileo projects into Eclipse and each of the loaded projects will pass all the same tests as if it had been loaded independently. If such a problem is identified, the affected projects must fix the problem.

Each project will provide basic capability/activity definitions to allow for their UI contributions to be hidden. These must be provided in a separate plugin/feature to facilitate inclusion/exclusion by consumers in product development.

Each major project (as determined by participating PMCs) should have an About dialog icon with descriptive text (e.g. provider name = "Eclipse Modeling Project" and not simply Eclipse.org) and contribute to the welcome page.

Milestones and Release Candidates

These milestone and release candidate dates are based on the dependencies of the projects (we call these the +0, +1, and +2 dependencies). Obviously, if a +0 date slips, then it will cause the +1 and +2 dates to slip; similarly for a +1 slip causing +2 slips. Note that the +0, +1, +2, and +3 dates are roughly equivalent to stable nightly builds in a traditional Eclipse project - each of these partial milestone builds will incorporate more and more of the associated project milestones. The "Release" date is the official M/RC date.

Note: in the following table, RC5 on the 'Galileo' line does not mean this final build is a release 'candidate' ... it is still to be the 'final build' for this Release ... but 'RC5' is the suggested "target" to have some consistent terminology in Bugzilla, and similar things, to be able to mark things that are different in the final release build than in the RC4 build. [The full word, "Galileo" doesn't make a very good bugzilla milestone target, since it's a little too inclusive, and "R" (for "Release") is too short. TODO: next year consider "GA" for this final target?]

Hopefully there will not by ANY differences between RC4, and RC5 ... but, some projects may find they have to make doc additions, readme files, etc., so ... this just provides a way that such changes can be consistently marked, tracked, etc., to better keep everyone informed about what might be different between RC4 and the RC5 (the final released code). [Note: it's probably obvious, but this does not mean "RC5" should be part of the final zip file names or anything. those can still be what ever "final" name they would always have.]

Bugs & Feature Requests

Galileo Builds and P2 repository

A number of utilities have been written to automate the assembly of Callisto '06, Europa '07, Ganymede '08 and now Galileo '09 builds. These are available in their own CVS respository. You can find more information about how this is organized and individual project responsibilities for the build on this Galileo Build page (with old information on the Ganymede Build and Europa Build pages).

Coordinated Service Releases

SR1

In the SR1 rampdown, as shown in the following table, there will be 4 RCs, each spanning one week, with projects staging themselves into the build just one day apart.

Projects may elect not to participate in a particular RC, but have an obligation to fix any build problems that is related to their code or p2 repository.

RC1 will be in the middle of August, several weeks earlier than previous years, just to make sure we can still build, etc. Subsequent RCs dates are similar to previous years, except a "quiet" final week is also planned. (It is normally pretty quiet anyway ... this just formalizes it).

The Final week before GA will not have any further builds or contributions, but instead be reserved for final adopter testing and preparation and only emergency fixes for very serious regressions will be considered.

The 'promote' day (9/24) will be the day projects put final zips in their final spot (without displaying them) so they can propagate through the mirroring system. Similar for the p2 repository -- it will be replaced on 9/24 with the new content so it can start mirroring. Note: there is no plan to retain multiple versions in the common discovery repository (unless someone volunteers to do what's required to make that happen). At noon on 9/25 projects can make their final maintenance releases visible.

+0 Mon.

+1 Tues.

+2 Wed.

+3 Thur.

EPP Fri.

RC1

8/10

8/11

8/12

8/13

8/14

RC2

8/31

9/1

9/2

9/3

9/4

RC3

9/7

9/8

9/9

9/10

9/11

RC4

9/14

9/15

9/16

9/17

9/18

Galileo SR1 ("GA")

promote: 9/24

GA: 9/25

SR2

2/26/10 (last Friday of February)

Rampdown similar to SR1.

+0 Mon.

+1 Tues.

+2 Wed.

+3 Thur.

EPP Fri.

RC1

1/18

1/19

1/20

1/21

1/22

RC2

2/1

2/2

2/3

2/4

2/5

RC3

2/8

2/9

2/10

2/11

2/12

RC4

2/15

2/16

2/17

2/18

2/19

Galileo SR2 ("GA")

promote: 2/25

GA: 2/26

Projects

The projects that plan to participate in the Galileo Simultaneous Release are listed below, along with their milestone offsets, leaders, release engineer, and ramp down policy.