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 TomWhite:
http://wiki.apache.org/lucene-hadoop/HowToRelease
The comment on the change is:
Added extra details supplied by Doug.
------------------------------------------------------------------------------
= Making a release. =
1. Check if documentation needs an update.
+ {{{cd src/docs; forrest; cp -pr build/site/* ../../docs}}}
- 1. Update news in {{{src/site/src/documentation/content/xdocs/index.xml}}}.
+ 1. Update news in ''src/site/src/documentation/content/xdocs/index.xml''.
- 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 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.
- 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 "Starting Hadoop
X.Y branch." }}}
+ {{{svn commit -m "Preparing for release X.Y.Z"}}}
+ 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" }}}
1. Check out the branch with: {{{svn co https://svn.apache.org/repos/asf/lucene/hadoop/branches/branch-X.Y
\}}}
+ 1. If the branch for the series already existed (i.e. release X.Y.Z where Z > 0), then
merge trunk into the branch and commit these changes.
+ {{{cd branch-X.Y; svn merge -rR1:R2 ../trunk .; svn commit}}}
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.
{{{ant -Dversion=X.Y.Z -Dcompile.native=true clean tar test}}}
1. Check that release file looks ok - e.g. install it and run examples from tutorial.
@@ -21, +27 @@
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}}}
1. Copy release files to the distribution directory.
+ {{{ssh people.apache.org mkdir /www/www.apache.org/dist/lucene/hadoop/hadoop-X.Y.Z}}}
- {{{scp -p hadoop-X.Y.Z.tar.gz* people.apache.org:/www/www.apache.org/dist/lucene/hadoop}}}
+ {{{scp -p hadoop-X.Y.Z.tar.gz* people.apache.org:/www/www.apache.org/dist/lucene/hadoop/hadoop-X.Y.Z}}}
+ 1. Archive old releases so that the top level release directory contains just two releases,
the most recent from two branches, with a link named 'stable' to the most recent recommended
version.
+ {{{ssh people.apache.org; cd /www/www.apache.org/dist/lucene/hadoop/}}}
+ {{{mv hadoop-A.B.C archive; rm stable; ln -s hadoop-A.B.D stable}}}
1. Wait 24 hours for release to propagate to mirrors.
1. Deploy new Hadoop site.
+ {{{ssh people.apache.org; cd /www/lucene.apache.org/hadoop; svn up}}}
1. Update Javadoc in {{{people.apache.org:/www/lucene.apache.org/hadoop/docs/api}}}.
1. Send announcements to the user and developer lists.
1. In Jira, close issues resolved in the release. Disable mail notifications for
this bulk change.
|