[Solr Wiki] Update of "HowToRelease2" by Mark Miller

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Solr Wiki" for change notification.

The "HowToRelease2" page has been changed by Mark Miller.
http://wiki.apache.org/solr/HowToRelease2

--------------------------------------------------

New page:
This page is to help a Solr committer create a new release. It does not reflect official release policy - many of the items may be optional, or may be modified as necessary.

<<TableOfContents>>

[[Tools]]
[[Suggestions]]

= Making a release =

 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/dev/trunk \
  https://svn.apache.org/repos/asf/lucene/dev/branches/branch-X.Y -m "Starting Solr X.Y branch."
}}}


 1. Check out the branch: 
 {{{
svn co https://svn.apache.org/repos/asf/lucene/dev/branches/branch-X.Y \
}}}
 || {i} ||Note: at the moment releases need to be done on a unix box or in a cygwin environment with unix linefeeds, because fixcrlf is only   done on the sources in the zip artifact.||

 1. Update the version numbers in common-build.xml on the branch:
  a. specversion should be set to X.Y.M.${dateversion}.
  a. version should be set to X.Y.N-dev.
  a. maven_version should be set to X.Y.N-SNAPSHOT.
  Where X.Y.M is the current release and X.Y.N is the next release.

 1. On the branch:
 {{{
ant -Dversion=X.Y.M -Dspecversion=X.Y.M -Dmaven_version=X.Y.M clean test
}}}

 1. Produce one or more release candidates.  
 || {i} ||Note: 3 +1 Lucene PMC votes are technically needed for a release, although Solr considers all votes equally. (see [[http://www.apache.org/foundation/voting.html#ReleaseVotes|voting]]).||


 {{{
ant -Dversion=X.Y.M -Dspecversion=X.Y.M -Dmaven_version=X.Y.M prepare-release 
}}}


 1. Upload dist/solr.tar to your public staging space on people.a.o.and send an email to solr-dev@ calling the vote.

 1. Tag the release:

 {{{
svn copy https://svn.apache.org/repos/asf/lucene/dev/branches/branch-X.Y \
   https://svn.apache.org/repos/asf/lucene/dev/tags/release-X.Y.M -m "Solr X.Y.M release."
}}}

 1. Copy release files to the distribution directory.
 {{{
scp -p dist/apache-solr-X.Y.M.tar.gz* people.apache.org:/www/www.apache.org/dist/lucene/solr/X.Y
scp -p dist/apache-solr-X.Y.M.zip* people.apache.org:/www/www.apache.org/dist/lucene/solr/X.Y
}}}
 1. Copy the Maven artifacts to the distribution directory (follow the existing directory structure), to have them pushed to the central Maven repositories:
 {{{
cp -R PATH_TO_ARTIFACTS/maven/org/apache/solr /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/
}}}

 1. Ensure that the most current keys file is on the distribution site:
 {{{
scp -p KEYS people.apache.org:/www/www.apache.org/dist/lucene/solr/
}}}


 1. Send announcements to the announce@apache.org, solr-user@, solr-dev@, and general@ lucene mailing lists. See the [[Sample Announcement]].