You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jmeter.apache.org by Apache Wiki <wi...@apache.org> on 2012/12/11 02:27:38 UTC
[Jmeter Wiki] Update of "ReleaseCreation" by JMeterAdmin
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] ]
+ }}}
+