You are viewing a plain text version of this content. The canonical link for it is here.
Posted to solr-commits@lucene.apache.org by Apache Wiki <wi...@apache.org> on 2007/02/14 06:53:30 UTC

[Solr Wiki] Update of "HowToRelease" by YonikSeeley

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:
graduation changes, etc

------------------------------------------------------------------------------
  ''This page is prepared for Solr committers. You need committer rights 
  to create a new  Solr release.''
  
- = Notes on Releases during incubation =
- 
-  * repository path prefix is https://svn.apache.org/repos/asf/lucene/.
-  * all version numbers in release artifacts must end in "-incubating" .. this is handled automatically by the build.xml via the `${incubation-suffix} property. /!\ :TODO: /!\ Update due to graduation.
- 
- = Misc Notes =
- 
-  * at some point in this process, the release date needs updated in teh CHANGES.txt file ... not sure when it should happen (before branching? on the branch and on the trunk?)
- 
  = Making a release. =
- 	1. Check if documentation needs an update.
+ 	1. Check if documentation needs an update, update release date in CHANGES.txt and add any necessary notes on upgrading.
  	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 or  patch submitted to the Lucene PMC
  	1. Commit these changes.
             '''Note:''' It is important to do this prior to the build so that it is reflected in the copy of the website included with the release for documentation purposes.
@@ -24, +15 @@

  }}}
             1. Create a new distribution directory: {{{people.apache.org:/www/www.apache.org/dist/lucene/solr/X.Y}}}
  	1. Check out the branch with: 		{{{svn co https://svn.apache.org/repos/asf/lucene/solr/branches/branch-X.Y \}}}
-            '''Note:''' at the moment releases need to be done on a unix box, because fixcrlf is only done on the sources in the zip artifact 
+            '''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 build.xml:
              * {{{specversion}}} should be set to `X.Y.M.${dateversion}`, where X.Y.M is the release being made.
              * {{{version}}} should be set to `X.Y.N-dev`, where N is one greater than the release being made.
@@ -39, +30 @@

     https://svn.apache.org/repos/asf/lucene/solr/tags/release-X.Y.M -m "Solr X.Y.M release."
  }}}
  	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 dist/apache-solr-X.Y.M-incubating.tgz.asc --detach-sig dist/apache-solr-X.Y.M-incubating.tgz}}}
+                 {{{gpg --armor --output dist/apache-solr-X.Y.M.tgz.asc --detach-sig dist/apache-solr-X.Y.M.tgz}}}
- 	        {{{gpg --armor --output dist/apache-solr-X.Y.M-incubating.zip.asc --detach-sig dist/apache-solr-X.Y.M-incubating.zip}}}
+ 	        {{{gpg --armor --output dist/apache-solr-X.Y.M.zip.asc --detach-sig dist/apache-solr-X.Y.M.zip}}}
          1. Copy release files to the distribution directory.
-                 {{{scp -p dist/apache-solr-X.Y.M-incubating.tar.gz* people.apache.org:/www/people.apache.org/dist/incubator/solr/X.Y}}}
-                 {{{scp -p dist/apache-solr-X.Y.M-incubating.zip* people.apache.org:/www/people.apache.org/dist/incubator/solr/X.Y}}}
-            After graduation, the place to copy releases to will be
-                 {{{scp -p dist/apache-solr-X.Y.M-incubating.tar.gz* people.apache.org:/www/www.apache.org/dist/lucene/solr/X.Y}}}
+                 {{{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-incubating.zip* 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. Ensure that the most current keys file is on the distribution site:
-            {{{scp -p KEYS.txt people.apache.org:/www/people.apache.org/dist/incubator/solr/}}}
+            {{{scp -p KEYS.txt people.apache.org:/www/people.apache.org/dist/lucene/solr/}}}
  	1. Start a new section in CHANGES.txt
  	1. Wait 24 hours for release to propagate to mirrors.
-            NOTE: only needed after graduation... www/people.apache.org/dist is not mirrored.
  	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}}}.
+ 	1. Update Javadoc in {{{people.apache.org:/www/lucene.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.
- 	1. Update [http://incubator.apache.org/projects/solr.html incubation status file]
+         1. Update other sites such as freshmeat
  
  = Related Resources =