Jump to: navigation, search

Difference between revisions of "Mylyn/Release Howto"

Line 33: Line 33:
  
 
= The Release =
 
= The Release =
 +
 +
== Update Target ==
 +
* Update target files to point to release sites
  
 
== Tag Sources ==
 
== Tag Sources ==
Line 54: Line 57:
 
* Snapshot build:
 
* Snapshot build:
 
  TYPE=weekly mvn -f org.eclipse.mylyn/org.eclipse.mylyn.releng/pom.xml clean deploy
 
  TYPE=weekly mvn -f org.eclipse.mylyn/org.eclipse.mylyn.releng/pom.xml clean deploy
 +
 +
== Verify Update Site Contents ==
 +
* Check that only approved features are on the update site
 +
* Check that all Orbit bundles are tracked on [http://eclipse.org/projects/ip_log.php?projectid=mylyn,mylyn.builds,mylyn.commons,mylyn.context,mylyn.docs,mylyn.reviews,mylyn.tasks,mylyn.versions approved CQs]
 +
 +
== Test Install ==
 +
* Do a test install from http://download.eclipse.org/mylyn/snapshots/weekly
 +
 +
== Remove Old Integration Builds
 +
rm ~/downloads/mylyn/archive/3.6.0/I*
 +
 +
== Add Mirror URLs ==
 +
cd ~/downloads/mylyn/archive/3.6.0/
 +
~/releng/bin/update-metadata.sh
 +
* Check that the content.jar contains the following property:
 +
<property name="p2.mirrorsURL" value="http://www.eclipse.org/downloads/download.php?file=/mylyn/archive/.../v.../&amp;protocol=http&amp;format=xml"/>
 +
 +
== Copy Release to archive.eclipes.org ==
 +
cp ~/downloads/mylyn/archive/3.6.0 /home/data/httpd/archive.eclipse.org/mylyn/archive
  
 
== Update Release Repository Content ==
 
== Update Release Repository Content ==
 
* Update filters in ~/downloads/mylyn/releases/*/composite.index
 
* Update filters in ~/downloads/mylyn/releases/*/composite.index
* Update composite sites
+
* Update release composite sites
 
  cd ~/downloads/mylyn/releases/
 
  cd ~/downloads/mylyn/releases/
 +
~/releng/bin/create-composite.sh -r
 +
* Update snapshot composite sites
 +
cd ~/downloads/mylyn/snapshots/
 
  ~/releng/bin/create-composite.sh -r
 
  ~/releng/bin/create-composite.sh -r
  
Line 64: Line 89:
 
* Update the version number on download page
 
* Update the version number on download page
 
* Create a new section on download archive page
 
* Create a new section on download archive page
* Add a link to the new API baseline on the download archive page (for major releases)
+
* Add a link to the new API baseline on the download archive page (major releases only)
 
* Create a new section in the New &amp; Noteworthy
 
* Create a new section in the New &amp; Noteworthy
  
== Add Mirror URLs ==
+
== Update Babel ==
cd ~/downloads/mylyn/archive/3.6.0/v20110608-1400
+
* Make release available in [http://babel.eclipse.org/babel/map_files.php Eclipse Babel] for translation (major releases only)
~/releng/bin/add-mirrors.sh 3.6.0
+
* Check that the content.jar contains the following property:
+
<property name="p2.mirrorsURL" value="http://www.eclipse.org/downloads/download.php?file=/mylyn/archive/.../v.../&amp;protocol=http&amp;format=xml"/>
+
  
 
= After the Release =
 
= After the Release =
  
 
== Update Versions ==
 
== Update Versions ==

Revision as of 18:23, 15 June 2011


Before the Release

Prepare Source Code

Internationalize Messages

  • Run Source > Find Broken Externalized Strings over all bundles
  • Run Source > Externalize Strings over all bundles

Update User Guide from the Wiki

  • Run org.eclipse.mylyn.help.ui/build-helper.xml as an Ant Build (ensure org.eclipse.mylyn.wikitext* is checked out into your workspace)
  • Review the user guide and commit changes to CVS

Update Copyright Notices

  • Update the year in the about.ini to the current year
  • Update the year in all feature.xml files to the current year for changed features
  • Update the year in copyright notices of changed source files: Install platform releng tools, Project context menu > Fix Copyrights

Backport changes to the Platform Specific Branches

  • Switch to branch
  • Select branched plug-ins, Team > Merge
    • End tag: HEAD
    • Start tag: Merged_e_3_4_m_3_x
    • Select Preview the merge in the synchronize perspective
    • Merge changes and resolve conflicts
    • Commit
  • Switch to head,
  • Tag branched plug-ins as Merged_e_3_4_m_3_x

Run Tests

The Release

Update Target

  • Update target files to point to release sites

Tag Sources

  • Tag the release as R_x_y_z (and R_x_y_z_e_3_3 if plug-ins are branched)

Prepare Build Environment

Checkout Sources

ssh [user]@build.eclipse.org
cvs -d :pserver:anonymous@dev.eclipse.org:/cvsroot/mylyn co .
ln -s org.eclipse.mylyn/org.eclipse.mylyn.releng ~/releng
org.eclipse.mylyn/org.eclipse.mylyn.releng/integration-build/prepare.sh
cd org.eclipse.mylyn/org.eclipse.mylyn.releng
  • Make sure your have Java 5.0 or later in your path. Settings for $HOME/.bashrc on build.eclipse.org:
export JAVA_HOME=/shared/tools/mylyn/tools/jdk

Build

  • Release build:
TYPE=release TIMESTAMP=20110608-1400 mvn -f org.eclipse.mylyn/org.eclipse.mylyn.releng/pom.xml clean deploy 
  • Snapshot build:
TYPE=weekly mvn -f org.eclipse.mylyn/org.eclipse.mylyn.releng/pom.xml clean deploy

Verify Update Site Contents

  • Check that only approved features are on the update site
  • Check that all Orbit bundles are tracked on approved CQs

Test Install

== Remove Old Integration Builds

rm ~/downloads/mylyn/archive/3.6.0/I*

Add Mirror URLs

cd ~/downloads/mylyn/archive/3.6.0/
~/releng/bin/update-metadata.sh
  • Check that the content.jar contains the following property:
<property name="p2.mirrorsURL" value="http://www.eclipse.org/downloads/download.php?file=/mylyn/archive/.../v.../&protocol=http&format=xml"/>

Copy Release to archive.eclipes.org

cp ~/downloads/mylyn/archive/3.6.0 /home/data/httpd/archive.eclipse.org/mylyn/archive

Update Release Repository Content

  • Update filters in ~/downloads/mylyn/releases/*/composite.index
  • Update release composite sites
cd ~/downloads/mylyn/releases/
~/releng/bin/create-composite.sh -r
  • Update snapshot composite sites
cd ~/downloads/mylyn/snapshots/
~/releng/bin/create-composite.sh -r

Update Website

  • Update the version number on download page
  • Create a new section on download archive page
  • Add a link to the new API baseline on the download archive page (major releases only)
  • Create a new section in the New & Noteworthy

Update Babel

  • Make release available in Eclipse Babel for translation (major releases only)

After the Release

Update Versions