...

svn co https://svn.apache.org/repos/asf/jmeter/trunk jmeter_2.v2_7_RC1RC2

• Move to new workspace:

cd jmeter_v2_2.7_RC1RC2

• update the versions version / year in the new workspace: JMeterVersion.java (version and year) , build.xml (version) and NOTICE (year)
  • ./src/core/org/apache/jmeter/util/JMeterVersion.java:
    • section: private static final String VERSION = "2.7";
    • section: private static final String COPYRIGHT = "Copyright (c) 1998-2012 The Apache Software Foundation";
  • ./build.xml:
    • section: <property name="jmeter.version" value="2.7"/>
    ./NOTICE:
    • section: Copyright 1998-2012 The Apache Software Foundation
• update xdocs/download_jmeter.xml to the new version
  • section: <!ENTITY release '2.7'>
• Download external jars

...

ant clean-docs
ant docs-site
ant docs-api -Djmeter.version=2.7

• commit docs changes

svn commit -m "Prepare next release 2.7: update docs tree and overview"

• update now the version for build.xml (remove -SNAPSHOT)
  • ./build.xml:
    • section: <property name="jmeter.version" value="2.7"/>
• create the new RC tag, e.g. v2_7_RC1 RC2 from the workspace(Problem to fix: update overview.html is make by the ant distribution task)

svn copy . https://svn.apache.org/repos/asf/jmeter/tags/v2_7_RC1RC2

• this will create the tag from the contents of the workspace. Only the updated files will be shown in the commit message; most files will be shown as being copied from trunk.
  • N.B. Tags must be immutable, i.e. must not be changed once created. A tag can be deleted if it is no longer needed, but must not be recreated.
    • If there is a problem with the contents of an RC tag, create a new tag, for example v2_7_RC2
    • If the tag is part of an ongoing release vote, do not delete it whilst the vote is ongoing, even if the vote is now using a later tag. It can be useful to be able to compare the contents of tags as part of the voting process.
    • Once the release vote is over, intermediate tags are no longer needed, and can be deleted.
    • If the tag has not been used in a release vote, it can be deleted immediately.

...

ant -Djmeter.version=2.7 -Duser.name=username@apache.org distribution

• test the new binaries (move/extract binaries in a temporary directory outside the workspace)
  • GUI and non-GUI using host with graphic capability
  • non-GUI only using host with no graphic capability
  • ideally test on minimum supported Java and latest Java - especially for GUI
    
    

Generate Release

• If tests are ok, from the workspace jmeter_v2_7_RC2
  • (
  THIS NEEDS FIXING;
  • no need to fetch the tag again, as we already have a clean workspace
  *
  

Generate Release

• extract files from SVN using the RC tag into a new directory tree

svn co https://svn.apache.org/repos/asf/jmeter/tags/v2_7_RC1 jmeter_v2_7_RC1

• Move to new directory:

cd jmeter_v2_7_RC1/

• download jars needed to build: "ant download_jars"

ant download_jars

• create distribution files:
  • Distribution ant task: ant distribution -lib=<libextra> -Djmeter.version=m.n -Duser.name=user-AT-apache.org

ant distribution -Djmeter.version=2.7 -Duser.name=username@apache.org

• • )
• sign distribution files and maven files via ant tasks:

...

• Go to Apache Repository
  • Section Staging Repositories
    • Check the RC box, add click on Close button (see Closing a staging repository)
  • You will receive a email with JMeter Maven Repo URLs
    • The main URL must be added to email vote.
      
• Generate RAT report (example on Linux with Java)

cd dist/
java -jar $RAT_HOME/apache-rat-0.8.jar ./apache-jmeter-2.7.tgz > rat-report-jmeter-2.7RC17RC2.txt
unix2dos rat-report-jmeter-2.7RC17RC2.txt

Checks to do before send vote email

• to do: add some checks (zip/tgz binary files vs src files, etc.)
• review RAT report
  

Vote on release

• Login to people.apache.org in SSH
• Create temporary location to receive dist files

mkdir -p ~/JMETERjmeter_2v2_7_RC1RC2/dist/

• From your computer, upload dist files and RAT report to the temporary location (e.g. personal dir: ~/JMETERjmeter_2v2_7_RC1RC2/dist/) in people.apache.org
  
• Return to people.apache.org
• Preparation RC publishing

mkdir -p ~/public_html/jmeter-2.7RC17RC2/dist/

• copy archives, sigs and hashes to dist

cp ~/JMETERjmeter_2v2_7_RC1RC2/dist/* ~/public_html/jmeter-2.7RC17RC2/dist/

• check hashes (before / after uploads)
  
  • Install the site docs:

cd ~/public_html/jmeter-2.7RC17RC2/
svn co https://svn.apache.org/repos/asf/jmeter/tags/v2_7_RC1RC2/docs docs

• Extract Javadocs: unzip -x jmeter-m.n.o.zip '*/docs/api/*' and move to docs/api
  • Example:

cd $HOME
cp  ~/public_html/jmeter-2.7RC17RC2/dist/apache-jmeter-2.7.tgz $HOME
tar xfz apache-jmeter-2.7.tgz
cd apache-jmeter-2.7/docs/
mv api ~/public_html/jmeter-2.7RC17RC2/docs/api
cd $HOME
rm -r $HOME/apache-jmeter-2.7

...

svn copy https://svn.apache.org/repos/asf/jmeter/tags/v2_7_RC1RC2 https://svn.apache.org/repos/asf/jmeter/tags/v2_7

...

cd ~/public_html/jmeter-2.7RC17RC2/dist

• Make sure that file group is set to jmeter (chgrp jmeter apache-jmeter*)

...

cd /www/jmeter.apache.org/
rm -r /www/jmeter.apache.org/api
cd ~/public_html/jmeter-2.7RC17RC2/docs
cp -R api /www/jmeter.apache.org
chmod -R g+w /www/jmeter.apache.org/api

...