You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mina.apache.org by bu...@apache.org on 2014/10/25 11:46:03 UTC
svn commit: r926779 - in /websites/staging/mina/trunk/content: ./
mina-project/developper-guide.html
Author: buildbot
Date: Sat Oct 25 09:46:03 2014
New Revision: 926779
Log:
Staging update by buildbot for mina
Modified:
websites/staging/mina/trunk/content/ (props changed)
websites/staging/mina/trunk/content/mina-project/developper-guide.html
Propchange: websites/staging/mina/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sat Oct 25 09:46:03 2014
@@ -1 +1 @@
-1633155
+1634199
Modified: websites/staging/mina/trunk/content/mina-project/developper-guide.html
==============================================================================
--- websites/staging/mina/trunk/content/mina-project/developper-guide.html (original)
+++ websites/staging/mina/trunk/content/mina-project/developper-guide.html Sat Oct 25 09:46:03 2014
@@ -161,6 +161,7 @@
<li><a href="#step-4-perform-the-release">Step 4 : perform the release</a></li>
<li><a href="#step-5-closing-the-staging-release-on-nexus">Step 5 : closing the staging release on nexus</a></li>
<li><a href="#step-6-build-the-site">Step 6 : Build the Site</a></li>
+<li><a href="#step-7-sign-the-packages">Step 7 : Sign the packages</a></li>
<li><a href="#step-8-publish-source-and-binary-distribution-packages">Step 8 : Publish Source and Binary Distribution Packages</a></li>
<li><a href="#step-9-test-the-new-version-with-ftpserver-sshd-and-vysper">Step 9 : Test the New Version with FtpServer, Sshd and Vysper</a></li>
</ul>
@@ -340,14 +341,6 @@ $ <span class="n">mvn</span> <span class
</pre></div>
-<DIV class="info" markdown="1">
-Just after the last module, maven will ask you about the SCM tag :
-
- What is SCM release tag or label for "Apache MINA"? (org.apache.mina:mina-parent) mina-parent-2.0.7: : 2.0.7
-
-Do **not** type <enter> to select the default value. Instead, type the correct version.
-</DIV>
-
<p>Then some other questions will be asked, about the next version to use. The default values should be fine.</p>
<DIV class="info" markdown="1">
**Be Careful**
@@ -355,9 +348,6 @@ Do **not** type <enter> to select the de
Make sure the change made by the release plugin is correct! (pom.xml, tags created)
</DIV>
-<p>Now, you have to build the project :</p>
-<p>$ mvn clean install -Pserial</p>
-<p>It should not be a necessay step, but at the moment, we have an issue with the Javadoc plugin which requires the modules to have been built before running the release.</p>
<h3 id="step-3-processing-with-the-real-release">Step 3 : Processing with the real release</h3>
<p>When the dry run is successful, then you can do in real with the following commands:</p>
<div class="codehilite"><pre>$ <span class="n">mvn</span> <span class="o">-</span><span class="n">Pserial</span><span class="p">,</span><span class="n">apache</span><span class="o">-</span><span class="n">release</span> <span class="n">release</span><span class="p">:</span><span class="n">clean</span> # <span class="n">Clean</span> <span class="n">up</span> <span class="n">the</span> <span class="n">temporary</span> <span class="n">files</span> <span class="n">created</span> <span class="n">by</span> <span class="n">the</span> <span class="n">dry</span><span class="o">-</span><span class="n">run</span><span class="p">.</span>
@@ -367,44 +357,10 @@ $ <span class="n">mvn</span> <span class
<p>The first step will clean up the local sources, the second step will release for real. The same questions will be asked as those we had during the dry run step.</p>
<p>At some point, it will ask for your passphrase (the one you used when you created your PGP key). Type it in.</p>
-<p>At the end, if you proceed the release on a Mac, you may get the following message :</p>
-<div class="codehilite"><pre><span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Tagging</span> <span class="n">release</span> <span class="n">with</span> <span class="n">the</span> <span class="n">label</span> 2<span class="p">.</span>0<span class="p">.</span>7<span class="p">...</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Executing</span><span class="p">:</span> <span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">sh</span> <span class="o">-</span><span class="n">c</span> <span class="n">cd</span> <span class="o">/</span><span class="n">Users</span><span class="o">/</span><span class="n">elecharny</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">trunk</span> <span class="o">&&</span> <span class="n">svn</span> <span class="o">--</span><span class="n">non</span><span class="o">-</span><span class="n">interactive</span>
- <span class="n">copy</span> <span class="o">--</span><span class="n">file</span> <span class="o">/</span><span class="n">var</span><span class="o">/</span><span class="n">folders</span><span class="o">/</span><span class="n">t7</span><span class="o">/</span><span class="n">t7UwkHaiGleYYgPqGZTbF</span><span class="o">++++</span><span class="n">TM</span><span class="o">/-</span><span class="n">Tmp</span><span class="o">-/</span><span class="n">maven</span><span class="o">-</span><span class="n">scm</span><span class="o">-</span>409730412<span class="p">.</span><span class="n">commit</span>
- <span class="o">--</span><span class="n">revision</span> <span class="n">XXXXX</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">mina</span><span class="o">/</span><span class="n">trunk</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">mina</span><span class="o">/</span><span class="n">tags</span><span class="o">/</span>2<span class="p">.</span>0<span class="p">.</span>7
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Working</span> <span class="n">directory</span><span class="p">:</span> <span class="o">/</span><span class="n">Users</span><span class="o">/</span><span class="n">elecharny</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">trunk</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
-<span class="p">[</span><span class="n">ERROR</span><span class="p">]</span> <span class="n">BUILD</span> <span class="n">FAILURE</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Unable</span> <span class="n">to</span> <span class="n">tag</span> <span class="n">SCM</span>
-<span class="n">Provider</span> <span class="n">message</span><span class="p">:</span>
-<span class="n">The</span> <span class="n">svn</span> <span class="n">tag</span> <span class="n">command</span> <span class="n">failed</span><span class="p">.</span>
-<span class="n">Command</span> <span class="n">output</span><span class="p">:</span>
-<span class="n">svn</span><span class="p">:</span> <span class="n">No</span> <span class="n">such</span> <span class="n">revision</span> <span class="n">XXXXX</span>
-</pre></div>
-
-
-<p>If so, just type the two following commands :</p>
-<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">up</span> <span class="o">-</span><span class="n">r</span> <span class="n">HEAD</span>
-<span class="n">At</span> <span class="n">revision</span> <span class="n">YYYYYY</span><span class="p">.</span>
-$ <span class="n">mvn</span> <span class="o">-</span><span class="n">Pserial</span><span class="p">,</span><span class="n">apache</span><span class="o">-</span><span class="n">release</span> <span class="n">release</span><span class="p">:</span><span class="n">prepare</span> <span class="o">-</span><span class="n">Dresume</span>
-<span class="p">...</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Release</span> <span class="n">preparation</span> <span class="n">complete</span><span class="p">.</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">BUILD</span> <span class="n">SUCCESSFUL</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Total</span> <span class="n">time</span><span class="p">:</span> 1 <span class="n">minute</span> 4 <span class="n">seconds</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Finished</span> <span class="n">at</span><span class="p">:</span> <span class="n">Mon</span> <span class="n">Sep</span> 13 16<span class="p">:</span>12<span class="p">:</span>02 <span class="n">CEST</span> 2010
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Final</span> <span class="n">Memory</span><span class="p">:</span> 28<span class="n">M</span><span class="o">/</span>81<span class="n">M</span>
-<span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="o">------------------------------------------------------------------------</span>
-</pre></div>
-
-
<p>Three mails will be generated, and sent to commits@mina.apache.org :</p>
-<div class="codehilite"><pre><span class="n">svn</span> <span class="n">commit</span><span class="p">:</span> <span class="n">r996535</span> <span class="o">-</span> <span class="n">in</span> <span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">trunk</span><span class="p">:</span> <span class="o">./</span> <span class="n">distribution</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">core</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">example</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">filter</span><span class="p">...</span>
-<span class="n">svn</span> <span class="n">commit</span><span class="p">:</span> <span class="n">r996542</span> <span class="o">-</span> <span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">tags</span><span class="o">/</span>2<span class="p">.</span>0<span class="p">.</span>7<span class="o">/</span>
-<span class="n">svn</span> <span class="n">commit</span><span class="p">:</span> <span class="n">r996544</span> <span class="o">-</span> <span class="n">in</span> <span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">trunk</span><span class="p">:</span> <span class="o">./</span> <span class="n">distribution</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">core</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">example</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">filter</span><span class="p">...</span>
+<div class="codehilite"><pre><span class="n">git</span> <span class="n">commit</span><span class="p">:</span> <span class="p">[</span><span class="n">maven</span><span class="o">-</span><span class="n">release</span><span class="o">-</span><span class="n">plugin</span><span class="p">]</span> <span class="n">prepare</span> <span class="n">release</span> 2<span class="p">.</span>0<span class="p">.</span>9
+<span class="n">Git</span> <span class="n">Push</span> <span class="n">Summary</span>
+<span class="n">git</span> <span class="n">commit</span><span class="p">:</span> <span class="p">[</span><span class="n">maven</span><span class="o">-</span><span class="n">release</span><span class="o">-</span><span class="n">plugin</span><span class="p">]</span> <span class="n">prepare</span> <span class="k">for</span> <span class="n">next</span> <span class="n">development</span> <span class="n">iteration</span>
</pre></div>
@@ -459,15 +415,10 @@ $ <span class="n">mvn</span> <span class
<p>This creates the site.</p>
-<DIV class="info" markdown="1">
-
-### Step 7 : Sign the packages
-
-Now, you have to sign the binary packages which are in target/checkout/distribution/target.
-
-Use your PGP key ID (the pub key, 4096R/[XXXXXXX] where [XXXXXXX] is the key ID)
-</DIV>
-
+<h3 id="step-7-sign-the-packages">Step 7 : Sign the packages</h3>
+<p>Now, you have to sign the binary packages which are in target/checkout/distribution/target.</p>
+<p>Use your PGP key ID (the pub key, 4096R/[XXXXXXX] where [XXXXXXX] is the key ID)
+</DIV></p>
<p>You can get the keys by typing :</p>
<div class="codehilite"><pre><span class="n">gpg</span> <span class="o">--</span><span class="n">list</span><span class="o">-</span><span class="n">keys</span>
</pre></div>
@@ -485,8 +436,10 @@ Use your PGP key ID (the pub key, 4096R/
sub 4096R/tttttttt 2010-09-13
...</p>
<p>Take the <zzzzzzzz> part of your 4096 bit key.</p>
-<p>Use a shell script to sign the packages which are stored in target/checkout/distribution/target :</p>
-<p>localhost:target elecharny$ ~/sign.sh
+<p>Use a shell script to sign the packages which are stored in target/checkout/distribution/target. You will first have to delete the created .asc files :</p>
+<p>7C6B7034
+ localhost:target elecharny$ rm *.asc
+ localhost:target elecharny$ ~/sign.sh
PGP Key ID:
<your PGP key>
PGP Key Password:
@@ -604,8 +557,8 @@ $ <span class="n">exit</span>
<p>Then copy the packages :</p>
-<div class="codehilite"><pre>$ <span class="n">cd</span> <span class="n">distributions</span><span class="o">/</span><span class="n">target</span>
-$ <span class="n">scp</span> <span class="n">apache</span><span class="o">-</span><span class="n">mina</span><span class="o">-<</span><span class="n">version</span><span class="o">>-*</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="n">public_html</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span>
+<div class="codehilite"><pre>$ <span class="n">cd</span> <span class="n">target</span><span class="o">/</span><span class="n">checkout</span><span class="o">/</span><span class="n">distributions</span><span class="o">/</span><span class="n">target</span>
+$ <span class="n">scp</span> <span class="n">apache</span><span class="o">-</span><span class="n">mina</span><span class="o">-<</span><span class="n">version</span><span class="o">>-*</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="n">public_html</span><span class="o">/</span><span class="n">mina</span><span class="o">-<</span><span class="n">version</span><span class="o">>/</span>
</pre></div>
@@ -613,36 +566,36 @@ $ <span class="n">scp</span> <span class
<div class="codehilite"><pre><span class="nt"><h2></span>Last MINA 2.0.9 tarballs<span class="nt"></h2></span>
<span class="nt"><h3></span>Sources<span class="nt"></h3></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.gz"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz.asc<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz.md5<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz.sha1<span class="nt"></a><br/></span>
-
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.bz2"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2.asc<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2.md5<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2.sha1<span class="nt"></a><br/></span>
-
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.zip"</span><span class="nt">></span>apache-mina-2.0.9-src.zip<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.zip.asc<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.zip.md5<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-src.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.zip.sha1<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.gz"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz.asc<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz.md5<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.gz.sha1<span class="nt"></a><br/></span>
+
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.bz2"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2.asc<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2.md5<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.tar.bz2.sha1<span class="nt"></a><br/></span>
+
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.zip"</span><span class="nt">></span>apache-mina-2.0.9-src.zip<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.zip.asc<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.zip.md5<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-src.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-src.zip.sha1<span class="nt"></a><br/></span>
<span class="nt"><h3></span>Binaries<span class="nt"></h3></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.gz"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz.asc<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz.md5<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz.sha1<span class="nt"></a><br/></span>
-
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.bz2"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2.asc<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2.md5<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2.sha1<span class="nt"></a><br/></span>
-
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.zip"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip.asc<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip.md5<span class="nt"></a><br/></span>
- <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina/apache-mina-2.0.9-bin.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip.sha1<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.gz"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz.asc<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz.md5<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.gz.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.gz.sha1<span class="nt"></a><br/></span>
+
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.bz2"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2.asc<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2.md5<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.tar.bz2.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.tar.bz2.sha1<span class="nt"></a><br/></span>
+
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.zip"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip.asc<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip.md5<span class="nt"></a><br/></span>
+ <span class="nt"><img</span> <span class="na">src=</span><span class="s">"/icons/compressed.gif"</span> <span class="na">alt=</span><span class="s">"[ ]"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"mina-2.0.9/apache-mina-2.0.9-bin.zip.asc"</span><span class="nt">></span>apache-mina-2.0.9-bin.zip.sha1<span class="nt"></a><br/></span>
</pre></div>
@@ -696,10 +649,72 @@ $ <span class="n">scp</span> <span class
<li>Release the project on https://repository.apache.org</li>
<li>Copy the tarballs and heir signature in people.apache.org /www/www.apache.org/dist/mina</li>
</ul>
+<p>This can be done on people.apache.org :</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">svn</span> <span class="n">co</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">dist</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">dist</span><span class="o">/</span><span class="n">release</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span> <span class="n">mina</span><span class="o">-</span><span class="n">dist</span>
+# <span class="n">cd</span> <span class="n">mina</span><span class="o">-</span><span class="n">dist</span>
+# <span class="n">mkdir</span> <span class="o"><</span><span class="n">version</span><span class="o">></span>
+# <span class="n">cp</span> <span class="p">.</span><span class="o">./</span><span class="n">public_html</span><span class="o">/</span><span class="n">mina</span><span class="o">-<</span><span class="n">version</span><span class="o">>/*</span> <span class="o"><</span><span class="n">version</span><span class="o">></span>
+# <span class="n">svn</span> <span class="n">add</span> <span class="o"><</span><span class="n">version</span><span class="o">></span>
+# <span class="n">svn</span> <span class="n">ci</span> <span class="o"><</span><span class="n">version</span><span class="o">></span>
+<span class="p">...</span>
+# <span class="n">exit</span>
+$
+</pre></div>
+
+
<h3 id="step-12-deploy-web-reports-javadoc-and-jxr">Step 12: Deploy Web Reports (JavaDoc and JXR)</h3>
-<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">co</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">mina</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">tags</span><span class="o">/<</span><span class="n">version</span><span class="o">></span> <span class="n">mina</span>
-$ <span class="n">cd</span> <span class="n">mina</span>
-$ <span class="n">mvn</span> <span class="o">-</span><span class="n">Pserial</span> <span class="n">clean</span> <span class="n">compile</span> <span class="n">site</span> <span class="n">site</span><span class="p">:</span><span class="n">deploy</span>
+<p>The javadoc and xref files have been generated in step 6, it's now time to push them into the production site. They are generated in the following directory :</p>
+<div class="codehilite"><pre><span class="n">target</span><span class="o">/</span><span class="n">checkout</span><span class="o">/</span><span class="n">target</span><span class="o">/</span><span class="n">site</span>
+</pre></div>
+
+
+<p>We will copy two directories :</p>
+<div class="codehilite"><pre><span class="n">apidocs</span>
+<span class="n">xref</span>
+</pre></div>
+
+
+<p>Staging or Production?</p>
+<DIV class="info" markdown="1">
+Those files will be stored on the production server only !!! And some extra caution ust be taken not to delete them when we will publish the staging site too...
+</DIV>
+
+<p>First of all, you must checkout the two CMS store for the site : staging and production.</p>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">co</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">infra</span><span class="o">/</span><span class="n">websites</span><span class="o">/</span><span class="n">staging</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">trunk</span> <span class="n">staging</span>
+<span class="p">...</span>
+$ <span class="n">svn</span> <span class="n">co</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">infra</span><span class="o">/</span><span class="n">websites</span><span class="o">/</span><span class="n">production</span><span class="o">/</span><span class="n">mina</span> <span class="n">production</span>
+<span class="p">...</span>
+</pre></div>
+
+
+<p>Then copy the generated docs :</p>
+<div class="codehilite"><pre>$ <span class="n">cp</span> <span class="o">-</span><span class="n">r</span> <span class="o">~/</span><span class="n">mina</span><span class="o">/</span><span class="n">target</span><span class="o">/</span><span class="n">checkout</span><span class="o">/</span><span class="n">target</span><span class="o">/</span><span class="n">site</span><span class="o">/</span><span class="n">apidocs</span> <span class="n">production</span><span class="o">/</span><span class="n">content</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">mina</span><span class="o">-</span><span class="n">project</span><span class="o">/</span>
+$ <span class="n">cp</span> <span class="o">-</span><span class="n">r</span> <span class="o">~/</span><span class="n">mina</span><span class="o">/</span><span class="n">target</span><span class="o">/</span><span class="n">checkout</span><span class="o">/</span><span class="n">target</span><span class="o">/</span><span class="n">site</span><span class="o">/</span><span class="n">xref</span> <span class="n">production</span><span class="o">/</span><span class="n">content</span><span class="o">/</span><span class="n">mina</span><span class="o">/</span><span class="n">mina</span><span class="o">-</span><span class="n">project</span><span class="o">/</span>
+$
+</pre></div>
+
+
+<p>You have to check in those directories :</p>
+<div class="codehilite"><pre>$ <span class="n">svn</span> <span class="n">add</span> <span class="n">apidocs</span>
+$ <span class="n">svn</span> <span class="n">add</span> <span class="n">xref</span>
+$ <span class="n">svn</span> <span class="n">ci</span> <span class="n">apidocs</span> <span class="n">xref</span> <span class="o">-</span><span class="n">m</span> "<span class="n">Injected</span> <span class="n">MINA</span> <span class="o"><</span><span class="n">version</span><span class="o">></span> <span class="n">javadocs</span>"
+</pre></div>
+
+
+<p>Now, you have to update the staging site <em>extpaths.txt</em></p>
+<p>This file list the file on the production site that will not be overriden by the publication of the staging site. It has to be updated</p>
+<div class="codehilite"><pre>$ <span class="n">cd</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">staging</span><span class="o">/</span><span class="n">content</span><span class="o">/</span>
+$ <span class="n">vi</span> <span class="n">extpaths</span><span class="p">.</span><span class="n">txt</span>
+</pre></div>
+
+
+<p>The following lines should be present. If not, add them and commit the file :</p>
+<div class="codehilite"><pre><span class="n">mina</span><span class="o">-</span><span class="n">project</span><span class="o">/</span><span class="n">apidocs</span>
+<span class="n">mina</span><span class="o">-</span><span class="n">project</span><span class="o">/</span><span class="n">testapidocs</span>
+<span class="n">mina</span><span class="o">-</span><span class="n">project</span><span class="o">/</span><span class="n">xref</span>
+<span class="n">mina</span><span class="o">-</span><span class="n">project</span><span class="o">/</span><span class="n">xref</span><span class="o">-</span><span class="n">test</span>
+<span class="p">...</span>
</pre></div>