<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
How to release the EJB3 tutorials and EJB3 reference guide
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/admin">Administrator Administrator</a> in <i>EJB3</i> - <a href="http://community.jboss.org/docs/DOC-13320">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p>This wiki explains the steps required to generate/package the EJB3 tutorial source, the tutorial guide and the reference guide.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h4>Tutorials:</h4><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>To *generate* the tutorial deliverable (.zip/.tar.gz):</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>1) Checkout the tutorials from the EJB3 trunk</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-family: courier new,courier;"><span>svn co </span><a class="jive-link-external-small" href="https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk/docs/tutorial/" target="_blank">https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk/docs/tutorial/</a></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>2) Ensure that you have set MAVEN_HOME to point to 2.0.9 version of Maven and ANT_HOME to 1.7 version of Ant (Note: The tutorials can be built with Ant and Maven). Also ensure that JBOSS_HOME points to a clean (unmodified) JBossAS-5.0 GA.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>4) From the shell/command-prompt, 'cd' to the "tutorial/guide" folder</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>5) Run</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-family: courier new,courier;">mvn clean compile</span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>This command will generate the guide (in target/docbook sub-folder). This is the guide which the user should use to *run* the tutorials.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>6) The final step is to create the distributable. For this 'cd' to the "tutorial/dist" folder and run</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-family: courier new,courier;">ant -f build-dist.xml</span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Note: The plan was to generate the tutorial distributable(s) using Maven plugin. But because of plugin ordering issues in Maven 2.0.9, this runs into issues[1]. Hence we are going to use Ant to generate the final distributable.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The above command will generate "ejb3-tutorials.zip" and "ejb3-tutorials.tar.gz"  in the "tutorial/dist" folder. Use this to upload on the EJB3 docs site (only QA has permission)</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The instructions for *running* the tutorials are in the Readme.txt available in those .zip/.tar.gz files.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h4>Reference Guide :</h4><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>1) Checkout "reference" from the EJB3 trunk</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-family: courier new,courier;"><span>svn co </span><a class="jive-link-external-small" href="https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk/docs/reference/" target="_blank">https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk/docs/reference/</a></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>2) Ensure that you have set MAVEN_HOME to point to 2.0.9 version of Maven</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>3) From the shell/command-prompt, 'cd' to the "reference" folder (the place where you checked out from SVN)</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>4) Run</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-family: courier new,courier;">mvn clean compile</span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>5) This command will generate the "html" and "html_single" versions of the reference guide under target/docbook subfolder. Use this guide to upload on the EJB3 docs site (only QA has permission).</p><p><br/>[1] Maven references:<br/><span>* </span><a class="jive-link-external-small" href="http://www.nabble.com/Plugin-execution-order-incorrect-in-Maven-2.0.9-when-multiple-plugins-are-associated-with-the-same-phase-td21113516.html#a21113516" target="_blank">http://www.nabble.com/Plugin-execution-order-incorrect-in-Maven-2.0.9-when-multiple-plugins-are-associated-with-the-same-phase-td21113516.html#a21113516</a><br/><span>* </span><a class="jive-link-external-small" href="http://jira.codehaus.org/browse/MNG-3719" target="_blank">http://jira.codehaus.org/browse/MNG-3719</a><br/><span>* </span><a class="jive-link-external-small" href="http://jira.codehaus.org/browse/MNG-2784" target="_blank">http://jira.codehaus.org/browse/MNG-2784</a></p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-13320">going to Community</a></p>
<p style="margin: 0;">Create a new document in EJB3 at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2029">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>