[Solr Wiki] Update of "HowToRelease" by YonikSeeley

[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 following page has been changed by YonikSeeley:
http://wiki.apache.org/solr/HowToRelease

The comment on the change is:
copied HowToRelease template from Hadoop - thanks Doug!

New page:
''This page is prepared for Solr committers. You need committer rights 
to create a new  Solr release.''

= Making a release. =
	1. Check if documentation needs an update.
	1. Update news in {{{src/site/src/documentation/content/xdocs/index.xml}}} and for main lucene.apache.org site stored at https://svn.apache.org/repos/asf/lucene/site/. The second change may require additional rights.
	1. Commit these changes.
	1. If this is the first release in a series (i.e. relase X.Y.0), then create a branch for the series: 		{{{svn copy https://svn.apache.org/repos/asf/lucene/solr/trunk \}}} 			{{{https://svn.apache.org/repos/asf/lucene/solr/branches/branch-X.Y -m "Starting Solr X.Y branch." }}}	
	1. Check out the branch with: 		{{{svn co https://svn.apache.org/repos/asf/lucene/solr/branches/branch-X.Y \}}}
	1. Update version number in build.xml to be X.Y.N-dev, where N is one greater than the release being made.
	1. Commit build.xml.
	1. Run unit tests.
		 {{{ant clean test}}}
	1. Build the release.
		 {{{ant -Dversion=X.Y.Z package}}}
                 NOTE: while in the incubator, releases must have incubating in the name.
		 {{{ant -Dversion=X.Y.Z-incubating package}}}
	1. Check that release file looks ok - e.g. install it and run example.
	1. Tag the release:
		{{{svn copy https://svn.apache.org/repos/asf/lucene/solr/branches/branch-X.Y \}}} 			{{{https://svn.apache.org/repos/asf/lucene/solr/tags/release-X.Y.Z -m "Solr X.Y.Z release." }}}
        1. Generate the MD5 checksum of the release file.
                {{{md5sum apache-solr-X.Y.Z.tar.gz > apache-solr-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 apache-solr-X.Y.Z.tar.gz.asc --detach-sig apache-solr-X.Y.Z.tar.gz}}}
	1. Copy release files to the distribution directory.
                {{{scp -p apache-solr-X.Y.Z.tar.gz* people.apache.org:/www/www.apache.org/dist/lucene/solr}}}
	1. Wait 24 hours for release to propagate to mirrors.
	1. Deploy new Solr site.
	1. Deploy new main Lucene site.
	1. Update Javadoc in {{{people.apache.org:/www/incubator.apache.org/solr/docs/api}}}.
           NOTE: skip this for now, as this javadoc is currently updated automatically from the nightly build
	1. Send announcements to the user and developer lists.