jmeter-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Jmeter Wiki] Update of "ReleaseCreation" by JMeterAdmin
Date Tue, 11 Dec 2012 01:27:38 GMT
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] ]
+ }}}
+ 

Mime
View raw message