You are viewing a plain text version of this content. The canonical link for it is here.
Posted to scm@geronimo.apache.org by bu...@apache.org on 2014/07/29 02:52:21 UTC
svn commit: r917744 [29/31] - in /websites/production/geronimo/content:
GMOxDOC20/
GMOxDOC20/geronimo-eclipse-plugin-installation-instructions.data/ cache/
Modified: websites/production/geronimo/content/GMOxDOC20/troubleshooting.html
==============================================================================
--- websites/production/geronimo/content/GMOxDOC20/troubleshooting.html (original)
+++ websites/production/geronimo/content/GMOxDOC20/troubleshooting.html Tue Jul 29 00:52:18 2014
@@ -18,6 +18,17 @@
<script src="http://geronimo.apache.org/functions.js" type="text/javascript"></script>
+ <link href='http://geronimo.apache.org/resources/highlighter/styles/shCoreGeronimo.css' rel='stylesheet' type='text/css' />
+ <link href='http://geronimo.apache.org/resources/highlighter/styles/shThemeGeronimo.css' rel='stylesheet' type='text/css' />
+ <script src='http://geronimo.apache.org/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
+ <script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
+ <script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
+
+ <script type="text/javascript">
+ SyntaxHighlighter.defaults['toolbar'] = false;
+ SyntaxHighlighter.all();
+ </script>
<title>Apache Geronimo v2.0 Documentation : Troubleshooting</title>
@@ -85,17 +96,28 @@
<div class="pagecontent">
<div class="wiki-content">
- <div class="wiki-content maincontent"><style type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+ <div class="wiki-content maincontent">
+<div class="atb-scrollbar-macro">
+ <div class="prev">
+ <a shape="rect" href="sample-applications.html" rel="prev">
+ <span class="aui-icon aui-icon-small atb-icon-arrow-left">Previous</span>
+ <span class="title">Sample applications</span>
+ </a>
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect" href="sample-applications.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/back_16.gif" width="16" height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName" width="33%"><a shape="rect" href="sample-applications.html">Sample applications</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent" width="33%"><sup><a shape="rect" href="documentation.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/up_16.gif" width="8" height="8"></a></sup><a shape="rect" href="documentation.html">Documentation</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName" width="33%"> </td></tr></table></div>
+ </div>
+ <div class="parent">
+ <a shape="rect" href="documentation.html" rel="parent">
+ <span class="aui-icon aui-icon-small atb-icon-arrow-up">Up</span>
+ <span class="title">Documentation</span>
+ </a>
+
+ </div>
+ <div class="next">
+
+ </div>
+</div>
-<h3><a shape="rect" name="Troubleshooting-Startupissues"></a>Startup issues</h3>
+<h3 id="Troubleshooting-Startupissues">Startup issues</h3>
<p>Most common startup issues are associated to port conflicts, check no other application is using or blocking Geronimo's default ports:</p>
<ul><li>1099</li><li>4242</li><li>9999</li><li>4201</li><li>1050</li><li>1527</li><li>61616</li><li>8080</li><li>8443</li><li>8009</li><li>25</li></ul>
Modified: websites/production/geronimo/content/GMOxDOC20/using-geronimos-default-javamail-session.html
==============================================================================
--- websites/production/geronimo/content/GMOxDOC20/using-geronimos-default-javamail-session.html (original)
+++ websites/production/geronimo/content/GMOxDOC20/using-geronimos-default-javamail-session.html Tue Jul 29 00:52:18 2014
@@ -23,6 +23,7 @@
<script src='http://geronimo.apache.org/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
<script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
<script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
<script type="text/javascript">
SyntaxHighlighter.defaults['toolbar'] = false;
@@ -95,25 +96,47 @@
<div class="pagecontent">
<div class="wiki-content">
- <div class="wiki-content maincontent"><style type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+ <div class="wiki-content maincontent">
+<div class="atb-scrollbar-macro">
+ <div class="prev">
+ <a shape="rect" href="specjappserver2004.html" rel="prev">
+ <span class="aui-icon aui-icon-small atb-icon-arrow-left">Previous</span>
+ <span class="title">SPECjAppServer2004</span>
+ </a>
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect" href="specjappserver2004.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/back_16.gif" width="16" height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName" width="33%"><a shape="rect" href="specjappserver2004.html">SPECjAppServer2004</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent" width="33%"><sup><a shape="rect" href="sample-applications.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/up_16.gif" width="8" height="8"></a></sup><a shape="rect" href="sample-applications.html">Sample applications</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName" width="33%"> <a shape="rect" href="using-jndi-in-geronimo-20.html">Using JNDI in Geronimo 2.0</a></td><td colspan="1" rowspan="1" class="ScrollbarNextIcon"><a shape="rec
t" href="using-jndi-in-geronimo-20.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></a></td></tr></table></div>
+ </div>
+ <div class="parent">
+ <a shape="rect" href="sample-applications.html" rel="parent">
+ <span class="aui-icon aui-icon-small atb-icon-arrow-up">Up</span>
+ <span class="title">Sample applications</span>
+ </a>
+
+ </div>
+ <div class="next">
+ <a shape="rect" href="using-jndi-in-geronimo-20.html" rel="next">
+ <span class="title">Using JNDI in Geronimo 2.0</span>
+ <span class="aui-icon aui-icon-small atb-icon-arrow-right">Next</span>
+ </a>
+
+ </div>
+</div>
-<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1">This was tested on trunk and should be the same steps for Geronimo v1.2 and v2.0 with minor changes specifically references to JavaMail module ID.</td></tr></table></div>
+ <div class="aui-message warning shadowed information-macro">
+ <span class="aui-icon icon-warning">Icon</span>
+ <div class="message-content">
+
+<p>This was tested on trunk and should be the same steps for Geronimo v1.2 and v2.0 with minor changes specifically references to JavaMail module ID.</p>
+ </div>
+ </div>
-<h2><a shape="rect" name="UsingGeronimo%27sdefaultJavaMailsession-InstallingApacheJAMES"></a>Installing Apache JAMES</h2>
+
+<h2 id="UsingGeronimo'sdefaultJavaMailsession-InstallingApacheJAMES">Installing Apache JAMES</h2>
<p>1. Download Apache JAMES from: <a shape="rect" class="external-link" href="http://apache2.openmirrors.org/james/server/binaries/james-2.3.0.zip" rel="nofollow">http://apache2.openmirrors.org/james/server/binaries/james-2.3.0.zip</a></p>
<p>2. Unzip file and run JAMES by executing: \james-2.3.0\bin\run.bat. You should see something like this:</p>
-<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
Phoenix 4.2
@@ -128,13 +151,13 @@ FetchMail Disabled
<p>3. Make sure JavaMail module is started:</p>
-<ul class="alternate" type="square"><li>For trunk and v2.0-M1: org.apache.geronimo.configs/javamail/2.0-SNAPSHOT/car (by default this is started)</li><li>For v1.2-beta: org.apache.geronimo.configs/javamail/1.2-beta/car (by default this is not started)</li><li>To start the module you can:</li></ul>
+<ul class="alternate"><li>For trunk and v2.0-M1: org.apache.geronimo.configs/javamail/2.0-SNAPSHOT/car (by default this is started)</li><li>For v1.2-beta: org.apache.geronimo.configs/javamail/1.2-beta/car (by default this is not started)</li><li>To start the module you can:</li></ul>
<p> a. Use the Web Console: Applications > System Modules > Click 'Start' link beside the JavaMail module ID<br clear="none">
b. Use command line deployer:</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
cd <geronimo_home>\bin
java -jar deployer.jar --user system --password manager start org.apache.geronimo.configs/javamail/2.0-SNAPSHOT/car
@@ -143,26 +166,33 @@ java -jar deployer.jar --user system --p
<p> c. Stop the server. Modify <geronimo_home>\var\config\config.xml and set JavaMail module load attribute to 'true':</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
...
-<module load="true" name="org.apache.geronimo.configs/javamail/2.0-SNAPSHOT/car">
- <gbean name="SMTPTransport">
- <attribute name="host">localhost</attribute>
- <attribute name="port">25</attribute>
+<module load="true" name="org.apache.geronimo.configs/javamail/2.0-SNAPSHOT/car">
+ <gbean name="SMTPTransport">
+ <attribute name="host">localhost</attribute>
+ <attribute name="port">25</attribute>
</gbean>
</module>
...
]]></script>
</div></div>
-<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1">You can configure the SMTP transport's host and port by overriding the values of the SMTPTransport GBean attrbitues. For our test we will use the default. This will allow us to connect to JAMES running in localhost and using port 25 (the default SMTP port).</td></tr></table></div>
+ <div class="aui-message warning shadowed information-macro">
+ <span class="aui-icon icon-warning">Icon</span>
+ <div class="message-content">
+
+<p>You can configure the SMTP transport's host and port by overriding the values of the SMTPTransport GBean attrbitues. For our test we will use the default. This will allow us to connect to JAMES running in localhost and using port 25 (the default SMTP port).</p>
+ </div>
+ </div>
+
-<h2><a shape="rect" name="UsingGeronimo%27sdefaultJavaMailsession-WebApplicationtoTest"></a>Web Application to Test</h2>
+<h2 id="UsingGeronimo'sdefaultJavaMailsession-WebApplicationtoTest">Web Application to Test</h2>
<p>Create a simple webapp containing the following files:</p>
-<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
sendmail.war
+ index.jsp
@@ -172,15 +202,15 @@ sendmail.war
]]></script>
</div></div>
-<p><b>web.xml:</b></p>
+<p><strong>web.xml:</strong></p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>web.xml</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>web.xml</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
-<?xml version="1.0" encoding="UTF-8"?>
-<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
- version="2.4">
+<?xml version="1.0" encoding="UTF-8"?>
+<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
+ version="2.4">
<display-name>Send Mail Webapp</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
@@ -196,12 +226,12 @@ sendmail.war
]]></script>
</div></div>
-<p><b>geronimo-web.xml:</b> This deployable is using Geronimo 2.0's JavaMail component, so it needs to specify where to look. It does this under the <dependencies> tag. As Geronimo changes, these paths need to be changed accordingly to ensure that it refers to the same things. Under the <resource-ref> element, it is referring to a JavaMail session. This is what allows the developer to reference resources that resides on the server. The <ref-name> element is used in the web.xml so the two must be consistent. The <resource-link> element specifies the default Geronimo mail session.</p>
+<p><strong>geronimo-web.xml:</strong> This deployable is using Geronimo 2.0's JavaMail component, so it needs to specify where to look. It does this under the <dependencies> tag. As Geronimo changes, these paths need to be changed accordingly to ensure that it refers to the same things. Under the <resource-ref> element, it is referring to a JavaMail session. This is what allows the developer to reference resources that resides on the server. The <ref-name> element is used in the web.xml so the two must be consistent. The <resource-link> element specifies the default Geronimo mail session.</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>geronimo-web.xml</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>geronimo-web.xml</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
-<?xml version="1.0" encoding="UTF-8"?>
-<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
+<?xml version="1.0" encoding="UTF-8"?>
+<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
<environment>
<moduleId>
<groupId>${pom.groupId}</groupId>
@@ -228,32 +258,32 @@ sendmail.war
]]></script>
</div></div>
-<p><b>index.jsp:</b></p>
+<p><strong>index.jsp:</strong></p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>index.jsp</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>index.jsp</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
-<%@page import="java.util.Date,
+<%@page import="java.util.Date,
javax.mail.Message,
javax.mail.Session,
javax.mail.Transport,
javax.mail.internet.InternetAddress,
javax.mail.internet.MimeMessage,
- javax.naming.InitialContext" %>
+ javax.naming.InitialContext" %>
<%
- String resultMsg = "";
- String action = request.getParameter("action");
- if ("Send".equals(action)) {
- String from = request.getParameter("from");
- String to = request.getParameter("to");
- String subject = request.getParameter("subject");
- String content = request.getParameter("message");
+ String resultMsg = "";
+ String action = request.getParameter("action");
+ if ("Send".equals(action)) {
+ String from = request.getParameter("from");
+ String to = request.getParameter("to");
+ String subject = request.getParameter("subject");
+ String content = request.getParameter("message");
// Get mail session and transport
InitialContext context = new InitialContext();
- // Mail session from web.xml's resource reference
- Session mailSession = (Session) context.lookup("java:comp/env/mail/testMailSession");
- Transport transport = mailSession.getTransport("smtp");
+ // Mail session from web.xml's resource reference
+ Session mailSession = (Session) context.lookup("java:comp/env/mail/testMailSession");
+ Transport transport = mailSession.getTransport("smtp");
// Setup message
MimeMessage message = new MimeMessage(mailSession);
@@ -271,10 +301,10 @@ sendmail.war
transport.send(message);
// Build result message
- resultMsg = "<b>Result:</b>";
- resultMsg += "<br>Message sent: " + new Date();
- resultMsg += "<br>To: " + to;
- resultMsg += "<br>From: " + from;
+ resultMsg = "<b>Result:</b>";
+ resultMsg += "<br>Message sent: " + new Date();
+ resultMsg += "<br>To: " + to;
+ resultMsg += "<br>From: " + from;
}
%>
@@ -286,27 +316,27 @@ sendmail.war
<form>
<table>
<tr>
- <td align="center" colspan="2"><b>Send Mail</b></td>
+ <td align="center" colspan="2"><b>Send Mail</b></td>
</tr>
<tr>
- <td align="right">From:</td>
- <td><input type="text" name="from"></td>
+ <td align="right">From:</td>
+ <td><input type="text" name="from"></td>
</tr>
<tr>
- <td align="right">To:</td>
- <td><input type="text" name="to"></td>
+ <td align="right">To:</td>
+ <td><input type="text" name="to"></td>
</tr>
<tr>
- <td align="right">Subject:</td>
- <td><input type="text" name="subject"></td>
+ <td align="right">Subject:</td>
+ <td><input type="text" name="subject"></td>
</tr>
<tr>
- <td align="right">Message:</td>
- <td><textarea rows="5" cols="20" name="message"></textarea></td>
+ <td align="right">Message:</td>
+ <td><textarea rows="5" cols="20" name="message"></textarea></td>
</tr>
<tr>
- <td align="right" colspan="2">
- <input type="submit" name="action" value="Send">&nbsp;<input type="reset"></td>
+ <td align="right" colspan="2">
+ <input type="submit" name="action" value="Send">&nbsp;<input type="reset"></td>
</td>
</tr>
</table>
@@ -317,33 +347,33 @@ sendmail.war
]]></script>
</div></div>
-<h2><a shape="rect" name="UsingGeronimo%27sdefaultJavaMailsession-BuildingandDeployingtheWebApplication"></a>Building and Deploying the Web Application</h2>
+<h2 id="UsingGeronimo'sdefaultJavaMailsession-BuildingandDeployingtheWebApplication">Building and Deploying the Web Application</h2>
<p>Download the sendmail application from the following link:<br clear="none">
-<a shape="rect" href="using-geronimos-default-javamail-session.data/sendmail_.zip?version=1&modificationDate=1182946495000">sendmail</a></p>
+<a shape="rect" href="using-geronimos-default-javamail-session.data/sendmail_.zip?version=1&modificationDate=1182946495000&api=v2">sendmail</a></p>
<p>After decompressing the given file, the sendmail directory will be created.</p>
-<h3><a shape="rect" name="UsingGeronimo%27sdefaultJavaMailsession-SourceCode"></a>Source Code</h3>
+<h3 id="UsingGeronimo'sdefaultJavaMailsession-SourceCode">Source Code</h3>
<p>You can checkout the source code of this sample from SVN:</p>
<p>svn checkout <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/geronimo/samples/trunk/samples/sendmail">http://svn.apache.org/repos/asf/geronimo/samples/trunk/samples/sendmail</a></p>
-<h3><a shape="rect" name="UsingGeronimo%27sdefaultJavaMailsession-BuildingtheWebApplication"></a>Building the Web Application</h3>
-<p>The <b>sendmail</b> folder will already contain an ear file ready to be deployed. However, you can still play with the source and build it yourself.</p>
+<h3 id="UsingGeronimo'sdefaultJavaMailsession-BuildingtheWebApplication">Building the Web Application</h3>
+<p>The <strong>sendmail</strong> folder will already contain an ear file ready to be deployed. However, you can still play with the source and build it yourself.</p>
-<p>Use a command prompt to navigate into the <b>sendmail</b> directory and just give <b>mvn install site</b> command to build. It will overwrite the <b>sendmail-ear-2.0-SNAPSHOT.ear</b> under the <b>sendmail</b> folder.</p>
+<p>Use a command prompt to navigate into the <strong>sendmail</strong> directory and just give <strong>mvn install site</strong> command to build. It will overwrite the <strong>sendmail-ear-2.0-SNAPSHOT.ear</strong> under the <strong>sendmail</strong> folder.</p>
-<h3><a shape="rect" name="UsingGeronimo%27sdefaultJavaMailsession-DeployingtheWebApplication"></a>Deploying the Web Application</h3>
-<ol><li>Navigate to <b>Deploy New</b> from the Console Navigation panel.</li><li>Load <b>sendmail-ear-2.0-SNAPSHOT.ear</b> from <b>sendmail</b> folder in to the <b>Archive</b> input box.</li><li>Press <b>Install</b> button to deploy application in the server.</li></ol>
+<h3 id="UsingGeronimo'sdefaultJavaMailsession-DeployingtheWebApplication">Deploying the Web Application</h3>
+<ol><li>Navigate to <strong>Deploy New</strong> from the Console Navigation panel.</li><li>Load <strong>sendmail-ear-2.0-SNAPSHOT.ear</strong> from <strong>sendmail</strong> folder in to the <strong>Archive</strong> input box.</li><li>Press <strong>Install</strong> button to deploy application in the server.</li></ol>
<p>5. Test send mail webapp by going to: <a shape="rect" class="external-link" href="http://localhost:8080/sendmail" rel="nofollow">http://localhost:8080/sendmail</a></p>
<p>Fill up the form (From, To, Subject, Message fields) and click 'Send' button. You should get a similar message if the mail was sent successfully:</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
Result:
Message sent: Fri Dec 15 01:10:05 PST 2006
Modified: websites/production/geronimo/content/GMOxDOC20/using-j2g.html
==============================================================================
--- websites/production/geronimo/content/GMOxDOC20/using-j2g.html (original)
+++ websites/production/geronimo/content/GMOxDOC20/using-j2g.html Tue Jul 29 00:52:18 2014
@@ -23,6 +23,7 @@
<script src='http://geronimo.apache.org/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
<script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
<script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script src='http://geronimo.apache.org/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
<script type="text/javascript">
SyntaxHighlighter.defaults['toolbar'] = false;
@@ -95,41 +96,67 @@
<div class="pagecontent">
<div class="wiki-content">
- <div class="wiki-content maincontent"><style type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+ <div class="wiki-content maincontent">
+<div class="atb-scrollbar-macro">
+ <div class="prev">
+ <a shape="rect" href="building-j2g-from-source.html" rel="prev">
+ <span class="aui-icon aui-icon-small atb-icon-arrow-left">Previous</span>
+ <span class="title">Building J2G from source</span>
+ </a>
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect" href="building-j2g-from-source.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/back_16.gif" width="16" height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName" width="33%"><a shape="rect" href="building-j2g-from-source.html">Building J2G from source</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent" width="33%"><sup><a shape="rect" href="j2g-migration-tool.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/up_16.gif" width="8" height="8"></a></sup><a shape="rect" href="j2g-migration-tool.html">J2G Migration Tool</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName" width="33%"> </td></tr></table></div>
-<style type="text/css">/*<![CDATA[*/
-div.rbtoc1250217940005 {margin-left: 1.5em;padding: 0px;}
-div.rbtoc1250217940005 ul {list-style: disc;margin-left: 0px;padding-left: 20px;}
-div.rbtoc1250217940005 li {margin-left: 0px;padding-left: 0px;}
+ </div>
+ <div class="parent">
+ <a shape="rect" href="j2g-migration-tool.html" rel="parent">
+ <span class="aui-icon aui-icon-small atb-icon-arrow-up">Up</span>
+ <span class="title">J2G Migration Tool</span>
+ </a>
-/*]]>*/</style><div class="rbtoc1250217940005">
-<ul><li><a shape="rect" href="#UsingJ2G-Components">Components</a></li><ul><li><a shape="rect" href="#UsingJ2G-Dependencies">Dependencies</a></li><ul><li><a shape="rect" href="#UsingJ2G-EnvironmentVariables">Environment Variables</a></li></ul><li><a shape="rect" href="#UsingJ2G-Configurator">Configurator</a></li><li><a shape="rect" href="#UsingJ2G-SourceIdentificationToolSummary">Source Identification Tool Summary</a></li><li><a shape="rect" href="#UsingJ2G-DescriptorsConversionToolSummary">Descriptors Conversion Tool Summary</a></li><li><a shape="rect" href="#UsingJ2G-ResourceConversionToolSummary">Resource Conversion Tool Summary</a></li></ul><li><a shape="rect" href="#UsingJ2G-SourceIdentificationTool">Source Identification Tool</a></li><ul><li><a shape="rect" href="#UsingJ2G-Description">Description</a></li><ul><li><a shape="rect" href="#UsingJ2G-Specifyingadditionalclasses">Specifying additional classes</a></li></ul><li><a shape="rect" href="#UsingJ2G-RunningtheSourceIdentifica
tionToolEclipseGUI">Running the Source Identification Tool - Eclipse GUI</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheSourceIdentificationToolCommandLine">Running the Source Identification Tool - Command Line</a></li></ul><li><a shape="rect" href="#UsingJ2G-DescriptorsConversionTool">Descriptors Conversion Tool</a></li><ul><li><a shape="rect" href="#UsingJ2G-Description">Description</a></li><ul><li><a shape="rect" href="#UsingJ2G-Annotations%28forEJB3.0%29">Annotations (for EJB 3.0)</a></li><li><a shape="rect" href="#UsingJ2G-Specifyingadditionalannotations">Specifying additional annotations</a></li><li><a shape="rect" href="#UsingJ2G-OpenEJB">OpenEJB</a></li><li><a shape="rect" href="#UsingJ2G-SpecifyingadditionalOpenEJBassociationsforpersistence.xml">Specifying additional OpenEJB associations for persistence.xml</a></li></ul><li><a shape="rect" href="#UsingJ2G-RunningtheDescriptorsConversionToolEclipseGUI">Running the Descriptors Conversion Tool - Eclipse GUI</a></li><li>
<a shape="rect" href="#UsingJ2G-RunningtheDescriptorsConversionToolCommandLine">Running the Descriptors Conversion Tool - Command Line</a></li></ul><li><a shape="rect" href="#UsingJ2G-ResourceMigrationTool">Resource Migration Tool</a></li><ul><li><a shape="rect" href="#UsingJ2G-Description">Description</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheResourceMigrationToolEclipseGUI">Running the Resource Migration Tool - Eclipse GUI</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheResourceMigrationToolCommandLine">Running the Resource Migration Tool - Command Line</a></li></ul><li><a shape="rect" href="#UsingJ2G-Completion">Completion</a></li></ul></div>
+ </div>
+ <div class="next">
+
+ </div>
+</div>
+<style type="text/css">/*<![CDATA[*/
+div.rbtoc1406595053264 {padding: 0px;}
+div.rbtoc1406595053264 ul {list-style: disc;margin-left: 0px;padding-left: 20px;}
+div.rbtoc1406595053264 li {margin-left: 0px;padding-left: 0px;}
+
+/*]]>*/</style><div class="toc-macro rbtoc1406595053264">
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Components">Components</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Dependencies">Dependencies</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-EnvironmentVariables">Environment Variables</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-Configurator">Configurator</a></li><li><a shape="rect" href="#UsingJ2G-SourceIdentificationToolSummary">Source Identification Tool Summary</a></li><li><a shape="rect" href="#UsingJ2G-DescriptorsConversionToolSummary">Descriptors Conversion Tool Summary</a></li><li><a shape="rect" href="#UsingJ2G-ResourceConversionToolSummary">Resource Conversion Tool Summary</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-SourceIdentificationTool">Source Identification Tool</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Description">Description</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Specifyingadditionalclasses">Specifying additional classes</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-RunningtheSourceIdentificationTool-EclipseGUI">Running the Source Identification Tool - Eclipse GUI</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheSourceIdentificationTool-CommandLine">Running the Source Identification Tool - Command Line</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-DescriptorsConversionTool">Descriptors Conversion Tool</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Description.1">Description</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Annotations(forEJB3.0)">Annotations (for EJB 3.0)</a></li><li><a shape="rect" href="#UsingJ2G-Specifyingadditionalannotations">Specifying additional annotations</a></li><li><a shape="rect" href="#UsingJ2G-OpenEJB">OpenEJB</a></li><li><a shape="rect" href="#UsingJ2G-SpecifyingadditionalOpenEJBassociationsforpersistence.xml">Specifying additional OpenEJB associations for persistence.xml</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-RunningtheDescriptorsConversionTool-EclipseGUI">Running the Descriptors Conversion Tool - Eclipse GUI</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheDescriptorsConversionTool-CommandLine">Running the Descriptors Conversion Tool - Command Line</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-ResourceMigrationTool">Resource Migration Tool</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#UsingJ2G-Description.2">Description</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheResourceMigrationTool-EclipseGUI">Running the Resource Migration Tool - Eclipse GUI</a></li><li><a shape="rect" href="#UsingJ2G-RunningtheResourceMigrationTool-CommandLine">Running the Resource Migration Tool - Command Line</a></li></ul>
+</li><li><a shape="rect" href="#UsingJ2G-Completion">Completion</a></li></ul>
+</div>
-<h1><a shape="rect" name="UsingJ2G-Components"></a>Components</h1>
+<h1 id="UsingJ2G-Components">Components</h1>
<p>J2G consists of three executable utilities with basic Eclipse IDE UI extensions. The "Configurator" component, and the three major components, each of which have relatively specific functions, and must be run in the order as follows.</p>
-<h2><a shape="rect" name="UsingJ2G-Dependencies"></a>Dependencies</h2>
+<h2 id="UsingJ2G-Dependencies">Dependencies</h2>
<p>The J2G tool set requires at least the following application versions<br clear="none">
(these are the versions J2G is known to work on)</p>
<ul><li>Sun JDK 5.0+ (J2SE 1.5)</li><li>Eclipse SDK 3.3M7 with JDT Core Plug-in</li><li>Apache Geronimo 1.1.1 and up</li><li>Application written for JBoss 3.2 and up or J2EE 1.2 and up.</li></ul>
-<h3><a shape="rect" name="UsingJ2G-EnvironmentVariables"></a>Environment Variables</h3>
+<h3 id="UsingJ2G-EnvironmentVariables">Environment Variables</h3>
<p>The tools in J2G require that the following environment variables be set to the proper locations:</p>
<ul><li>JAVA_HOME (Location of the JDK)</li><li>ECLIPSE_HOME (Location of the Eclipse SDK)</li><li>WORKSPACE (Location for a temporary eclipse workspace)</li></ul>
-<h2><a shape="rect" name="UsingJ2G-Configurator"></a>Configurator</h2>
+<h2 id="UsingJ2G-Configurator">Configurator</h2>
<p>To run this component, navigate to bin, and run j2g-configure</p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
@@ -187,23 +214,30 @@ user@lappy-486:~/j2g/bin$
</div></div>
<p>This will automatically copy the contents of the ./plugins, ./properties, and ./compatibility directories to ECLIPSE_HOME/plugins, as well as make changes to (or create, if necessary) ECLIPSE_HOME/configuration/config.ini.</p>
-<h2><a shape="rect" name="UsingJ2G-SourceIdentificationToolSummary"></a>Source Identification Tool Summary</h2>
+<h2 id="UsingJ2G-SourceIdentificationToolSummary">Source Identification Tool Summary</h2>
<p>This tool parses through source code (.java and .jsp files) recursively in directories passed to it as command line arguments. While doing this, it replaces any JBoss classes and dependencies for which there are Geronimo equivalents. If there is no equivalent, it will alert the user of this issue which must be resolved either through manual creation of a replacement class or rewriting the segment of code dependent on the JBoss class.</p>
-<h2><a shape="rect" name="UsingJ2G-DescriptorsConversionToolSummary"></a>Descriptors Conversion Tool Summary</h2>
+<h2 id="UsingJ2G-DescriptorsConversionToolSummary">Descriptors Conversion Tool Summary</h2>
<p>This tool converts JBoss specific deployment descriptors and J2EE standard deployment descriptors (if necessary) to their Geronimo equivalents.</p>
-<h2><a shape="rect" name="UsingJ2G-ResourceConversionToolSummary"></a>Resource Conversion Tool Summary</h2>
+<h2 id="UsingJ2G-ResourceConversionToolSummary">Resource Conversion Tool Summary</h2>
<p>This tool converts JBoss specific resources, such as Java Messaging Services (JMS) Queues, JMS Topics, Java Database Connectivity (JDBC) data sources to their Geronimo equivalents.</p>
-<h1><a shape="rect" name="UsingJ2G-SourceIdentificationTool"></a>Source Identification Tool</h1>
+<h1 id="UsingJ2G-SourceIdentificationTool">Source Identification Tool</h1>
-<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1">It is <b>strongly advised</b> to create a backup of the application source before running J2G</td></tr></table></div>
+ <div class="aui-message warning shadowed information-macro">
+ <span class="aui-icon icon-warning">Icon</span>
+ <div class="message-content">
+
+<p>It is <strong>strongly advised</strong> to create a backup of the application source before running J2G</p>
+ </div>
+ </div>
-<h2><a shape="rect" name="UsingJ2G-Description"></a>Description</h2>
+
+<h2 id="UsingJ2G-Description">Description</h2>
<p>The Source Identification Tool should be started first. It scans the sources and identifies files that need to be changed during the migration process. These files include Java classes (.java files), JSPs (.jsp files), as well as files with an overridden JSP file extension, specified with the argument -jspext. (For example: -jspext html for .html files)</p>
@@ -212,9 +246,7 @@ user@lappy-486:~/j2g/bin$
<p>When the tool checks for usage of APIs incompatible with Geronimo, these JBoss classes are automatically replaced with Geronimo compatible classes</p>
-<div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> JBoss Class </th><th colspan="1" rowspan="1" class="confluenceTh"> Geronimo Compatible Class </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> org.jboss.security.SimplePrincipal </td><td colspan="1" rowspan="1" class="confluenceTd"> org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> org.jboss.security.auth.spi.DigestCallback </td><td colspan="1" rowspan="1" class="confluenceTd"> org.apache.geronimo.j2g.sources.dependence.compatibility.DigestCallback </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> org.jboss.security.Nobody </td><td colspan="1" rowspan="1" class="confluenceTd"> org.apache.geronimo.j2g.sources.dependence.compatibility.Nobody </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> org.jboss.security.Anybody </td><td colspan="1" rowspan="1" class="confluenceTd"> or
g.apache.geronimo.j2g.sources.dependence.compatibility.Anybody </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> org.jboss.security.auth.spi.UsernamePasswordLoginModule </td><td colspan="1" rowspan="1" class="confluenceTd"> org.apache.geronimo.j2g.sources.dependence.compatibility.GeronimoLoginModule </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> org.jboss.security.SimpleGroup </td><td colspan="1" rowspan="1" class="confluenceTd"> org.apache.geronimo.j2g.sources.dependence.compatibility.GeronimoSimpleGroup </td></tr></tbody></table>
-</div>
+<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> JBoss Class </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Geronimo Compatible Class </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> org.jboss.security.SimplePrincipal </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> org.jboss.security.auth.spi.DigestCallback </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> org.apache.geronimo.j2g.sources.dependence.compatibility.DigestCallback </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> org.jboss.security.Nobody </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> org.apache.geronimo.j2g.sources.dependence.compatibility.Nobody </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> o
rg.jboss.security.Anybody </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> org.apache.geronimo.j2g.sources.dependence.compatibility.Anybody </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> org.jboss.security.auth.spi.UsernamePasswordLoginModule </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> org.apache.geronimo.j2g.sources.dependence.compatibility.GeronimoLoginModule </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> org.jboss.security.SimpleGroup </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> org.apache.geronimo.j2g.sources.dependence.compatibility.GeronimoSimpleGroup </p></td></tr></tbody></table></div>
<p>Any references beyond the table above must be manually corrected so that they are no longer dependent on parts of JBoss. It's important to note that JSP file processing is limited to the identification of problems, and automatic correction is not currently supported.</p>
@@ -222,33 +254,33 @@ user@lappy-486:~/j2g/bin$
<p>When a source file is changed automatically by the Source Identification Tool, the original version is saved with the .j2g extension and an informational message is printed out. In all other cases, when a problem needs to be fixed manually, the tool simply prints a warning message.</p>
-<h3><a shape="rect" name="UsingJ2G-Specifyingadditionalclasses"></a>Specifying additional classes</h3>
+<h3 id="UsingJ2G-Specifyingadditionalclasses">Specifying additional classes</h3>
-<p>Additional drop-in replacements for JBoss specific classes can be user-defined by modifying <b><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.sources.dependence/class_analogies.properties</b> to include the proper relationship, as well as <b><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.sources.dependence/compatible_sources.properties</b> to include the class name. The source code for these replacement classes must be placed in the directory <b><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.sources.dependence.compatibility</b> for proper inclusion.</p>
+<p>Additional drop-in replacements for JBoss specific classes can be user-defined by modifying <strong><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.sources.dependence/class_analogies.properties</strong> to include the proper relationship, as well as <strong><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.sources.dependence/compatible_sources.properties</strong> to include the class name. The source code for these replacement classes must be placed in the directory <strong><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.sources.dependence.compatibility</strong> for proper inclusion.</p>
<p>Classes that already exist within Geronimo jars can also be added into the class-analogies.properties file. These classes do not need to be placed within the compatibility directory but a dependency will have to be added to the corresponding xml in the converted application.</p>
<p>Below is an example of the default class_analogies.properties file</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>class_analogies.properties</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>class_analogies.properties</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
-# (the "License"); you may not use this file except in compliance with
+# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
###########################################################################################################
-# Jboss classes and it's analogies.
+# Jboss classes and it's analogies.
###########################################################################################################
org.jboss.security.SimplePrincipal = org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal
org.jboss.security.auth.spi.DigestCallback = org.apache.geronimo.j2g.sources.dependence.compatibility.DigestCallback
@@ -259,20 +291,20 @@ org.jboss.security.SimpleGroup = org.apa
]]></script>
</div></div>
<p>Below is an example of the default compatible_sources.properties file</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>compatible_sources.properties</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>compatible_sources.properties</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
-# (the "License"); you may not use this file except in compliance with
+# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
@@ -289,28 +321,28 @@ org.apache.geronimo.j2g.sources.dependen
]]></script>
</div></div>
-<h2><a shape="rect" name="UsingJ2G-RunningtheSourceIdentificationToolEclipseGUI"></a>Running the Source Identification Tool - Eclipse GUI</h2>
+<h2 id="UsingJ2G-RunningtheSourceIdentificationTool-EclipseGUI">Running the Source Identification Tool - Eclipse GUI</h2>
<p>To run this component within the Eclipse IDE GUI, the left panel must first be in Navigator view.</p>
<p>Once in the Navigator view, it is possible to right click and select J2G Migration from the context menu.<br clear="none">
-<span class="image-wrap" style=""><img src="using-j2g.data/menu.png" style="border: 0px solid black"></span></p>
+<img class="confluence-embedded-image" src="https://cwiki.apache.org/confluence/download/attachments/62472/menu.png?version=1&modificationDate=1185448214000&api=v2" data-image-src="/confluence/download/attachments/62472/menu.png?version=1&modificationDate=1185448214000&api=v2"></p>
<p>Within the J2G Migration sub menu, select "1. Source Identification Tool (jsrc2g)", and follow the prompts given.</p>
<p>Output will be displayed in the bottom portion of the Eclipse IDE, within the integrated Console window.<br clear="none">
-<span class="image-wrap" style=""><img src="using-j2g.data/output.png" style="border: 0px solid black"></span></p>
+<img class="confluence-embedded-image" src="https://cwiki.apache.org/confluence/download/attachments/62472/output.png?version=1&modificationDate=1185448214000&api=v2" data-image-src="/confluence/download/attachments/62472/output.png?version=1&modificationDate=1185448214000&api=v2"></p>
-<h2><a shape="rect" name="UsingJ2G-RunningtheSourceIdentificationToolCommandLine"></a>Running the Source Identification Tool - Command Line</h2>
+<h2 id="UsingJ2G-RunningtheSourceIdentificationTool-CommandLine">Running the Source Identification Tool - Command Line</h2>
<p>To run this component, execute the following command from the j2g bin directory, with <APPLICATION> representing the path to the application you are converting, and <GERONIMO_HOME> representing the path to Geronimo 2.0.</p>
-<p>*<b>nix</b></p>
+<p>*<strong>nix</strong></p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
<pre>./jsrc2g.sh -src <APPLICATION>/src -web <APPLICATION>/web -geronimo <GERONIMO_HOME>
</pre>
</div></div>
-<p><b>Windows</b></p>
+<p><strong>Windows</strong></p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
<pre>jsrc2g.bat -src <APPLICATION>\src -web <APPLICATION>\web -geronimo <GERONIMO_HOME>
</pre>
@@ -322,78 +354,81 @@ org.apache.geronimo.j2g.sources.dependen
</div></div>
<p>After the tool runs (which may take a few seconds, depending on system speed and the complexity of the application), it will display all warnings and errors to console output. These messages should be interpreted and corrected as seen fit by the user. Once changes have been made, the sources tool can be ran again to verify correctness.</p>
-<h1><a shape="rect" name="UsingJ2G-DescriptorsConversionTool"></a>Descriptors Conversion Tool</h1>
+<h1 id="UsingJ2G-DescriptorsConversionTool">Descriptors Conversion Tool</h1>
-<h2><a shape="rect" name="UsingJ2G-Description"></a>Description</h2>
+<h2 id="UsingJ2G-Description.1">Description</h2>
<p>The Descriptors Conversion Tool finds and tries to automatically convert the following deployment descriptors so that they are accepted by Geronimo:</p>
-<div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Filename </th><th colspan="1" rowspan="1" class="confluenceTh"> Purpose </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> application.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> J2EE application deployment descriptor </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> jboss-app.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> JBoss specific descriptor for elements such as security domain, class loader configuration as well as some others </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> web.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> Web application descriptor </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> jboss-web.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> JBoss specific descriptor for elements such as security roles, session settings, web service configuration. It is used to int
egrate a web application into JBoss deployment </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> ejb-jar.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> EJB deployment descriptor </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> jboss.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> JBoss descriptor providing any optional information like custom container configurations for the beans or JNDI names. It is used by JBoss but not described in the respective ejb-jar.xml </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> jbosscmp-jdbc.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> JBossCMP-JDBC configuration file describing CMP-Database mappings, and key generation information </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> standardjbosscmp-jdbc.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> Default JBossCMP-JDBC configuration file </td></tr><tr><td colspan="1" rowspan="1" class="confluen
ceTd"> persistence.xml </td><td colspan="1" rowspan="1" class="confluenceTd"> Datasource connection configuration file </td></tr></tbody></table>
-</div>
+<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> Filename </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Purpose </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> application.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> J2EE application deployment descriptor </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> jboss-app.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> JBoss specific descriptor for elements such as security domain, class loader configuration as well as some others </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> web.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Web application descriptor </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> jboss-web.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> JBoss specific descriptor for eleme
nts such as security roles, session settings, web service configuration. It is used to integrate a web application into JBoss deployment </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> ejb-jar.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> EJB deployment descriptor </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> jboss.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> JBoss descriptor providing any optional information like custom container configurations for the beans or JNDI names. It is used by JBoss but not described in the respective ejb-jar.xml </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> jbosscmp-jdbc.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> JBossCMP-JDBC configuration file describing CMP-Database mappings, and key generation information </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> standardjbosscmp-jdbc.xml </p></td><td c
olspan="1" rowspan="1" class="confluenceTd"><p> Default JBossCMP-JDBC configuration file </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> persistence.xml </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Datasource connection configuration file </p></td></tr></tbody></table></div>
<p>Note: Geronimo uses OpenEJB, which requires its own descriptor (openejb-jar.xml). There may be some instances where a jboss.xml is not given. In these cases, the openejb-jar.xml will be created on the top-most level directory in the source path that is specified to J2G.</p>
-<h3><a shape="rect" name="UsingJ2G-Annotations%28forEJB3.0%29"></a>Annotations (for EJB 3.0)</h3>
+<h3 id="UsingJ2G-Annotations(forEJB3.0)">Annotations (for EJB 3.0)</h3>
<p>The standard EJB annotations are supported by both Geronimo and JBoss. There are differences, however, in the attributes provided in some of the annotations.<br clear="none">
Below is a list of all standard attribute differences provided that may occur within the specified annotations.</p>
-<div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Annotation </th><th colspan="1" rowspan="1" class="confluenceTh"> JBoss Attribute </th><th colspan="1" rowspan="1" class="confluenceTh"> Geronimo Attribute </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> Resource </td><td colspan="1" rowspan="1" class="confluenceTd"> mappedName </td><td colspan="1" rowspan="1" class="confluenceTd"> name </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> EJB </td><td colspan="1" rowspan="1" class="confluenceTd"> mappedName </td><td colspan="1" rowspan="1" class="confluenceTd"> name </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> MessageDriven </td><td colspan="1" rowspan="1" class="confluenceTd"> mappedName </td><td colspan="1" rowspan="1" class="confluenceTd"> name </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> Stateful </td><td colspan="1" rowspan="1" class="confluenceTd"> mappedName </td><td cols
pan="1" rowspan="1" class="confluenceTd"> name </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> Stateless </td><td colspan="1" rowspan="1" class="confluenceTd"> mappedName </td><td colspan="1" rowspan="1" class="confluenceTd"> name </td></tr></tbody></table>
-</div>
+<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> Annotation </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> JBoss Attribute </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Geronimo Attribute </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> Resource </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> mappedName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> name </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> EJB </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> mappedName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> name </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> MessageDriven </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> mappedName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> name </p></td></tr><tr><td colspan="1" rowspan="1" cl
ass="confluenceTd"><p> Stateful </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> mappedName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> name </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> Stateless </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> mappedName </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> name </p></td></tr></tbody></table></div>
<p>Any references beyond the table above must be manually corrected so that they are no longer dependent on parts of JBoss.</p>
-<div class="panelMacro"><table class="noteMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1">JBoss has their own EJB annotation extensions. These must be manually corrected as needed</td></tr></table></div>
+ <div class="aui-message warning shadowed information-macro">
+ <span class="aui-icon icon-warning">Icon</span>
+ <div class="message-content">
+
+<p>JBoss has their own EJB annotation extensions. These must be manually corrected as needed</p>
+ </div>
+ </div>
+
-<h3><a shape="rect" name="UsingJ2G-Specifyingadditionalannotations"></a>Specifying additional annotations</h3>
+<h3 id="UsingJ2G-Specifyingadditionalannotations">Specifying additional annotations</h3>
-<p>Additional drop-in replacements for JBoss specific annotation attributes can be user-defined by modifying <b><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.descriptors.ejb.annotation/annotation_differences.properties</b> to include the proper relationship. Because the nature of these mappings are not one-to-one, we cannot format the properties in the traditional format of <em><annotation>=<attribute></em>. Instead, the proper formatting is as follows:</p>
+<p>Additional drop-in replacements for JBoss specific annotation attributes can be user-defined by modifying <strong><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.descriptors.ejb.annotation/annotation_differences.properties</strong> to include the proper relationship. Because the nature of these mappings are not one-to-one, we cannot format the properties in the traditional format of <em><annotation>=<attribute></em>. Instead, the proper formatting is as follows:</p>
<p>In the case of a standard EJB annotation</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
<property> :: <annotation>=<mapping>
]]></script>
</div></div>
-<p>Where <b><annotation></b> is a standard EJB annotation</p>
+<p>Where <strong><annotation></strong> is a standard EJB annotation</p>
<p>In the case of a standard jBoss specific to Geronimo compatible relationship</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
<mapping> :: <j_attribute>--><g_attribute>
]]></script>
</div></div>
-<p>Where <b><j_attribute></b> is a JBoss supported attribute and <b><g_attribute></b> is a Geronimo supported attribute</p>
+<p>Where <strong><j_attribute></strong> is a JBoss supported attribute and <strong><g_attribute></strong> is a Geronimo supported attribute</p>
<p>Finally, in the case of needing multiple attribute mappings for a single annotation</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
<mapping> :: <j_attribute>--><g_attribute>,<mapping>
]]></script>
</div></div>
-<p>Where <b><j_attribute></b> is a JBoss supported attribute and <b><g_attribute></b> is a Geronimo supported attribute</p>
+<p>Where <strong><j_attribute></strong> is a JBoss supported attribute and <strong><g_attribute></strong> is a Geronimo supported attribute</p>
<p>Below is an example of the default annotation_differences.properties file</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>annotation_differences.properties</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>annotation_differences.properties</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
-# (the "License"); you may not use this file except in compliance with
+# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
###########################################################################
-# Jboss classes and it's analogies.
+# Jboss classes and it's analogies.
###########################################################################
Resource = mappedName-->name
EJB = mappedName-->name
@@ -403,34 +438,32 @@ Stateless = mappedName-->name
]]></script>
</div></div>
-<h3><a shape="rect" name="UsingJ2G-OpenEJB"></a>OpenEJB</h3>
+<h3 id="UsingJ2G-OpenEJB">OpenEJB</h3>
<p>When the tool checks for usage of EJB references incompatible with Geronimo, these JBoss EJB references are automatically replaced with Geronimo compatible OpenEJB references. Here is are the differences specified to change in the persistence.xml (used in EJB 3.0) so that the configurations are consistent.</p>
-<div class="table-wrap">
-<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> JBoss EJB </th><th colspan="1" rowspan="1" class="confluenceTh"> Geronimo OpenEJB </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> hibernate.connection.url </td><td colspan="1" rowspan="1" class="confluenceTd"> openjpa.ConnectionURL </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> hibernate.connection.driver_class </td><td colspan="1" rowspan="1" class="confluenceTd"> openjpa.ConnectionDriverName </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> hibernate.connection.password </td><td colspan="1" rowspan="1" class="confluenceTd"> openjpa.ConnectionPassword </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> hibernate.connection.username </td><td colspan="1" rowspan="1" class="confluenceTd"> openjpa.ConnectionUserName </td></tr></tbody></table>
-</div>
+<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> JBoss EJB </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Geronimo OpenEJB </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> hibernate.connection.url </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> openjpa.ConnectionURL </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> hibernate.connection.driver_class </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> openjpa.ConnectionDriverName </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> hibernate.connection.password </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> openjpa.ConnectionPassword </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> hibernate.connection.username </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> openjpa.ConnectionUserName </p></td></tr></tbody></table></d
iv>
<p>Any references beyond the table above must be manually corrected so that they are no longer dependent on parts of JBoss.</p>
-<h3><a shape="rect" name="UsingJ2G-SpecifyingadditionalOpenEJBassociationsforpersistence.xml"></a>Specifying additional OpenEJB associations for persistence.xml</h3>
+<h3 id="UsingJ2G-SpecifyingadditionalOpenEJBassociationsforpersistence.xml">Specifying additional OpenEJB associations for persistence.xml</h3>
-<p>Additional drop-in replacements for JBoss specific annotations can be user-defined by modifying <b><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.descriptors.ejb/persistence_differences.properties</b> to include the proper relationship</p>
+<p>Additional drop-in replacements for JBoss specific annotations can be user-defined by modifying <strong><ECLIPSE_HOME>/plugins/org.apache.geronimo.j2g.descriptors.ejb/persistence_differences.properties</strong> to include the proper relationship</p>
<p>Below is an example of the default persistence_differences.properties file</p>
-<div class="code panel" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>persistence_differences.properties</b></div><div class="codeContent panelContent">
+<div class="code panel pdl" style="border-style: solid;border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;border-bottom-style: solid;"><b>persistence_differences.properties</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[
#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
-# (the "License"); you may not use this file except in compliance with
+# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
@@ -445,9 +478,9 @@ hibernate.connection.username = openjpa.
hibernate.hbm2ddl.auto = suggestion:openjpa.jdbc.SynchronizeMappings
]]></script>
</div></div>
-<p>In order to just suggest to the user that X may be a replacement for Y (this is conditional because this is not a direct translation) the property can be written as <b><Y> = suggestion:<X></b>.</p>
+<p>In order to just suggest to the user that X may be a replacement for Y (this is conditional because this is not a direct translation) the property can be written as <strong><Y> = suggestion:<X></strong>.</p>
-<h2><a shape="rect" name="UsingJ2G-RunningtheDescriptorsConversionToolEclipseGUI"></a>Running the Descriptors Conversion Tool - Eclipse GUI</h2>
+<h2 id="UsingJ2G-RunningtheDescriptorsConversionTool-EclipseGUI">Running the Descriptors Conversion Tool - Eclipse GUI</h2>
<p>To run this component within the Eclipse IDE GUI, the left panel must first be in Navigator view.</p>
@@ -456,26 +489,26 @@ hibernate.hbm2ddl.auto = suggestion:open
<p>Within the J2G Migration sub menu, select "2. Descriptors Conversion Tool (jdes2g)", and follow the prompts given.<br clear="none">
Output will be displayed in the bottom portion of the Eclipse IDE, within the integrated Console window.</p>
-<h2><a shape="rect" name="UsingJ2G-RunningtheDescriptorsConversionToolCommandLine"></a>Running the Descriptors Conversion Tool - Command Line</h2>
+<h2 id="UsingJ2G-RunningtheDescriptorsConversionTool-CommandLine">Running the Descriptors Conversion Tool - Command Line</h2>
<p>To start the Descriptors Conversion Tool run the following command from the j2g bin directory, again where <APPLICATION> represents the path to the application to be converted</p>
-<p>*<b>nix</b></p>
+<p>*<strong>nix</strong></p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
<pre>./jdesc2g.sh <APPLICATION>
</pre>
</div></div>
-<p><b>Windows</b></p>
+<p><strong>Windows</strong></p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
<pre>jdesc2g.bat <APPLICATION>
</pre>
</div></div>
<p>The warnings given in the output of this tool will report only unsupported elements that cannot be automatically converted, and must therefore be manually resolved and converted. This process is heavily dependent on the structure of the application being converted, and is therefore beyond the scope of this document.</p>
-<h1><a shape="rect" name="UsingJ2G-ResourceMigrationTool"></a>Resource Migration Tool</h1>
+<h1 id="UsingJ2G-ResourceMigrationTool">Resource Migration Tool</h1>
-<h2><a shape="rect" name="UsingJ2G-Description"></a>Description</h2>
+<h2 id="UsingJ2G-Description.2">Description</h2>
<p>The Resource Migration Tool converts JBoss specific resources to their Geronimo equivalents. It processes the following types of resources:</p>
<ul><li>JBoss/JCA data source descriptors (*-ds.xml files) defining JDBC connection pools and data sources. Since a data source depends on a database type, the tool performs automatic migration for the following well-known databases
@@ -493,7 +526,7 @@ Output will be displayed in the bottom p
</li></ul>
-<h2><a shape="rect" name="UsingJ2G-RunningtheResourceMigrationToolEclipseGUI"></a>Running the Resource Migration Tool - Eclipse GUI</h2>
+<h2 id="UsingJ2G-RunningtheResourceMigrationTool-EclipseGUI">Running the Resource Migration Tool - Eclipse GUI</h2>
<p>To run this component within the Eclipse IDE GUI, the left panel must first be in Navigator view.</p>
@@ -502,16 +535,16 @@ Output will be displayed in the bottom p
<p>Within the J2G Migration sub menu, select "3. Resource Migration Tool (jres2g)", and follow the prompts given.<br clear="none">
Output will be displayed in the bottom portion of the Eclipse IDE, within the integrated Console window.</p>
-<h2><a shape="rect" name="UsingJ2G-RunningtheResourceMigrationToolCommandLine"></a>Running the Resource Migration Tool - Command Line</h2>
+<h2 id="UsingJ2G-RunningtheResourceMigrationTool-CommandLine">Running the Resource Migration Tool - Command Line</h2>
<p>To start the Resource Migration Tool run the following command from the j2g bin directory, again where <APPLICATION> represents the path to the application to be converted</p>
-<p>*<b>nix</b></p>
+<p>*<strong>nix</strong></p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
<pre>./jres2g.sh <APPLICATION>
</pre>
</div></div>
-<p><b>Windows</b></p>
+<p><strong>Windows</strong></p>
<div class="preformatted panel" style="border-style: solid;border-width: 1px;"><div class="preformattedContent panelContent">
<pre>jres2g.bat <APPLICATION>
</pre>
@@ -520,7 +553,7 @@ Output will be displayed in the bottom p
<p>As with the other tools, the Error and Warning messages must be manually corrected to complete the conversion process, again which is heavily application specific and is beyond the scope of this document.</p>
-<h1><a shape="rect" name="UsingJ2G-Completion"></a>Completion</h1>
+<h1 id="UsingJ2G-Completion">Completion</h1>
<p>Once all of the above tools have been properly executed and there are no more errors or warnings, the converted application may now be built for Geronimo. Again, this is something that is extremely application specific and must be completely custom tailored in each individual situation.</p>