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 =