You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mahout.apache.org by bu...@apache.org on 2013/11/19 20:24:48 UTC
svn commit: r887260 - in /websites/staging/mahout/trunk/content: ./
developers/how-to-release.html
Author: buildbot
Date: Tue Nov 19 19:24:47 2013
New Revision: 887260
Log:
Staging update by buildbot for mahout
Modified:
websites/staging/mahout/trunk/content/ (props changed)
websites/staging/mahout/trunk/content/developers/how-to-release.html
Propchange: websites/staging/mahout/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Nov 19 19:24:47 2013
@@ -1 +1 @@
-1543533
+1543536
Modified: websites/staging/mahout/trunk/content/developers/how-to-release.html
==============================================================================
--- websites/staging/mahout/trunk/content/developers/how-to-release.html (original)
+++ websites/staging/mahout/trunk/content/developers/how-to-release.html Tue Nov 19 19:24:47 2013
@@ -381,7 +381,8 @@
<div id="content-wrap" class="clearfix">
<div id="main">
- <p><em>This page is prepared for Mahout committers. You need committer rights to
+ <h1 id="how-to-release-mahout">How To Release Mahout</h1>
+<p><em>This page is prepared for Mahout committers. You need committer rights to
create a new Mahout release.</em></p>
<p><a name="HowToRelease-ReleasePlanning"></a></p>
<h1 id="release-planning">Release Planning</h1>
@@ -427,7 +428,7 @@ upcoming version number listed as the "F
</ol>
<p><a name="HowToRelease-Makingarelease"></a></p>
<h2 id="making-a-release">Making a release</h2>
-<ol>
+<ul>
<li>Check if documentation needs an update</li>
<li>Update the web site's news by updating a working copy of the SVN
directory at https://svn.apache.org/repos/asf/mahout/site/new_website</li>
@@ -442,153 +443,154 @@ http://www.apache.org/dev/release-signin
<li>Ensure you have set up standard Apache committer settings in
~/.m2/settings.xml as per <a href="http://maven.apache.org/developers/committer-settings.html">this page</a>
.</li>
-<li>Add a profile to your ~/.m2/settings.xml in the <profiles> section with:
- {code}
+<li>Add a profile to your ~/.m2/settings.xml in the <profiles> section with:</li>
+</ul>
+<p><blockquote>
<profiles>
<profile>
<id>mahout_release</id>
<properties>
<gpg.keyname>YOUR PGP KEY NAME</gpg.keyname>
- <gpg.passphrase>YOUR SIGNING PASSCODE HERE</gpg.passphrase></li>
-</ol>
+ <gpg.passphrase>YOUR SIGNING PASSCODE HERE</gpg.passphrase></p>
<p><deploy.altRepository>mahout.releases::default::https://repository.apache.org/service/local/staging/deploy/maven2/</deploy.altRepository>
<username>USERNAME</username></p>
<p><deploy.url>https://repository.apache.org/service/local/staging/deploy/maven2/</deploy.url>
</properties>
</profile>
- </profiles></p>
-<div class="codehilite"><pre> <span class="c"># You may also need to add the following to the <servers> section in</span>
-</pre></div>
-
-
-<p>~/.m2/settings.xml in order to upload artifacts (as the -Dusername=
--Dpassword= didn't work for Grant for 0.8, but this did):</p>
-<p><server>
+ </profiles>
+</blockquote></p>
+<ul>
+<li>
+<p>You may also need to add the following to the <servers> section in
+~/.m2/settings.xml in order to upload artifacts (as the -Dusername=
+-Dpassword= didn't work for Grant for 0.8, but this did):
+<blockquote>
+<server>
<id>apache.releases.https</id>
<username>USERNAME</username>
<password>PASSWORD</password>
-</server></p>
-<div class="codehilite"><pre> <span class="c"># Set environment variable MAVEN_OPTS to -Xmx1024m to ensure the tests can</span>
-</pre></div>
-
-
-<p>run
- # export _JAVA_OPTIONS="-Xmx1g"
- # If you are outside the US, then svn.apache.org may not resolve to the
+</server>
+</blockquote></p>
+</li>
+<li>
+<p>Set environment variable MAVEN_OPTS to -Xmx1024m to ensure the tests can
+run</p>
+</li>
+<li>export _JAVA_OPTIONS="-Xmx1g"</li>
+<li>If you are outside the US, then svn.apache.org may not resolve to the
main US-based Subversion servers. (Compare the IP address you get for
svn.apache.org with svn.us.apache.org to see if they are different.) This
will cause problems during the release since it will create a revision and
then immediately access, but, there is a replication lag of perhaps a
minute to the non-US servers. To temporarily force using the US-based
server, edit your equivalent of /etc/hosts and map the IP address of
-svn.us.apache.org to svn.apache.org.
- # Create the release candidate: {{mvn -Pmahout_release release:prepare release:perform}}. If you have problems authenticating to svn.apache.org, try adding to the command line {{-Dusername=[user]
+svn.us.apache.org to svn.apache.org.</li>
+<li>Create the release candidate: {{mvn -Pmahout_release release:prepare release:perform}}. If you have problems authenticating to svn.apache.org, try adding to the command line {{-Dusername=[user]
-Dpassword=[password]}}. If it screws up, do not clean or release:clean
without first trying to do: release:rollback. This will likely save you
time and do the right thing. If it doesn't work, then do clean and
release:clean and also delete the tag from svn, if it was created. You may
also have to rollback the version numbers in the POM files.
( If you want to skip test cases while rebuilding, use mvn
--DpreparationGoals="clean compile" release:prepare release:perform)
- # Review the artifacts, etc. on the Apache Repository (using Sonatype's
+-DpreparationGoals="clean compile" release:prepare release:perform)</li>
+<li>Review the artifacts, etc. on the Apache Repository (using Sonatype's
Nexus application) site: https://repository.apache.org/.
You will need to login using your ASF SVN credentials and then
-browse to the staging area.
- # Once you have reviewed the artifacts, you will need to "Close" out
+browse to the staging area.</li>
+<li>Once you have reviewed the artifacts, you will need to "Close" out
the staging area under Nexus, which then makes the artifacts available for
-others to see.
- ## Log in to Nexus
- ## Click the Staging Repositories link in the left hand menu
- ## Click the Mahout staged one that was just uploaded by the
-release:perform target
- ## Click Close in the toolbar. See
+others to see.<ul>
+<li>Log in to Nexus</li>
+<li>Click the Staging Repositories link in the left hand menu</li>
+<li>Click the Mahout staged one that was just uploaded by the
+release:perform target</li>
+<li>Click Close in the toolbar. See
https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository
-for a picture
- ## Copy the "Repository URL" link to your email; it should be like
-https://repository.apache.org/content/repositories/orgapachemahout-024/
- # Call a VOTE on dev@mahout.apache.org. Votes require 3 days before
+for a picture</li>
+<li>Copy the "Repository URL" link to your email; it should be like
+https://repository.apache.org/content/repositories/orgapachemahout-024/</li>
+</ul>
+</li>
+<li>Call a VOTE on dev@mahout.apache.org. Votes require 3 days before
passing. See Apache [release policy|http://www.apache.org/foundation/voting.html#ReleaseVotes]
- for more info.
- # If there's a problem, you need to unwind the release and start all
+ for more info.</li>
+<li>If there's a problem, you need to unwind the release and start all
over.
- {panel}
+ <blockquote>
mvn -Pmahout_release versions:set -DnewVersion=PREVIOUS_SNAPSHOT
mvn -Pmahout_release versions:commit
svn commit
svn rm https://svn.apache.org/repos/asf/mahout/tags/mahout-VERSION
- {panel}<br />
- # Release the artifact in the Nexus Repository in the same way you
-Closed it earlier.
- # Add your key to the KEYS file at
-http://www.apache.org/dist/mahout/<version>/
- # Copy the assemblies and their supporting files (tar.gz, zip, tar.bz2,
+ </blockquote></li>
+<li>Release the artifact in the Nexus Repository in the same way you
+Closed it earlier.</li>
+<li>Add your key to the KEYS file at
+http://www.apache.org/dist/mahout/<version>/</li>
+<li>Copy the assemblies and their supporting files (tar.gz, zip, tar.bz2,
plus .asc, .md5, .pom, .sha1 files) to the ASF mirrors at:
people.apache.org:/www/www.apache.org/dist/mahout/<version>/. You should
make sure the group "mahout" owns the files and that they are read only
(-r--r--r-- in UNIX-speak). See [Guide To Distributing Existing Releases Through The ASF Mirrors|http://jakarta.apache.org/site/convert-to-mirror.html?Step-By-Step]
- and the links that are there.
- ## cd /www/www.apache.org/dist/mahout
- ## mkdir <VERSION>
- ## cd <VERSION>
- ## wget -e robots=off --no-check-certificate -np -r
-https://repository.apache.org/content/groups/public/org/apache/mahout/mahout-distribution/<VERSION>/
- ## mv
+ and the links that are there.<ul>
+<li>cd /www/www.apache.org/dist/mahout</li>
+<li>mkdir <VERSION></li>
+<li>cd <VERSION></li>
+<li>wget -e robots=off --no-check-certificate -np -r
+https://repository.apache.org/content/groups/public/org/apache/mahout/mahout-distribution/<VERSION>/</li>
+<li>mv
repository.apache.org/content/groups/public/org/apache/mahout/mahout-distribution/0.8/*
-.
- ## rm -rf repository.apache.org/
- ## rm index.html
- # Wait 24 hours for release to propagate to mirrors.
- # Clean up JIRA: Bulk close all X.Y JIRA issues. Mark the Version
+.</li>
+<li>rm -rf repository.apache.org/</li>
+<li>rm index.html</li>
+</ul>
+</li>
+<li>Wait 24 hours for release to propagate to mirrors.</li>
+<li>Clean up JIRA: Bulk close all X.Y JIRA issues. Mark the Version
number as being released (see Manage Versions.) Add the next version
-(X.Y+1) if necessary.
- # Update release version on http://mahout.apache.org/ and
+(X.Y+1) if necessary.</li>
+<li>Update release version on http://mahout.apache.org/ and
http://en.wikipedia.org/wiki/Apache_Mahout
- ##
-https://cwiki.apache.org/confluence/display/MAHOUT/How+To+Update+The+Website
- # Send announcements to the user and developer lists.</p>
-<div class="codehilite"><pre><span class="n">See</span> <span class="n">also</span><span class="p">:</span>
- <span class="o">*</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">maven</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">developers</span><span class="o">/</span><span class="n">release</span><span class="o">/</span><span class="n">releasing</span><span class="p">.</span><span class="n">html</span>
- <span class="o">*</span>
-</pre></div>
-
-
-<p>http://www.sonatype.com/books/nexus-book/reference/staging-sect-deployment.html
- * http://www.sonatype.com/books/nexus-book/reference/index.html</p>
-<div class="codehilite"><pre><span class="n">h2</span><span class="p">.</span> <span class="n">Post</span> <span class="n">Release</span>
-<span class="n">h3</span><span class="p">.</span> <span class="n">Versioning</span>
- <span class="o">*</span> <span class="n">Create</span> <span class="n">the</span> <span class="n">next</span> <span class="n">version</span> <span class="n">in</span> <span class="n">JIRA</span> <span class="p">(</span><span class="k">if</span> <span class="n">it</span> <span class="n">doesn</span><span class="o">'</span><span class="n">t</span> <span class="n">already</span> <span class="n">exist</span><span class="p">)</span>
- <span class="o">*</span> <span class="n">Mark</span> <span class="n">the</span> <span class="n">version</span> <span class="n">as</span> "<span class="n">released</span>" <span class="n">in</span> <span class="n">JIRA</span> <span class="p">(</span><span class="n">noting</span> <span class="n">the</span> <span class="n">release</span> <span class="n">date</span><span class="p">)</span>
-
-<span class="n">h3</span><span class="p">.</span> <span class="n">Documentation</span>
- <span class="o">*</span> <span class="n">Change</span> <span class="n">wiki</span> <span class="n">to</span> <span class="n">match</span> <span class="n">current</span> <span class="n">best</span> <span class="n">practices</span> <span class="p">(</span><span class="n">remove</span><span class="o">/</span><span class="n">change</span> <span class="n">deprecations</span><span class="p">,</span>
-</pre></div>
-
-
-<p>etc)</p>
-<div class="codehilite"><pre><span class="n">h3</span><span class="p">.</span> <span class="n">Publicity</span>
- <span class="o">*</span> <span class="n">update</span> <span class="n">freshmeat</span>
- <span class="o">*</span> !<span class="n">TheServerSide</span> <span class="n">blurb</span>
- <span class="o">*</span> <span class="n">blog</span> <span class="n">away</span>
- <span class="o">*</span> <span class="n">Update</span> <span class="n">MLOSS</span> <span class="n">entry</span><span class="p">:</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">mloss</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">revision</span><span class="o">/</span><span class="n">view</span><span class="o">/</span>387<span class="o">/</span><span class="p">.</span> <span class="n">See</span> <span class="n">Grant</span> <span class="k">for</span>
-</pre></div>
-
-
-<p>details.</p>
-<div class="codehilite"><pre><span class="n">h1</span><span class="p">.</span> <span class="n">Related</span> <span class="n">Resources</span>
-
- <span class="o">*</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span>#<span class="n">releases</span>
- <span class="o">*</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span>#<span class="n">mirror</span>
-
-<span class="n">h1</span><span class="p">.</span> <span class="p">:</span><span class="n">TODO</span><span class="p">:</span> <span class="n">Things</span> <span class="n">To</span> <span class="n">Cleanup</span> <span class="n">in</span> <span class="n">this</span> <span class="n">document</span>
-
-<span class="o">*</span><span class="n">TODO</span><span class="o">*</span>
-
- <span class="o">*</span> <span class="n">more</span> <span class="n">specifics</span> <span class="n">about</span> <span class="n">things</span> <span class="n">to</span> <span class="n">test</span> <span class="n">before</span> <span class="n">starting</span> <span class="n">or</span> <span class="n">after</span> <span class="n">packaging</span>
-</pre></div>
-
-
-<p>(RAT, run scripts against example, etc...)
- * include info about [Voting | http://www.apache.org/foundation/voting.html#ReleaseVotes]</p>
+*
+https://cwiki.apache.org/confluence/display/MAHOUT/How+To+Update+The+Website</li>
+<li>Send announcements to the user and developer lists.</li>
+</ul>
+<p>See also:</p>
+<ul>
+<li>http://maven.apache.org/developers/release/releasing.html
+*
+http://www.sonatype.com/books/nexus-book/reference/staging-sect-deployment.html</li>
+<li>http://www.sonatype.com/books/nexus-book/reference/index.html</li>
+</ul>
+<h2 id="post-release">Post Release</h2>
+<h3 id="versioning">Versioning</h3>
+<ul>
+<li>Create the next version in JIRA (if it doesn't already exist) </li>
+<li>Mark the version as "released" in JIRA (noting the release date)</li>
+</ul>
+<h3 id="documentation">Documentation</h3>
+<ul>
+<li>Change wiki to match current best practices (remove/change deprecations,
+etc)</li>
+</ul>
+<h3 id="publicity">Publicity</h3>
+<ul>
+<li>update freshmeat</li>
+<li>!TheServerSide blurb</li>
+<li>blog away</li>
+<li>Update MLOSS entry: http://mloss.org/revision/view/387/. See Grant for
+details.</li>
+</ul>
+<h2 id="related-resources">Related Resources</h2>
+<ul>
+<li>http://www.apache.org/dev/#releases</li>
+<li>http://www.apache.org/dev/#mirror</li>
+</ul>
+<h1 id="todo-things-to-cleanup-in-this-document">TODO: Things To Cleanup in this document</h1>
+<ul>
+<li>more specifics about things to test before starting or after packaging
+(RAT, run scripts against example, etc...)</li>
+<li>include info about [Voting | http://www.apache.org/foundation/voting.html#ReleaseVotes]</li>
+</ul>
</div>
</div>
</div>