Difference between revisions of "Mylyn/Release Howto"

Revision as of 14:02, 6 June 2011

Before the Release

Run AllTests

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

Internationalize source code

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

Update the 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

Backport changes to the Eclipse branches if necessary'

• • Update 3.4 workspace to the latest
  • 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
  • Tag branched plug-ins in 3.6 workspace (i.e. cvs head) with Merged_e_3_4_m_3_x
    • select Move tag if already exists
  • Repeat for 3.5 workspace

Tag projects and map files

The Release

Major releases only

• Tag the release as R_x_y_z and R_x_y_y_e_3_3

• Prepare the build environment

ssh [user]@build.eclipse.org
cvs -d :pserver:anonymous@dev.eclipse.org:/cvsroot/tools co org.eclipse.mylyn/org.eclipse.mylyn.releng
cd org.eclipse.mylyn/org.eclipse.mylyn.releng

• Adjust settings in local.properties as necessary. Settings for build.eclipse.org:

eclipse.base=/shared/tools/mylyn/tools
build.home=/shared/tools/mylyn/build
dist.home=/home/data/httpd/download.eclipse.org/tools/mylyn

• 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 the release:

ant weekly  # weekly builds
ant helios # signed integration builds that are published to the weekly and Helios update site
ant -Dqualifier=v20090909-0900 -Drelease=true helios # releases built from map files

• If signing times out:

ant sign
ant -Dtodir=weekly promote
ant -Dtodir=galileo promote-main 

• Update mylyn.build file for Helios builds

Major releases only

• Move the release from the weekly site to the main update site:

ssh [username]@build.eclipse.org
cd /shared/tools/mylyn/weekly
./promote.sh [major] [build]

• Update the version number on the download page
• Create a new section on the download archive page
• Add a link to the new API baseline on the download archive page if necessary
• Create a new section in the New & Noteworthy

When the build has propagated to mirrors

Major releases only

• Add the mirror attribute to all site.xml files and regenerate meta-data with correct update site identifiers:

ssh [username]@build.eclipse.org
cd /shared/tools/mylyn/weekly
./add-mirrors.sh
./generate-p2-metadata.sh

• Check that the site.xml files have the following URL set:

   mirrorsURL="http://www.eclipse.org/downloads/download.php?file=/tools/mylyn/update/[location]/site.xml&protocol=http&format=xml"

After the release

Major releases only

• For head and e3.3 branch: Replace version numbers in all MANIFEST.MF and feature.xml files, e.g. 2.3.0.qualifier -> 2.3.1.qualifier and 2.3.0.mylynQualifier -> 2.3.1.mylynQualifier
• Make sure changes are applied to the 3.3 branch as well as the 3.4 branch