The org.eclipse.releng.basebuilder and org.eclipse.releng.eclipsebuilder projects are still in CVS (/cvsroot/eclipse)

+

They need to be migrated to Git by the end of 2012. The basebuilder project should really be 1) In its own repo because of it's binary content or 2) Convert the build to use a product build from the repo of SDK bundles and consume the custom bundles separately or 3) Just extract a SDK and add custom bundles to it

+

+

The complete list of Git repos for the Eclipse and Equinox projects are here [[Platform-releng/Git_Workflows]]

+

== Basic overview of platform builds ==

== Basic overview of platform builds ==

Integration builds are in crontab of build user on build machine

Integration builds are in crontab of build user on build machine

−

Integration builds run from the tags of org.eclipse.releng

+

Integration builds run from the tags of org.eclipse.releng in the integration branch of org.eclipse.releng

You will notice that the integration build has a compareMaps flag passed to the build. This paramater takes the current version of the map file project, and compares it to the version here in the the file "/home/users/releng/buildTools/eclipse36/mapTag.properties"

If you look search for "buildProjectTags" in this file, you'll see something like this

+

This indicates the tag of the the three releng projects (org.eclipse.releng.eclipsebuilder, org.eclipse.releng.basebuilder, eclipseInternalBuildTools) used to run the build. If you need to run the build with a new version of the builder, update this tag.

+

buildProjectTags=v20120305

−

lastMapTag=I20100429-1549

+

== Rsync ==

−

The bootstrap script that initiates 3.6 stream builds is located on the build machine here...

+

The build is rsynced from eclipsebuildserv to fullmoon.ottawa.ibm.com to download.eclipse.org. Look in kmoir's crontab for the scripts.

If you look search for "buildProjectTags" in this file, you'll see something like this

+

kmoir's crontab on fullmoon

−

This indicates the tag of the the three releng projects (org.eclipse.releng.eclipsebuilder, org.eclipse.releng.basebuilder, eclipseInternalBuildTools) used to run the build. If you need to run the build with a new version of the builder, update this tag.

Since our build runs in an IBM lab, the http gets for orbit bundles from eclipse.org are usually redirected from download.eclipse.org to fullmoon.ottawa.ibm.com by the foundation. This redirection can be avoided by changing the url in the orbit.map from download.eclipse.org to www.eclipse.org/external. Sometimes it will take a day or so for the internal mirror to get the latest orbit build.

Since our build runs in an IBM lab, the http gets for orbit bundles from eclipse.org are usually redirected from download.eclipse.org to fullmoon.ottawa.ibm.com by the foundation. This redirection can be avoided by changing the url in the orbit.map from download.eclipse.org to www.eclipse.org/external. Sometimes it will take a day or so for the internal mirror to get the latest orbit build.

−

*Missing dependancies due to erroneous map file submission.&nbsp; Check that the map file refers to a version of a project that exists in the repo. If the version of a bundle in cvs doesn't match the one in the map files, ask team to resubmit and start a new build.

+

*Missing dependencies due to erroneous map file submission.&nbsp; Check that the map file refers to a version of a project that exists in the repo. If the version of a bundle in Git doesn't match the one in the map files, ask team to resubmit and start a new build.

−

*Build doesn't proceed - connent not updated etc.&nbsp; Check for stale cvs checkouts on eclipsebuildserv.&nbsp; ps -ef | grep cvs.&nbsp; If there is a cvs connection that's over an hour old, kill it and allow the build to proceed.

+

*Build doesn't proceed - connent not updated etc.&nbsp; Check for stale Git clone processes on eclipsebuildserv.&nbsp; ps -ef | grep git.&nbsp; If there is a git process that's over an hour old, kill it and allow the build to proceed.

*SDKs fail to provision due to missing dependancies. There are releng logs on each test results page of the build that provide logs of the from the call to the p2 director to provision the zips. The Equinox team is helpful in finding the cause of the problem. See this page for an example. http://download.eclipse.org/eclipse/downloads/drops/R-3.5-200906111540/buildlogs.php

*SDKs fail to provision due to missing dependancies. There are releng logs on each test results page of the build that provide logs of the from the call to the p2 director to provision the zips. The Equinox team is helpful in finding the cause of the problem. See this page for an example. http://download.eclipse.org/eclipse/downloads/drops/R-3.5-200906111540/buildlogs.php

−

*Missing dependancies due to errors in Manifest or missing dependancies in manifest. In the both cases, the error sent to the releng list will look something like http://dev.eclipse.org/mhonarc/lists/platform-releng-dev/msg09778.html

+

*Missing dependencies due to errors in Manifest or missing dependencies in manifest. In the both cases, the error sent to the releng list will look something like http://dev.eclipse.org/mhonarc/lists/platform-releng-dev/msg09778.html

−

*Dependancies expressed in manifest and feature don't match. This means that the p2 director cannot resolve the dependencies for the product it is trying to build. The resultant zips for that platform are 0 size. For instance, see bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=258489 | bug 258489]. Also, you can see the .log files that the directory built by following the ''Release Engineering build logs'' link off the ''Test results'' build page.

+

*Dependencies expressed in manifest and feature don't match. This means that the p2 director cannot resolve the dependencies for the product it is trying to build. The resultant zips for that platform are 0 size. For instance, see bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=258489 | bug 258489]. Also, you can see the .log files that the directory built by following the ''Release Engineering build logs'' link off the ''Test results'' build page.

−

*Message "Build failed, map files unchanged". This means either one of two things. One - a build ran and the map files were unchanged so it didn't need to run. Two - you restarted a failed build but the map files didn't change. In the second case, you should update this /home/users/releng/buildTools/eclipse36/mapTag.properties to reflect the build id of the last successful build.

+

*Message "Build failed, map files unchanged". This means either one of two things. One - a build ran and the map files were unchanged so it didn't need to run. Two - you restarted a failed build but the map files didn't change. In the second case, you should update this /home/users/releng/buildTools/eclipse38/mapTag.properties to reflect the build id of the last successful build.

+

*Message "A problem occured while invoking the director". If there is a compile error in the build, the bundle with the compile error will not be published to the repository. Thus when the director is invoked to build zips, the director operation will fail.

+

*The director logs, mirror logs etc. are located on the test results pages, under release engineering logs. [http://download.eclipse.org/eclipse/downloads/drops/R-3.6-201006080911/buildlogs.php Example of 3.6 release engineering logs. ] The location on the build machine filesystem is

+

/builds/transfer/files/master/download/drops/<buildId>/buildlogs. If the build has failed invoking the director, the director logs may not be copied to this location yet. In this case, there will be director logs in /builds/<buildId>/org.eclipse.releng.basebuilder/configuration directory.

Usually there if there are new Orbit bundles released during a milestone that a team needs to consume, we run test builds before milestone week to ensure that the new Orbit bundles are the right shape etc. For example, see bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=368174 bug 368174]

+

+

'''Move to latest EMF and ECF contributions'''

+

+

::[TODO: Kim, can you elaborate? correct?]

+

+

Update maps for pre-req'd version. For the 4.2 build we consume EMF from http://download.eclipse.org/modeling/emf/emf/updates/2.8milestones/base/. This repo has to have the Juno EMF contribution for that milestone. Kenn Hussey is the one that we contact for this.

+

+

In the 3.8 build we do that same thing, consume new versions of ECF. Not very often these days. Scott Lewis is the contact for this and Ian Bull should know about the need to consume a new version. Again, similar to EMF, we consume a version of ECF at +0, where they are higher up on the release train stack. So they usually provide a special repo for us to consume.

+

+

Update build.properties to point to right location (needed for JavaDoc builds to work right)

+

+

+

'''Test milestone bundles in org.eclipse.releng.basebuilder'''

+

+

Release the relevant subset of bundles to org.eclipse.releng.basebuilder and run a test build to ensure the milestone build can build Eclipse. Update the builder to the milestone build after it's released, run test build.

+

+

'''Update b3aggrcon file for aggregation'''

+

+

This includes both ep and equinox b3aggrcon files. Must do after milestone is "final". Often helps to update with "near milestone" results a few days or week early, to give others an "early look" at what's coming.

+

+

'''Update composite artifacts to add new milestone repository'''

+

+

Every milestone, once final, update the platform's composite sites, such as update compositeContent.jar and compositeArtifacts.jar at

[TODO: Kim, how/when do the "subdirectory repos" get copied there? (i.e. built there? or copied from build location? or mirrored from build location? Is there a script? ]

+

+

I just copy the milestone child repo /home/data/httpd/download.eclipse.org/eclipse/updates/4.2-I-builds to 4.2milestones and update the compositeContent.jar and compositeArtifacts.jar to point to the new repo.

+

+

[TODO: Similar for weekly integration builds?]

+

+

For weekly integration builds, the build just adds a new child repo automatically. Once a milestone, I go and clean out the integration build repos.

+

+

== Other common tasks ==

+

+

Move to a newer version of an Orbit bundle

+

+

#Update orbit.map with pointer to new location

+

#Update appropriate platformOptions.txt file in org.eclipse.platform.doc.isv or jdtOptions.txt in org.eclipse.jdt.doc.isv to reflect the new name of the bundle as appropriate.

+

#Modify the appropriate build.properties in the feature that generates the source bundles for that Orbit bundle. Source bundles for Orbit bundles should not be generated because they are contributed in binary form. For instance, if you look at this build.properties for the Eclipse 3.8 SDK feature, you can see that the orbit bundles are all listed as "unpack=true".

The org.eclipse.releng.basebuilder and org.eclipse.releng.eclipsebuilder projects are still in CVS (/cvsroot/eclipse)
They need to be migrated to Git by the end of 2012. The basebuilder project should really be 1) In its own repo because of it's binary content or 2) Convert the build to use a product build from the repo of SDK bundles and consume the custom bundles separately or 3) Just extract a SDK and add custom bundles to it

If you look search for "buildProjectTags" in this file, you'll see something like this
This indicates the tag of the the three releng projects (org.eclipse.releng.eclipsebuilder, org.eclipse.releng.basebuilder, eclipseInternalBuildTools) used to run the build. If you need to run the build with a new version of the builder, update this tag.
buildProjectTags=v20120305

Rsync

The build is rsynced from eclipsebuildserv to fullmoon.ottawa.ibm.com to download.eclipse.org. Look in kmoir's crontab for the scripts.

Common build failures

"Error occurred while transforming repository" usually means that the bundle couldn't be fetched from Orbit. For example

Build M20090825-1330 (Timestamp: 200908251330): The following error occurred while executing this line:
/builds/M200908251330/org.eclipse.releng.eclipsebuilder/buildAll.xml:166: The following error occurred while executing this line:
/builds/M200908251330/org.eclipse.releng.basebuilder/plugins/org.eclipse.pde.build_3.5.1.R35x_20090721/scripts/build.xml:78: The following error occurred while executing this line:
/builds/M200908251330/org.eclipse.releng.eclipsebuilder/eclipse/buildConfigs/master/customTargets.xml:18: The following error occurred while executing this line:
/builds/M200908251330/org.eclipse.releng.eclipsebuilder/eclipse/buildConfigs/master/allElements.xml:16: The following error occurred while executing this line:
/builds/M200908251330/org.eclipse.releng.basebuilder/plugins/org.eclipse.pde.build_3.5.1.R35x_20090721/scripts/genericTargets.xml:59: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_master.xml:11: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_master.xml:73: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_org.eclipse.sdk.xml:11: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_org.eclipse.sdk.xml:41: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_org.eclipse.platform.xml:11: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_org.eclipse.platform.xml:904: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_org.eclipse.equinox.p2.user.ui.xml:10: The following error occurred while executing this line:
/builds/M200908251330/src/fetch_org.eclipse.equinox.p2.user.ui.xml:304: Error occurred while transforming repository.

Since our build runs in an IBM lab, the http gets for orbit bundles from eclipse.org are usually redirected from download.eclipse.org to fullmoon.ottawa.ibm.com by the foundation. This redirection can be avoided by changing the url in the orbit.map from download.eclipse.org to www.eclipse.org/external. Sometimes it will take a day or so for the internal mirror to get the latest orbit build.

Missing dependencies due to erroneous map file submission. Check that the map file refers to a version of a project that exists in the repo. If the version of a bundle in Git doesn't match the one in the map files, ask team to resubmit and start a new build.

Build doesn't proceed - connent not updated etc. Check for stale Git clone processes on eclipsebuildserv. ps -ef | grep git. If there is a git process that's over an hour old, kill it and allow the build to proceed.

Dependencies expressed in manifest and feature don't match. This means that the p2 director cannot resolve the dependencies for the product it is trying to build. The resultant zips for that platform are 0 size. For instance, see bug | bug 258489. Also, you can see the .log files that the directory built by following the Release Engineering build logs link off the Test results build page.

Message "Build failed, map files unchanged". This means either one of two things. One - a build ran and the map files were unchanged so it didn't need to run. Two - you restarted a failed build but the map files didn't change. In the second case, you should update this /home/users/releng/buildTools/eclipse38/mapTag.properties to reflect the build id of the last successful build.

Message "A problem occured while invoking the director". If there is a compile error in the build, the bundle with the compile error will not be published to the repository. Thus when the director is invoked to build zips, the director operation will fail.

/builds/transfer/files/master/download/drops/<buildId>/buildlogs. If the build has failed invoking the director, the director logs may not be copied to this location yet. In this case, there will be director logs in /builds/<buildId>/org.eclipse.releng.basebuilder/configuration directory.

All build tasks are invoked via the userid kmoir on the internal build machine, test machines and eclipse.org.

Missing test results

The test results page of the build isn't updated until all the test results have completed. To see what machines are currently being used for tests look the the following directory. There will be marker files that correspond to the machine operating system and build number.

The windows machines run tests via rsh. The linux and mac machines run tests via ssh. The windows machines need to be rebooted every so often. The old build artifacts are cleaned automatically by cron jobs.

The windows tests machines crash every so often. The event logs don't indicate that anything is wrong with the build. They are on the KVM next to the Eclipse rack in lab, on number 5 and 6. They can just be rebooted and logged into as the build user. I usually reboot these machines once a week so this doesn't happen.

Restarting the build

Each build has a corresponding directory on eclipsebuildserv in /builds. For instance /builds/I201004291549/. If you cd to the org.eclipse.releng.eclipsebuilder directory, there is a script called buildAll.xml. The main target looks something like this

If the build fails, you can restart it by commenting out the sections of the build that have already completed in the main target. Then cd to /builds/I201004291549/org.eclipse.releng.eclipsebuilder, for example, and run sh command.txt. This will allow the build to continue. Alternatively, you can add a cron entry to restart the build. For example,

Common tasks during a milestone

Usually there if there are new Orbit bundles released during a milestone that a team needs to consume, we run test builds before milestone week to ensure that the new Orbit bundles are the right shape etc. For example, see bug bug 368174

In the 3.8 build we do that same thing, consume new versions of ECF. Not very often these days. Scott Lewis is the contact for this and Ian Bull should know about the need to consume a new version. Again, similar to EMF, we consume a version of ECF at +0, where they are higher up on the release train stack. So they usually provide a special repo for us to consume.

Update build.properties to point to right location (needed for JavaDoc builds to work right)

Test milestone bundles in org.eclipse.releng.basebuilder

Release the relevant subset of bundles to org.eclipse.releng.basebuilder and run a test build to ensure the milestone build can build Eclipse. Update the builder to the milestone build after it's released, run test build.

Update b3aggrcon file for aggregation

This includes both ep and equinox b3aggrcon files. Must do after milestone is "final". Often helps to update with "near milestone" results a few days or week early, to give others an "early look" at what's coming.

Update composite artifacts to add new milestone repository

Every milestone, once final, update the platform's composite sites, such as update compositeContent.jar and compositeArtifacts.jar at

/home/data/httpd/download.eclipse.org/eclipse/updates/4.2milestones

[TODO: Kim, how/when do the "subdirectory repos" get copied there? (i.e. built there? or copied from build location? or mirrored from build location? Is there a script? ]

I just copy the milestone child repo /home/data/httpd/download.eclipse.org/eclipse/updates/4.2-I-builds to 4.2milestones and update the compositeContent.jar and compositeArtifacts.jar to point to the new repo.

[TODO: Similar for weekly integration builds?]

For weekly integration builds, the build just adds a new child repo automatically. Once a milestone, I go and clean out the integration build repos.

Other common tasks

Move to a newer version of an Orbit bundle

Update orbit.map with pointer to new location

Update appropriate platformOptions.txt file in org.eclipse.platform.doc.isv or jdtOptions.txt in org.eclipse.jdt.doc.isv to reflect the new name of the bundle as appropriate.

Modify the appropriate build.properties in the feature that generates the source bundles for that Orbit bundle. Source bundles for Orbit bundles should not be generated because they are contributed in binary form. For instance, if you look at this build.properties for the Eclipse 3.8 SDK feature, you can see that the orbit bundles are all listed as "unpack=true".