Dear Wiki user, You have subscribed to a wiki page or wiki category on "Jmeter Wiki" for change notification.
The "ReleaseCreation" page has been changed by JMeterAdmin: http://wiki.apache.org/jmeter/ReleaseCreation?action=diff&rev1=50&rev2=51 Comment: Initial update to allow for change to SvnPubSub. Needs more work. '''DRAFT''' = Requirements = - * a Java JDK in according with target JDK (java 5 for JMeter 2.8) + * a Java JDK in according with target JDK (Java 5 for JMeter 2.8) - * a recent ant binary (1.8+) + * a recent Ant binary (1.8+) - * subversion (svn) installed + * subversion (svn) client installed; the command-line utility svnmucc is needed (it should be included in the svn client installation, but please check) * a text editor * hostname must resolve to ip address (not loopback) * Internet access @@ -20, +20 @@ {{{ svn co https://svn.apache.org/repos/asf/jmeter/trunk jmeter_v2_8_RC1 }}} - * Move to new workspace: + * Move to the new workspace: {{{ cd jmeter_v2_8_RC1 }}} @@ -85, +85 @@ ant _dist_maven -Djmeter.version=2.8 ant sign_dist -Dgpg.keyname=0612B399 -Dgpg.secretKeyring=~/.gnupg/secring.gpg }}} - * Upload to Maven repository: + * Upload Maven files to Maven repository: {{{ ant maven_upload -Djmeter.version=2.8 -DrepoType=releases }}} @@ -102, +102 @@ unix2dos rat-report-jmeter-2.8RC1.txt }}} - = Checks to do before send vote email = + = Checks to do before sending vote email = * review RAT report * to do: add some checks (zip/tgz binary files vs src files, SVN tree vs SRC files, etc.) == Check: JMeter SVN tree vs JMeter archive sources == + + TODO: simplify this checking process and extend to Windows. + For JMeter sources, need a Linux box, SVN (apache) and GIT (local). Export the RC tags to a temporay directory. @@ -150, +153 @@ After all checks, you can remove the temporary directories. + = Upload release artifacts to staging directory = + + JMeter releases are now published using svnpubsub. + For release votes, the files are uploaded to the dev/jmeter tree at https://dist.apache.org/repos/dist/dev/jmeter/ + If the vote succeeds, they are renamed to the release directory at https://dist.apache.org/repos/dist/release/jmeter/ which is automatically published to the ASF mirror system. + + {{{ + ant RC_upload -DRC=RCn -DrepoType=live [-Dasf.ldap.password=secret [-Dasf.ldap.usermame=user] ] + }}} + + The files should now be available under https://dist.apache.org/repos/dist/dev/jmeter/ + = Vote on release = + *** This section is outdated *** - * Login to people.apache.org in SSH - * Create temporary location to receive dist files - {{{ - mkdir -p ~/jmeter_v2_8_RC1/dist/ - }}} - - * '''From your computer''', upload dist files and RAT report to the temporary location (e.g. personal dir: ~/jmeter_v2_8_RC1/dist/) in people.apache.org - cd ./dist/ - scp apache-jmeter-2.8* minautor:/home/milamber/jmeter_v2_8_RC1/dist/ - scp rat-report-jmeter-2.8RC1.txt minautor:/home/milamber/jmeter_v2_8_RC1/dist/ - - * Return to people.apache.org - * Preparation RC publishing - {{{ - mkdir -p ~/public_html/jmeter-2.8RC1/dist/ - }}} - * copy archives, sigs and hashes to dist - {{{ - cp ~/jmeter_v2_8_RC1/dist/* ~/public_html/jmeter-2.8RC1/dist/ - }}} - - * check hashes (before / after uploads) - - == MD5 checks (local) == - Example, on local Linux box: - {{{ - cd /release_dir/dist - find . -name "*.md5" -exec cat {} \; -exec echo "" \; - }}} - Results (copy/paste to email vote): - {{{ - 98838d5dc4f2b735b522abc8425aec0d *apache-jmeter-2.8_src.zip - 9a1740e7828a4d25e439934974672b8b *apache-jmeter-2.8.tgz - b5283a2099fe4186f8978a3ccfb4e8d6 *apache-jmeter-2.8_src.tgz - ca70cf7fdf8b98ded1dc0494bdc9de14 *apache-jmeter-2.8.zip - }}} - == After upload on people.apache.org == - Check MD5 sums on people.apache.org, with bash shell, check the md5 files sum vs files .md5 hashes. - {{{ - cd ~/public_html/jmeter-2.8RC1/dist/ - }}} - Copy/paste all lines in one time - {{{ - LIST=`find . -regex ".*\.zip" -or -regex ".*\.tgz"` - for ARCHIVE in ${LIST} ; - do - if test `awk '{ print $1 }' ${ARCHIVE}.md5` = `md5 -q ${ARCHIVE}`; then - echo MD5 OK; - else - echo MD5 checksum KO; - fi; - done - }}} - Good results are: - {{{ - MD5 OK - MD5 OK - MD5 OK - MD5 OK - }}} * Install the site docs: {{{ @@ -241, +197 @@ }}} = Move RC dist files to release = - * Connect to people.apache.org in SSH - * Go to RC dist repository (e.g. personal dir) + + This is done using svnmnucc. + It moves the files from the staging director https://dist.apache.org/repos/dist/dev/jmeter/ to the live are at https://dist.apache.org/repos/dist/release/jmeter/ + {{{ - cd ~/public_html/jmeter-2.8RC1/dist + ant RC_publish -DRC=RCn -DrepoType=live [-Dasf.ldap.password=secret [-Dasf.ldap.usermame=user] ] }}} - * Make sure that file group is set to jmeter (chgrp jmeter apache-jmeter*) + + + = Update main distribution files = + * Checkout the top-level of the live dist project on your computer: {{{ + svn co --depth files https://dist.apache.org/repos/dist/release/jmeter/ dist-jmeter - chgrp jmeter apache-jmeter* - chmod g+w apache-jmeter* }}} - * copy archives to /www/www.apache.org/dist/jmeter/binaries and /www/www.apache.org/dist/jmeter/source as appropriate + * Edit HEADER.html to modifiy with new version number + * If necessary, add your GPG public key to KEYS + * Commit with svn {{{ + svn commit -m "JMeter 2.8 release - Prepare update site" dist-jmeter - cp apache-jmeter-2.8_src* /www/www.apache.org/dist/jmeter/source - cp apache-jmeter-2.8.zip* /www/www.apache.org/dist/jmeter/binaries - cp apache-jmeter-2.8.tgz* /www/www.apache.org/dist/jmeter/binaries }}} - * check files are visible and downloadable from www.apache.org (2+ hours) - * http://www.apache.org/dist/jmeter/binaries/ - * http://www.apache.org/dist/jmeter/source/ * '''wait a day''' or so for mirrors to catch up - - - - = Update Site dist = - * Checkout dist project on your computer - {{{ - svn co https://svn.apache.org/repos/asf/jmeter/dist dist-jmeter - }}} - * Edit HEADER.html to modifiy with new version number - * Optional, add your GPG public key to KEYS - * Commit with svn - {{{ - svn commit -m "JMeter 2.8 release - Prepare update site" - }}} - * Login to people.apache.org in SSH - * Go to dist dir: - {{{ - cd /www/www.apache.org/dist/jmeter - }}} - * Execute a svn update - {{{ - svn update - }}} - = Update JMeter site = + This is now done using svnmucc. Create a script - for example "updatesite.txt" - containing the following: - {{{ - svn copy https://svn.apache.org/repos/asf/jmeter/tags/v2_8 https://svn.apache.org/repos/asf/jmeter/branches/docs-2.8 -m "Create branch docs 2.8" - }}} - * login to people.apache.org - * Go to: {{{ + rm + https://svn.apache.org/repos/asf/jmeter/site + + cp + HEAD - cd /www/jmeter.apache.org/ - }}} - * fetch site from SVN: - * `svn switch http://svn.apache.org/repos/asf/jmeter/tags/vm_n_o/docs` - * Example: - {{{ - svn switch http://svn.apache.org/repos/asf/jmeter/branches/docs-2.8/docs + https://svn.apache.org/repos/asf/jmeter/branches/docs-2.8/docs + https://svn.apache.org/repos/asf/jmeter/site }}} - * If the documentation needs to be updated between releases, create a branch docs-vm_n_o from the tag and switch to that - * for later updates, use "svn switch" or "svn update" as appropriate (use svn info to find current setting) - * The Javadocs are not in SVN so these need to be copied from the staging area - * Example: + + Change the /docs-2.8/ path segment above as appropriate! + + Now use svnmucc to update the live site: {{{ + svnmucc -m "Create branch docs 2.8" -X updatesite.txt - cd /www/jmeter.apache.org/ - rm -r /www/jmeter.apache.org/api - cd ~/public_html/jmeter-2.8RC1/docs - cp -R api /www/jmeter.apache.org - chmod -R g+w /www/jmeter.apache.org/api }}} - * N.B. wait for few hours so site updates catch up + + The SvnPubSub system will update the live site within a few seconds. = Maven Release = * Go to [[https://repository.apache.org/|Apache Repository]] @@ -341, +267 @@ = Tidy up = - * remove old archives from /www/www.apache.org/jmeter/dist + * a few days after the release has been announced, remove any superseded releases from the ninaries and source directories under https://dist.apache.org/repos/dist/release/jmeter/ using the following command: + {{{ + ant release_delete -Djmeter.old.version=2.7 -DrepoType=live [-Dasf.ldap.password=secret [-Dasf.ldap.usermame=user] ] + }}} +
