Author: buildbot
Date: Wed Dec 18 23:48:00 2013
New Revision: 890973
Log:
Staging update by buildbot for jspwiki
Modified:
websites/staging/jspwiki/trunk/content/ (props changed)
websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html
Propchange: websites/staging/jspwiki/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Dec 18 23:48:00 2013
@@ -1 +1 @@
-1544298
+1552165
Modified: websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html
==============================================================================
--- websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html (original)
+++ websites/staging/jspwiki/trunk/content/ppmc/how_to_release.html Wed Dec 18
23:48:00 2013
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";>
<html id="top" xmlns="http://www.w3.org/1999/xhtml";
xmlns:jspwiki="http://www.jspwiki.org";><head>
- <title>How to Release
</title>
+ <title>How to Release</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" media="screen, projection, print"
href="/css/jspwiki.css">
<link rel="stylesheet" type="text/css" media="print"
href="/css/jspwiki_print.css">
@@ -28,7 +28,7 @@
<div class="pagename">
- How to Release
+ How to Release
</div>
@@ -82,177 +82,144 @@
<div class="tabs">
<div id="pagecontent">
- <h2 id="how-to-release">How to Release</h2>
+ <p>Title: How to Release</p>
+<h2 id="how-to-release">How to Release</h2>
<div class="toc">
<ul>
<li><a href="#how-to-release">How to Release</a></li>
<li><a href="#first-time-release-managers">First time release managers</a></li>
-<li><a href="#create-a-release-candidate">Create a release candidate</a></li>
+<li><a href="#create-a-release-candidate">Create a release candidate</a><ul>
+<li><a href="#generate-release-candidate-artifacts">Generate release candidate
artifacts</a></li>
+<li><a href="#prepare-the-release">Prepare the release</a></li>
+</ul>
+</li>
<li><a href="#run-a-vote">Run a vote</a></li>
<li><a href="#roll-out">Roll Out</a></li>
<li><a href="#announce-the-release">Announce the release</a></li>
<li><a href="#add-the-next-release-to-jira">Add the next release to
JIRA</a></li>
+<li><a href="#troubleshooting">Troubleshooting</a></li>
+<li><a href="#other-links-of-interest">Other links of interest</a></li>
</ul>
</div>
-<div style="clear:both;">
-(most of the content grabbed/adapted from MRUnit site)
-</div>
-
<h2 id="first-time-release-managers">First time release managers</h2>
<ol>
-<li>Generate <a
href="http://www.apache.org/dev/release-signing.html#generate";>PGP code signing
keys</a></li>
-<li>Add the PGP code signing keys to the <a
href="http://svn.apache.org/repos/asf/jspwiki/dist/KEYS";>KEYS file</a> as
documented on the
-<a
href="http://www.apache.org/dev/release-signing.html#keys-policy";>Infrastructure
site</a></li>
-<li>Put in a <a
href="https://issues.apache.org/jira/browse/INFRA";>Infrastructure JIRA</a>
asking to get added to the jspwiki unix
-group on people.apache.org <!--and the jspwiki deployer role for Nexus--></li>
-<li>Copy the modified KEYS file to the release folder
-/www/www.apache.org/dist/jspwiki on people.apache.org and ensure it
-has 0664 permissions.</li>
-</ol>
-<!---
- 5. Add the following to your Maven settings.xml file:
-
- <servers>
- <server>
- <id>apache.releases.https</id>
- <username>APACHE-ID</username>
- <password>APACHE-PASSWORD</password>
- </server>
- </servers>
--->
+<li>
+<p>Generate <a
href="http://www.apache.org/dev/release-signing.html#generate";>PGP code signing
keys</a></p>
+</li>
+<li>
+<p>Add the PGP code signing keys to the <a
href="http://svn.apache.org/repos/asf/jspwiki/dist/KEYS";>KEYS file</a> as
documented on the
+<a
href="http://www.apache.org/dev/release-signing.html#keys-policy";>Infrastructure
site</a></p>
+</li>
+<li>
+<p>Put in a <a
href="https://issues.apache.org/jira/browse/INFRA";>Infrastructure JIRA</a>
asking to get added to the jspwiki unix
+group on <code>people.apache.org</code></p>
+</li>
+<li>
+<p>Copy the modified KEYS file to the release folder
+<code>/www/www.apache.org/dist/jspwiki</code> on
<code>people.apache.org</code> and ensure it
+has <code>0664</code> permissions.</p>
+</li>
+<li>
+<p>Add the following <code>servers</code> to your Maven
<code>settings.xml</code> file:</p>
+<div class="codehilite"><pre><span class="nt"><servers></span>
+ <span class="nt"><server></span>
+ <span class="nt"><id></span>apache.releases.https<span
class="nt"></id></span>
+ <span class="nt"><username></span>APACHE-ID<span
class="nt"></username></span>
+ <span class="nt"><password></span>APACHE-PASSWORD<span
class="nt"></password></span>
+ <span class="nt"></server></span>
+ <span class="nt"><server></span>
+ <span class="nt"><id></span>apache.snapshots.https<span
class="nt"></id></span>
+ <span class="nt"><username></span>APACHE-ID<span
class="nt"></username></span>
+ <span class="nt"><password></span>APACHE-PASSWORD<span
class="nt"></password></span>
+ <span class="nt"></server></span>
+ <span class="nt"><server></span>
+ <span class="nt"><id></span>svn.apache.org<span
class="nt"></id></span>
+ <span class="nt"><username></span>APACHE-ID<span
class="nt"></username></span>
+ <span class="nt"><password></span>APACHE-PASSWORD<span
class="nt"></password></span>
+ <span class="nt"></server></span>
+<span class="nt"></servers></span>
+</pre></div>
+
-<p>It is convenient to <a
href="http://www.thegeekstuff.com/2008/11/3-steps-to-perform-ssh-login-without-password-using-ssh-keygen-ssh-copy-id/";>setup
the ssh keys</a> on people.apache.org, otherwise
-you'll have to enter your login password a number of times.</p>
+</li>
+</ol>
+<p>Note that your password doesn't need to be inside the
<code>settings.xml</code> file, due to
+<a href="http://maven.apache.org/guides/mini/guide-encryption.html";>Maven
encryption capabilities</a>. It is also convenient to <a
href="http://www.thegeekstuff.com/2008/11/3-steps-to-perform-ssh-login-without-password-using-ssh-keygen-ssh-copy-id/";>setup
the ssh keys</a>
+on <code>people.apache.org</code>, otherwise you'll have to enter your login
password a number of times.</p>
<h2 id="create-a-release-candidate">Create a release candidate</h2>
+<h3 id="generate-release-candidate-artifacts">Generate release candidate
artifacts</h3>
<ol>
-<li>Generate release notes</li>
-</ol>
-<!-- TODO
- What exactly do we want to do here?
- Completing the details makes only sense once we're a TLP and thus not
- dependent from externs anymore.
-
- 1. Update ReleaseNotes with [new release notes from JIRA][], select the
-version and set the style to Text
- 2. Commit the updated ReleaseNotes with message: "Preparing for release
-X.Y.Z"
--->
-
-<!---
- 2. Create a branch (only required for the first release in a series (X.Y.0))
-
- 1. Create a branch for the X.Y release series
-
- svn copy https://svn.apache.org/repos/asf/jspwiki/trunk \
- https://svn.apache.org/repos/asf/jspwiki/branches/jspwiki-X.Y -m
"Branching for X.Y releases"
-
- 2. Bump the version number in trunk and commit (the update-versions script
-mangles the whitespace in the root XML element):
-
- sed -i "" -e "s/X.Y.0-SNAPSHOT/X.Y+1.0-SNAPSHOT/" pom.xml
-
- 3. Checkout the release branch:
-
- svn checkout
https://svn.apache.org/repos/asf/jspwiki/branches/jspwiki-X.Y
-
- 3. Remove -SNAPSHOT from the release branch and commit
-
- sed -i "" -e "s/X.Y.Z-SNAPSHOT/X.Y.Z/" pom.xml
-
- 4. Deploy to Nexus Staging Repository
-
- 1. Deploy artifact:
-
- mvn clean deploy -Psign
-
- 2. Verify licenses in target/rat.txt
+<li>
+<p>Generate artifacts</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">clean</span> <span class="n">apache</span><span
class="o">-</span><span class="nb">rat</span><span class="p">:</span><span
class="nb">rat</span> <span class="n">install</span> <span
class="o">-</span><span class="n">Papache</span><span class="o">-</span><span
class="n">release</span>
+</pre></div>
- 3. Login to <https://repository.apache.org> and select Staging
Repositories
-on the left under Build Promotion.
- 4. Select org.apache.jspwiki from the list of repositories, select the
-current repository and delete any asc.md5/asc.sha1 files. Then click Close
-using "Apache JSPWiki X.Y.Z" as the description to allow others
-to see the repository.
--->
+</li>
+</ol>
+<p>This will check that all files have AL headers and also build artifacts,
sources and sign</p>
<ol>
<li>
-<p>Deploy source and binary distributions</p>
+<p>Check <code>POMs</code> for release</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">release</span><span class="p">:</span><span class="n">prepare</span>
<span class="o">-</span><span class="n">DdryRun</span><span
class="p">=</span><span class="n">true</span> <span class="o">-</span><span
class="n">DautoVersionSubmodules</span><span class="p">=</span><span
class="n">true</span>
+</pre></div>
+
+
+</li>
+</ol>
+<p>Perform quick diffs between <code>pom.xml</code> files and their sibling
<code>pom.xml.tag</code> files to see if the
+license or any other info has been removed (should never happen, but just to
stay on the safe side).</p>
+<h3 id="prepare-the-release">Prepare the release</h3>
<ol>
<li>
-<p>Build JSPWiki using Maven:</p>
-<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">clean</span> <span class="n">install</span> <span
class="o">-</span><span class="n">Pintegration</span><span
class="o">-</span><span class="n">tests</span>
+<p><strong>Publish a snapshot</strong></p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">deploy</span>
</pre></div>
</li>
<li>
-<p>Generate the src & bin distributions using Ant:</p>
-<div class="codehilite"><pre><span class="n">ant</span> <span
class="n">clean</span> <span class="n">signeddist</span>
+<p><strong>Prepare the release</strong></p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">release</span><span class="p">:</span><span class="n">clean</span>
+<span class="n">mvn</span> <span class="n">release</span><span
class="p">:</span><span class="n">prepare</span> <span class="o">-</span><span
class="n">DautoVersionSubmodules</span><span class="p">=</span><span
class="n">true</span>
</pre></div>
</li>
<li>
-<p>Copy the src distribution file and checksums to people.apache.org,
-excluding the asc.md5/asc.sha1 files:</p>
-<div class="codehilite"><pre><span class="n">scp</span> <span
class="n">target</span><span class="o">/*</span><span class="p">.</span><span
class="n">tar</span><span class="p">.</span><span class="n">gz</span><span
class="o">*</span> <span class="n">username</span><span class="p">@</span><span
class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="p">:</span><span class="o">~/</span><span
class="n">public_html</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">candidate</span><span
class="o">-</span>$<span class="n">RC</span>
+<p><strong>Stage the release for a vote</strong></p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">release</span><span class="p">:</span><span class="n">perform</span>
</pre></div>
</li>
-</ol>
+<li>
+<p><strong>Close the staging repository</strong></p>
+<ol>
+<li>
+<p>Login to <a
href="https://repository.apache.org";>https://repository.apache.org</a> and
select Staging Repositories
+on the left under Build Promotion.</p>
+</li>
+<li>
+<p>Select org.apache.jspwiki from the list of repositories, select the
+current repository and delete any <code>asc.md5/asc.sha1</code> files. Then
click <a
href="https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository";>Close</a>
+using "Apache JSPWiki X.Y.Z" as the description to allow others
+to see the repository.</p>
</li>
</ol>
-<!---
- 3. Generate the bin distribution:
-
- mvn clean assembly:single gpg:sign checksum:artifacts -Pdist-bin
-
- 4. Copy the bin distribution file and checksums to people.apache.org,
-excluding the asc.md5/asc.sha1 files:
-
- rm target/*asc.*
- scp target/*.tar.gz*
usern...@people.apache.org:~/public_html/jspwiki-X.Y.Z-candidate-$RC
--->
-
-<ol>
+</li>
<li>
-<p>Tag the release candidate:</p>
-<div class="codehilite"><pre><span class="n">svn</span> <span
class="n">copy</span> <span class="n">https</span><span class="p">:</span><span
class="o">//</span><span class="n">svn</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">repos</span><span class="o">/</span><span
class="n">asf</span><span class="o">/</span><span class="n">jspwiki</span><span
class="o">/</span><span class="n">branches</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="o">/</span> <span
class="o">\</span>
-<span class="n">https</span><span class="p">:</span><span
class="o">//</span><span class="n">svn</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">repos</span><span class="o">/</span><span
class="n">asf</span><span class="o">/</span><span class="n">jspwiki</span><span
class="o">/</span><span class="n">tags</span><span class="o">/</span><span
class="n">release</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">/</span> <span class="o">-</span><span
class="n">m</span> "<span class="n">jspwiki</span> <span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span> <span class="n">release</span><span
class="p">.</span>"
+<p><strong>Copy the bin distribution files and checksums to
people.apache.org</strong>,
+excluding the <code>asc.md5/asc.sha1</code> files:</p>
+<div class="codehilite"><pre><span class="nb">find</span> <span
class="p">.</span> <span class="o">-</span><span class="n">name</span> <span
class="n">target</span><span class="o">/*</span><span class="n">asc</span><span
class="o">.*</span> <span class="o">-</span><span class="n">exec</span> <span
class="n">rm</span> <span class="p">{}</span> <span class="o">\</span><span
class="p">;</span>
+<span class="n">scp</span> <span class="n">target</span><span
class="o">/*</span> <span class="n">username</span><span
class="p">@</span><span class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span><span
class="p">:</span><span class="o">~/</span><span
class="n">public_html</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span><span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="o">-</span><span class="n">candidate</span><span
class="o">-</span>$<span class="n">RC</span>
</pre></div>
</li>
</ol>
<h2 id="run-a-vote">Run a vote</h2>
-<p>Send the following to d...@jspwiki.apache.org:</p>
-<!---
- Subject: [VOTE] Release JSPWiki version X.Y.Z
-
- This is a release for Apache JSPWiki, version X.Y.Z.
-
- It fixes the following issues:
-
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310732&version=<REPLACE>
-
- *** Please download, test and vote by [3 working days after sending].
-
- Note that we are voting upon the source (tag), binaries are provided for
convenience.
-
- Source and binary files:
- http://people.apache.org/~<REPLACE>/jspwiki-X.Y.Z-candidate-$RC
-
- Maven staging repo:
-
https://repository.apache.org/content/repositories/orgapachejspwiki-<REPLACE>/
-
- The tag to be voted upon:
- http://svn.apache.org/repos/asf/jspwiki/tags/release-X.Y.Z/
-
- JSPWiki's KEYS file containing PGP keys we use to sign the release:
- http://www.apache.org/dist/jspwiki/KEYS
--->
-
+<p>Send the following to <a
href="mailto:dev@jspwiki.apache.org">dev@jspwiki.apache.org</a>:</p>
<div class="codehilite"><pre><span class="n">Subject</span><span
class="p">:</span> <span class="p">[</span><span class="n">VOTE</span><span
class="p">]</span> <span class="n">Release</span> <span
class="n">JSPWiki</span> <span class="n">version</span> <span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span>
<span class="n">This</span> <span class="n">is</span> <span class="n">a</span>
<span class="n">release</span> <span class="k">for</span> <span
class="n">Apache</span> <span class="n">JSPWiki</span><span class="p">,</span>
<span class="n">version</span> <span class="n">X</span><span
class="p">.</span><span class="n">Y</span><span class="p">.</span><span
class="n">Z</span><span class="p">.</span>
@@ -278,27 +245,32 @@ excluding the asc.md5/asc.sha1 files:
<p>Note that the PMC needs to vote upon the release before any release can be
made official.</p>
<h2 id="roll-out">Roll Out</h2>
<p>If the vote passes, roll out the release:</p>
-<!---
- 1. Publish Nexus repository:
- 1. Login to <https://repository.apache.org> and select Staging
Repositories
-on the left under Build Promotion.
- 2. Select the repository that was closed earlier, and click Release, using
-the description "Apache jspwiki X.Y.Z artifacts"
--->
-
<ol>
<li>
-<p>Publish src and bin distributions to the <a
href="http://www.apache.org/dev/mirrors.html";>mirrors</a>:</p>
+<p><strong>Publish Nexus repository</strong></p>
+<ol>
+<li>
+<p>Login to <a
href="https://repository.apache.org";>https://repository.apache.org</a> and
select Staging Repositories
+on the left under Build Promotion.</p>
+</li>
+<li>
+<p>Select the repository that was closed earlier, and click Release, using
+the description "Apache JSPWiki X.Y.Z"</p>
+</li>
+</ol>
+</li>
+<li>
+<p><strong>Publish src and bin distributions to the <a
href="http://www.apache.org/dev/mirrors.html";>mirrors</a></strong></p>
<div class="codehilite"><pre><span class="n">ssh</span> <span
class="n">people</span><span class="p">.</span><span
class="n">apache</span><span class="p">.</span><span class="n">org</span>
<span class="n">VERSION</span><span class="p">=</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span>
-<span class="n">PREVIOUS_VERSION</span><span class="p">=</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span>
+<span class="n">PREVIOUSVERSION</span><span class="p">=</span><span
class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span>
<span class="n">CANDIDATE</span><span class="p">=</span><span
class="n">C</span>
<span class="n">cp</span> <span class="o">-</span><span class="n">r</span>
<span class="o">~/</span><span class="n">public_html</span><span
class="o">/</span><span class="n">jspwiki</span><span class="o">-</span>$<span
class="n">VERSION</span><span class="o">-</span><span
class="n">candidate</span><span class="o">-</span>$<span
class="n">CANDIDATE</span> <span class="o">\</span>
<span class="o">/</span><span class="n">www</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">dist</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span>$<span class="n">VERSION</span>
<span class="n">cd</span> <span class="o">/</span><span
class="n">www</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">dist</span><span
class="o">/</span><span class="n">jspwiki</span>
<span class="n">chgrp</span> <span class="o">-</span><span class="n">R</span>
<span class="n">jspwiki</span> <span class="n">jspwiki</span><span
class="o">-</span>$<span class="n">VERSION</span>
<span class="n">chmod</span> <span class="o">-</span><span class="n">R</span>
<span class="n">g</span><span class="o">+</span><span class="n">w</span> <span
class="n">jspwiki</span><span class="o">-</span>$<span class="n">VERSION</span>
-<span class="n">rm</span> <span class="o">-</span><span class="n">r</span>
<span class="o">/</span><span class="n">www</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">dist</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span>$<span
class="n">PREVIOUS_VERSION</span> # <span class="n">remove</span> <span
class="n">older</span> <span class="n">versions</span>
+<span class="n">rm</span> <span class="o">-</span><span class="n">r</span>
<span class="o">/</span><span class="n">www</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">dist</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">/</span><span
class="n">jspwiki</span><span class="o">-</span>$<span
class="n">PREVIOUSVERSION</span> # <span class="n">remove</span> <span
class="n">older</span> <span class="n">versions</span>
</pre></div>
@@ -310,29 +282,13 @@ are <a href="http://archive.apache.org/d
<p>Wait 24 hours for mirrors to sync</p>
</li>
<li>
-<p>Post the javadoc to the site:</p>
-<ol>
-<li>
-<p>Create the javadoc:</p>
-<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">javadoc</span><span class="p">:</span><span class="n">javadoc</span>
-</pre></div>
-
-
-</li>
-<li>
-<p>Copy javadocs to
https://svn.apache.org/repos/infra/websites/production/jspwiki/documentation/javadocs/X.Y.Z</p>
-</li>
-<li>Add a link to index.html of the javadoc in the
documentation/javadoc.mdtext page</li>
-</ol>
-</li>
-<li>
<p>Post link to the full release notes along with links to the major JIRA
changes on the front page of the site</p>
</li>
</ol>
<h2 id="announce-the-release">Announce the release</h2>
-<p>Send the following from an apache.org address to annou...@apache.org,
-u...@jspwiki.apache.org, d...@jspwiki.apache.org:</p>
+<p>Send the following from an apache.org address to <a
href="mailto:announce@apache.org">announce@apache.org</a>,
+<a
href="mailto:user@jspwiki.apache.org">user@jspwiki.apache.org</a>,
<a
href="mailto:dev@jspwiki.apache.org">dev@jspwiki.apache.org</a>:</p>
<div class="codehilite"><pre><span class="n">Subject</span><span
class="p">:</span> <span class="p">[</span><span class="n">ANNOUNCE</span><span
class="p">]</span> <span class="n">Apache</span> <span class="n">JSPWiki</span>
<span class="n">X</span><span class="p">.</span><span class="n">Y</span><span
class="p">.</span><span class="n">Z</span> <span class="n">released</span>
<span class="n">The</span> <span class="n">Apache</span> <span
class="n">JSPWiki</span> <span class="n">team</span> <span class="n">is</span>
<span class="n">pleased</span> <span class="n">to</span> <span
class="n">announce</span> <span class="n">the</span> <span
class="n">release</span> <span class="n">of</span> <span
class="n">JSPWiki</span> <span class="n">X</span><span class="p">.</span><span
class="n">Y</span><span class="p">.</span><span class="n">Z</span><span
class="p">.</span>
@@ -358,7 +314,37 @@ u...@jspwiki.apache.org, d...@jspwiki.apa
<ol>
<li>Add the <a
href="https://issues.apache.org/jira/plugins/servlet/project-config/jspwiki/versions";>next
version number to JIRA</a></li>
<li>Mark the released version as "released" with a release date</li>
-</ol>
+</ol>
+<h2 id="troubleshooting">Troubleshooting</h2>
+<ol>
+<li>Cygwin mixes Windows path with cygdrive, so <code>mvn
release:prepare</code> fails on svn commit</li>
+</ol>
+<p>Current workaround: perform release vÃa <code>cmd.exe</code></p>
+<ol>
+<li>Avoid gpg signing prompt when using Maven release plugin</li>
+</ol>
+<p>See <a
href="http://stackoverflow.com/q/14114528";>http://stackoverflow.com/q/14114528</a></p>
+<ol>
+<li><code>mvn release:prepare</code> doesn't find svn credentials</li>
+</ol>
+<p>On your settings.xml file you should have one <server /> entry for each of
the following ones:
+<em> <code>apache.snapshots.https</code>: to be able to deploy snapshots
+</em> <code>apache.releases.https</code>: to be able to deploy releases
+* <code>svn.apache.org</code>: to be able to create tags
+Alternatively, for the last one, you could pass -Dusername=[username]
-Dpassword=[password] to the mvn command
+(source: <a
href="http://stackoverflow.com/q/1255593";>http://stackoverflow.com/q/1255593</a>)</p>
+<ol>
+<li>Release fails after a tag has been generated and the pom versions have
been incremented</li>
+</ol>
+<p>No need of <code>mvn release:rollback</code>, instead check out the tag and
<code>release:perform
-DconnectionUrl=scm:svn:https://svn.apache.org/COMPLETE-URL-TO-TAG</code></p>
+<h2 id="other-links-of-interest">Other links of interest</h2>
+<ul>
+<li><a
href="https://confluence.sakaiproject.org/display/REL/Maven+release+plugin+cheat+sheet";>Maven
release plugin cheat sheet</a></li>
+<li><a
href="http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env";>Publishing
Maven Artifacts - setup your development environment</a></li>
+<li><a
href="http://maven.apache.org/maven-release/maven-release-plugin/";>Maven
release plugin</a></li>
+<li>Repository management with Nexus: <a
href="http://books.sonatype.com/nexus-book/reference/staging-sect-intro.html";>Chapter
11. Improved Releases with the Nexus Staging Suite
+</a></li>
+</ul>
</div>
<div style="clear:both;"></div>
</div>
