Dear Wiki user, You have subscribed to a wiki page or wiki category on "Lucene-hadoop Wiki" for change notification.
The following page has been changed by NigelDaley: http://wiki.apache.org/lucene-hadoop/HowToRelease The comment on the change is: formatting changes ------------------------------------------------------------------------------ 1. In trunk update news in {{{src/docs/src/documentation/content/xdocs/releases.xml}}}. If releasing from an existing branch, merge this change to the release branch. 1. From trunk regenerate the documentation. - {{{cd src/docs; forrest; cp -pr build/site/* ../../docs}}} + {{{ + cd src/docs + forrest + cp -pr build/site/* ../../docs + }}} 1. Update version number in {{{build.xml}}} to be ''hadoop-X.Y.N-dev'', where ''N'' is one greater than the release being made. 1. Update {{{CHANGES.txt}}} to include the release version and date. 1. Commit these changes. + {{{ - {{{svn commit -m "Preparing for release X.Y.Z"}}} + svn commit -m "Preparing for release X.Y.Z" + }}} = Branching & Merging = 1. If this is the first release in a series (i.e. release X.Y.0), then create a branch for the series: - {{{svn copy https://svn.apache.org/repos/asf/lucene/hadoop/trunk \}}} {{{https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y -m "Branching for X.Y releases" }}} + {{{ + svn copy https://svn.apache.org/repos/asf/lucene/hadoop/trunk \ + https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y -m "Branching for X.Y releases" + }}} 1. After branching the new release series, update the default version in build.xml on trunk to X.Y+1.0-dev. + 1. Check out the branch with: + {{{ - 1. Check out the branch with: {{{svn co https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y}}} + svn co https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y + }}} 1. Merge desired patches from trunk into the branch and commit these changes. You can find the revision numbers using {{{svn log CHANGES.txt}}} in the branch and in trunk. - {{{cd branch-X.Y; svn merge -rR1:R2 ../trunk .;}}} + {{{ + cd branch-X.Y + svn merge -rR1:R2 ../trunk . - {{{svn commit -m "Merge -r R1:R2 from trunk to X.Y branch. Fixes: HADOOP-A, HADOOP-B."}}} + svn commit -m "Merge -r R1:R2 from trunk to X.Y branch. Fixes: HADOOP-A, HADOOP-B." + }}} + = Building = 1. Build the release & run unit tests. Note that releases are normally built on 32-bit Linux, so that they include the native code for that platform. Also, folks who build releases should install eclipse, so that the eclipse plugin can be included in releases, pre-compiled. + {{{ - {{{ant -Dversion=X.Y.Z -Dcompile.native=true -Dcompile.c++=true -Declipse.home=/usr/lib/eclipse clean package-libhdfs tar test test-libhdfs}}} + ant -Dversion=X.Y.Z -Dcompile.native=true -Dcompile.c++=true -Declipse.home=/usr/lib/eclipse clean package-libhdfs tar test test-libhdfs + }}} 1. Check that release file looks ok - e.g. install it and run examples from tutorial. 1. Generate the MD5 checksum of the release file. + {{{ - {{{md5sum hadoop-X.Y.Z.tar.gz > hadoop-X.Y.Z.tar.gz.md5}}} + md5sum hadoop-X.Y.Z.tar.gz > hadoop-X.Y.Z.tar.gz.md5 + }}} 1. Sign the release (see [http://www.apache.org/dev/mirror-step-by-step.html?Step-By-Step Step-By-Step Guide to Mirroring Releases] for more information). + {{{ - {{{gpg --armor --output hadoop-X.Y.Z.tar.gz.asc --detach-sig hadoop-X.Y.Z.tar.gz}}} + gpg --armor --output hadoop-X.Y.Z.tar.gz.asc --detach-sig hadoop-X.Y.Z.tar.gz + }}} 1. Copy release files to a public place. + {{{ - {{{ssh people.apache.org mkdir public_html/hadoop-X.Y.Z-candidate-0}}} + ssh people.apache.org mkdir public_html/hadoop-X.Y.Z-candidate-0 - {{{scp -p hadoop-X.Y.Z.tar.gz* people.apache.org:public_html/hadoop-X.Y.Z-candidate-0}}} + scp -p hadoop-X.Y.Z.tar.gz* people.apache.org:public_html/hadoop-X.Y.Z-candidate-0 + }}} 1. Call a release vote on hadoop-dev at lucene.apache.org. = Publishing = Once [http://www.apache.org/foundation/voting.html#ReleaseVotes three PMC members have voted for a release], it may be published. 1. Tag the release: - {{{svn copy https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y \}}} {{{https://svn.apache.org/repos/asf/lucene/hadoop/tags/release-X.Y.Z -m "Hadoop X.Y.Z release." }}} + {{{ + svn copy https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y \ + https://svn.apache.org/repos/asf/lucene/hadoop/tags/release-X.Y.Z -m "Hadoop X.Y.Z release." + }}} 1. Copy release files to the distribution directory. {{{ ssh people.apache.org
