You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by db...@apache.org on 2018/12/02 02:20:42 UTC
[15/30] tomee git commit: Rename *.mdtext files to *.md
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-embedded-maven-plugin.md
----------------------------------------------------------------------
diff --git a/docs/tomee-embedded-maven-plugin.md b/docs/tomee-embedded-maven-plugin.md
new file mode 100644
index 0000000..6d973e7
--- /dev/null
+++ b/docs/tomee-embedded-maven-plugin.md
@@ -0,0 +1,959 @@
+index-group=Unrevised
+type=page
+status=published
+title=TomEE Embedded Maven Plugin
+~~~~~~
+
+[TomEE Maven Plugin](tomee-maven-plugin.html) provides a nice way to run "as in production" a server fully configured
+keeping the configuration in the project (easiness of sharing between team members). However for modern web development
+the fact to run the "exploded war" prevents to develop web resources in place. TomEE embedded maven plugin
+solves it directly allowing to directly deploy the war project in place using "classpath as war" option.
+
+It also allows to use a flat classpath deployment which is often use with microservices.
+
+<h2><a name="tomee-embedded:run"></a>tomee-embedded:run</h2>
+
+<p><b>Full name</b>:</p>
+
+<p>org.apache.tomee.maven:tomee-embedded-maven-plugin:7.0.0-M1:run</p>
+
+<p><b>Description</b>:</p>
+
+<div>Run an Embedded TomEE.</div>
+
+<p><b>Attributes</b>:</p>
+
+<ul>
+
+<li>Requires a Maven project to be executed.</li>
+
+<li>Requires dependency resolution of artifacts in scope: <tt>runtime+system</tt>.</li>
+
+<li>Requires dependency collection of artifacts in scope: <tt>runtime</tt>.</li>
+ </ul>
+
+<div class="section">
+<h3><a name="Optional_Parameters"></a>Optional Parameters</h3>
+
+<table class="mdtable">
+
+<tr class="a">
+
+<th>Name</th>
+
+<th>Type</th>
+
+<th>Since</th>
+
+<th>Description</th>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#ajpPort">ajpPort</a></b></td>
+
+<td><tt>int</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>8009</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.ajp</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#applicationCopyFolder">applicationCopyFolder</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.build.directory}/tomee-embedded/applications</tt>.<br /><b>User property is</b>: <tt>tomee-plugin.application-copy</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#applicationScopes">applicationScopes</a></b></td>
+
+<td><tt>List</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#applications">applications</a></b></td>
+
+<td><tt>List</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#classpathAsWar">classpathAsWar</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.classpathAsWar</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#clientAuth">clientAuth</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>User property is</b>: <tt>tomee-embedded-plugin.clientAuth</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#containerProperties">containerProperties</a></b></td>
+
+<td><tt>Map</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#context">context</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>User property is</b>: <tt>tomee-embedded-plugin.context</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#dir">dir</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.build.directory}/apache-tomee-embedded</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.lib</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#docBase">docBase</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.basedir}/src/main/webapp</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.docBase</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#forceJspDevelopment">forceJspDevelopment</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>force webapp to be reloadable<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>tomee-plugin.jsp-development</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#host">host</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>localhost</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.host</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#httpPort">httpPort</a></b></td>
+
+<td><tt>int</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>8080</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.http</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#httpsPort">httpsPort</a></b></td>
+
+<td><tt>int</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>8443</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.httpsPort</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#inlinedServerXml">inlinedServerXml</a></b></td>
+
+<td><tt>PlexusConfiguration</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#inlinedTomEEXml">inlinedTomEEXml</a></b></td>
+
+<td><tt>PlexusConfiguration</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#keepServerXmlAsThis">keepServerXmlAsThis</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.keepServerXmlAsThis</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#keyAlias">keyAlias</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>User property is</b>: <tt>tomee-embedded-plugin.keyAlias</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#keystoreFile">keystoreFile</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>User property is</b>: <tt>tomee-embedded-plugin.keystoreFile</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#keystorePass">keystorePass</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>User property is</b>: <tt>tomee-embedded-plugin.keystorePass</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#keystoreType">keystoreType</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>JKS</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.keystoreType</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#mavenLog">mavenLog</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.mavenLog</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#modules">modules</a></b></td>
+
+<td><tt>List</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.build.outputDirectory}</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.modules</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#packaging">packaging</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.packaging}</tt>.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#quickSession">quickSession</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.quickSession</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#roles">roles</a></b></td>
+
+<td><tt>Map</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#serverXml">serverXml</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#skipCurrentProject">skipCurrentProject</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>tomee-plugin.skip-current-project</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#skipHttp">skipHttp</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.skipHttp</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#ssl">ssl</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.ssl</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#sslProtocol">sslProtocol</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>User property is</b>: <tt>tomee-embedded-plugin.sslProtocol</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#stopPort">stopPort</a></b></td>
+
+<td><tt>int</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>8005</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.stop</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#useProjectClasspath">useProjectClasspath</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.useProjectClasspath</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#users">users</a></b></td>
+
+<td><tt>Map</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#warFile">warFile</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.build.directory}/${project.build.finalName}</tt>.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#webResourceCached">webResourceCached</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.webResourceCached</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#withEjbRemote">withEjbRemote</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>tomee-embedded-plugin.withEjbRemote</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#workDir">workDir</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>(no description)<br /><b>Default value is</b>: <tt>${project.build.directory}/tomee-embedded-work</tt>.<br /><b>User property is</b>: <tt>tomee-plugin.work</tt>.</td>
+ </tr>
+ </table>
+ </div>
+
+<div class="section">
+<h3><a name="Parameter_Details"></a>Parameter Details</h3>
+
+<p><b><a name="ajpPort">ajpPort</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>int</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.ajp</tt></li>
+
+<li><b>Default</b>: <tt>8009</tt></li>
+ </ul><hr />
+<p><b><a name="applicationCopyFolder">applicationCopyFolder</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-plugin.application-copy</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/tomee-embedded/applications</tt></li>
+ </ul><hr />
+<p><b><a name="applicationScopes">applicationScopes</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.List</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="applications">applications</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.List</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="classpathAsWar">classpathAsWar</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.classpathAsWar</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="clientAuth">clientAuth</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.clientAuth</tt></li>
+ </ul><hr />
+<p><b><a name="containerProperties">containerProperties</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.Map</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="context">context</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.context</tt></li>
+ </ul><hr />
+<p><b><a name="dir">dir</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.lib</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/apache-tomee-embedded</tt></li>
+ </ul><hr />
+<p><b><a name="docBase">docBase</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.docBase</tt></li>
+
+<li><b>Default</b>: <tt>${project.basedir}/src/main/webapp</tt></li>
+ </ul><hr />
+<p><b><a name="forceJspDevelopment">forceJspDevelopment</a>:</b></p>
+
+<div>force webapp to be reloadable</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-plugin.jsp-development</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="host">host</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.host</tt></li>
+
+<li><b>Default</b>: <tt>localhost</tt></li>
+ </ul><hr />
+<p><b><a name="httpPort">httpPort</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>int</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.http</tt></li>
+
+<li><b>Default</b>: <tt>8080</tt></li>
+ </ul><hr />
+<p><b><a name="httpsPort">httpsPort</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>int</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.httpsPort</tt></li>
+
+<li><b>Default</b>: <tt>8443</tt></li>
+ </ul><hr />
+<p><b><a name="inlinedServerXml">inlinedServerXml</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>org.codehaus.plexus.configuration.PlexusConfiguration</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="inlinedTomEEXml">inlinedTomEEXml</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>org.codehaus.plexus.configuration.PlexusConfiguration</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="keepServerXmlAsThis">keepServerXmlAsThis</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.keepServerXmlAsThis</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="keyAlias">keyAlias</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.keyAlias</tt></li>
+ </ul><hr />
+<p><b><a name="keystoreFile">keystoreFile</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.keystoreFile</tt></li>
+ </ul><hr />
+<p><b><a name="keystorePass">keystorePass</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.keystorePass</tt></li>
+ </ul><hr />
+<p><b><a name="keystoreType">keystoreType</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.keystoreType</tt></li>
+
+<li><b>Default</b>: <tt>JKS</tt></li>
+ </ul><hr />
+<p><b><a name="mavenLog">mavenLog</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.mavenLog</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="modules">modules</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.List</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.modules</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.outputDirectory}</tt></li>
+ </ul><hr />
+<p><b><a name="packaging">packaging</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>${project.packaging}</tt></li>
+ </ul><hr />
+<p><b><a name="quickSession">quickSession</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.quickSession</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="roles">roles</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.Map</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="serverXml">serverXml</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="skipCurrentProject">skipCurrentProject</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-plugin.skip-current-project</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="skipHttp">skipHttp</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.skipHttp</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="ssl">ssl</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.ssl</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="sslProtocol">sslProtocol</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.sslProtocol</tt></li>
+ </ul><hr />
+<p><b><a name="stopPort">stopPort</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>int</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.stop</tt></li>
+
+<li><b>Default</b>: <tt>8005</tt></li>
+ </ul><hr />
+<p><b><a name="useProjectClasspath">useProjectClasspath</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.useProjectClasspath</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="users">users</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.Map</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="warFile">warFile</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/${project.build.finalName}</tt></li>
+ </ul><hr />
+<p><b><a name="webResourceCached">webResourceCached</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.webResourceCached</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="withEjbRemote">withEjbRemote</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-embedded-plugin.withEjbRemote</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="workDir">workDir</a>:</b></p>
+
+<div>(no description)</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>tomee-plugin.work</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/tomee-embedded-work</tt></li>
+ </ul>
+ </div>
+
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-jaas.md
----------------------------------------------------------------------
diff --git a/docs/tomee-jaas.md b/docs/tomee-jaas.md
new file mode 100644
index 0000000..4653cfd
--- /dev/null
+++ b/docs/tomee-jaas.md
@@ -0,0 +1,73 @@
+index-group=Unrevised
+type=page
+status=published
+title=JAAS and TomEE
+~~~~~~
+
+# Purpose
+
+You want to use JAAS in TomEE with custom (or OpenEJB) LoginModules.
+
+# Solution
+
+TomEE tries to keep as possible as it is Tomcat so simply
+configure your JAAS LoginModule as in Tomcat.
+
+Note: only the first one will be used.
+
+# Configuration
+
+Add to your `CATALINA_OPTS` the `java.security.auth.login.config` system property:
+
+ -Djava.security.auth.login.config=$CATALINA_BASE/conf/login.config
+
+Configure your realm in server.xml file
+
+ <?xml version='1.0' encoding='utf-8'?>
+ <Server port="8005" shutdown="SHUTDOWN">
+ <Listener className="org.apache.tomee.loader.OpenEJBListener" />
+ <Listener className="org.apache.catalina.security.SecurityListener" />
+
+ <Service name="Catalina">
+ <Connector port="8080" protocol="HTTP/1.1"
+ connectionTimeout="20000"
+ redirectPort="8443" />
+ <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
+ <Engine name="Catalina" defaultHost="localhost">
+ <!-- here is the magic -->
+ <Realm className="org.apache.catalina.realm.JAASRealm" appName="PropertiesLogin"
+ userClassNames="org.apache.openejb.core.security.jaas.UserPrincipal"
+ roleClassNames="org.apache.openejb.core.security.jaas.GroupPrincipal">
+ </Realm>
+
+ <Host name="localhost" appBase="webapps"
+ unpackWARs="true" autoDeploy="true" />
+ </Engine>
+ </Service>
+ </Server>
+
+Configure your `login.config` file
+
+ PropertiesLogin {
+ org.apache.openejb.core.security.jaas.PropertiesLoginModule required
+ Debug=false
+ UsersFile="users.properties"
+ GroupsFile="groups.properties";
+ };
+
+
+Configure your login module specifically (`users.properties` for snippets of this page for instance).
+
+Place `users.properties` and `groups.properties` files in `$CATALINA_BASE/conf/` folder.
+`users.properties` file contains user name and associated password entries, ex.:
+
+ me=password
+ tomee=tomee
+
+`groups.properties` file specifies groups and their users, ex.:
+
+ my-role=me
+ manager-gui=tomee,me
+ tomee-admin=tomee
+
+**NOTE**: `users.properties` and `groups.properties` file names and file location are fixed. If other names are used, the files must be placed in `%CATALINA_BASE/lib/` folder instead.
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-logging-in-eclipse.md
----------------------------------------------------------------------
diff --git a/docs/tomee-logging-in-eclipse.md b/docs/tomee-logging-in-eclipse.md
new file mode 100644
index 0000000..07fd6cb
--- /dev/null
+++ b/docs/tomee-logging-in-eclipse.md
@@ -0,0 +1,13 @@
+index-group=Unrevised
+type=page
+status=published
+title=How to use JULI for TomEE in WTP?
+~~~~~~
+
+It seems that WTP doesn't manage correctly Tomcat logging configuration (which needs to be done through
+system properties). A quick workaround is to add these properties manually:
+
+ -Djava.util.logging.config.file="<tomee>/conf/logging.properties"
+ -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
+
+More information on: http://wiki.eclipse.org/WTP_Tomcat_FAQ#How_do_I_enable_the_JULI_logging_in_a_Tomcat_5.5_Server_instance.3F
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-logging.md
----------------------------------------------------------------------
diff --git a/docs/tomee-logging.md b/docs/tomee-logging.md
new file mode 100644
index 0000000..1852c18
--- /dev/null
+++ b/docs/tomee-logging.md
@@ -0,0 +1,33 @@
+index-group=Unrevised
+type=page
+status=published
+title=
+~~~~~~
+Notice: 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 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, 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.
+
+Logging in TomEE is configured using the conf/logging.properties file. Here are some of the benefits:
+
+ You do not have to author a logging.properties from scratch.
+
+ You get one with sensible defaults.
+
+ If you did modify the default file, and you wanted to revert back to the default file generated by TomEE, all you have to do is
+
+ Delete or rename the file e.g. rename it to logging.properties.BAK .
+
+ Restart the server
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-maven-plugin.md
----------------------------------------------------------------------
diff --git a/docs/tomee-maven-plugin.md b/docs/tomee-maven-plugin.md
new file mode 100644
index 0000000..10e7ecb
--- /dev/null
+++ b/docs/tomee-maven-plugin.md
@@ -0,0 +1,148 @@
+index-group=Unrevised
+type=page
+status=published
+title=TomEE Maven Plugin
+~~~~~~
+
+Inspired by the Jetty Maven Plugin, the TomEE Maven Plugin is a feature-rich
+plugin that allows for:
+
+ - Easy provisioning of a TomEE server
+ - Server start and stop
+ - Application deployment and undeployment
+
+Simply add the following to the <plugins>, and optionally the <pluginManagement>), section of your `pom.xml`
+
+ <plugins>
+ <plugin>
+ <groupId>org.apache.openejb.maven</groupId>
+ <artifactId>tomee-maven-plugin</artifactId>
+ <version>1.7.1</version>
+ <configuration>
+ <tomeeVersion>1.7.1</tomeeVersion>
+ <tomeeClassifier>plus</tomeeClassifier>
+ </configuration>
+ </plugin>
+ </plugins>
+
+###Plugin Goals
+<table class="mdtable">
+<tr class="a">
+<th>Goal</th>
+<th>Description</th></tr>
+<tr class="b">
+<td><a href="maven/build-mojo.html">tomee:build</a></td>
+<td>Create TomEE, but do not run it.</td></tr>
+<tr class="a">
+<td><a href="maven/configtest-mojo.html">tomee:configtest</a></td>
+<td>Run the Apache Tomcat `configtest` command.</td></tr>
+<tr class="b">
+<td><a href="maven/debug-mojo.html">tomee:debug</a></td>
+<td>Same as `run` but with debug activated on the default or specified port.</td></tr>
+<tr class="a">
+<td><a href="maven/deploy-mojo.html">tomee:deploy</a></td>
+<td>Deploy an application in a running TomEE.</td></tr>
+<tr class="b">
+<td><a href="maven/exec-mojo.html">tomee:exec</a></td>
+<td>Creates an executable jar of the application.</td></tr>
+<tr class="a">
+<td><a href="maven/help-mojo.html">tomee:help</a></td>
+<td>Display help information on the tomee-maven-plugin.<br />
+Call <code>mvn tomee:help -Ddetail=true
+-Dgoal=<goal-name></code> to display parameter details.</td></tr>
+<tr class="b">
+<td><a href="maven/list-mojo.html">tomee:list</a></td>
+<td>Largely inspired by the OpenEJB command helper, but with some differences. List deployed EJB's in a running TomEE.</td></tr>
+<tr class="a">
+<td><a href="maven/run-mojo.html">tomee:run</a></td>
+<td>Start and wait for TomEE.</td></tr>
+<tr class="b">
+<td><a href="maven/start-mojo.html">tomee:start</a></td>
+<td>Start TomEE and continue.</td></tr>
+<tr class="a">
+<td><a href="maven/stop-mojo.html">tomee:stop</a></td>
+<td>Stop a TomEE started with start command.</td></tr>
+<tr class="b">
+<td><a href="maven/undeploy-mojo.html">tomee:undeploy</a></td>
+<td>Undeploy an application in a running TomEE</td></tr></table>
+
+
+Note that for the tomee:deploy and tomee:undeploy goals, the path can either be specified within the <configuration/> section of the `pom.xml` using the <path> parameter, or it can be passed via the user property tomee-plugin.archive. If a relative path is passed for the deploy path archive, this must be relative to the TomEE server.
+
+Note 2: running tomee maven plugin you can type 'quit' directly in the console to shutdown correctly the
+server. 'reload' is also available when internal openejb application is deployed.
+
+###More Tweaks
+
+The lib tag allows to enrich the container with some additional libraries.
+
+Some interesting patterns in addition to the default maven formats are supported.
+
+* remove:<some prefix of jar in lib folder>: remove all jar starting with the specified prefix
+* unzip:<some maven zip>: extract the zip in lib folder
+* ?name=<new-name>: rename the libary once copied in lib folder
+
+Note: the name tweak can be used to rename applications too
+
+###Provisioning Example
+
+This plugin is also usable in projects which are not war. For instance you can use it in a pom
+project to setup a TomEE install, add libraries, deploy apps then run the server.
+
+ <plugin>
+ <groupId>org.apache.openejb.maven</groupId>
+ <artifactId>tomee-maven-plugin</artifactId>
+ <version>1.7.1</version>
+ <configuration>
+ <tomeeVersion>1.7.1</tomeeVersion>
+ <tomeeClassifier>plus</tomeeClassifier>
+ <debug>false</debug>
+ <debugPort>5005</debugPort>
+ <args>-Dfoo=bar</args>
+ <config>${project.basedir}/src/test/tomee/conf</config>
+ <libs>
+ <lib>mysql:mysql-connector-java:5.1.20</lib>
+ </libs>
+ <webapps>
+ <webapp>org.superbiz:myapp:4.3?name=ROOT</webapp>
+ <webapp>org.superbiz:api:1.1</webapp>
+ </webapps>
+ <apps>
+ <app>org.superbiz:mybugapp:3.2:ear</app>
+ </apps>
+ <libs>
+ <lib>mysql:mysql-connector-java:5.1.21</lib>
+ <lib>unzip:org.superbiz:hibernate-bundle:4.1.0.Final:zip</lib>
+ <lib>remove:openjpa-</lib>
+ </libs>
+ </configuration>
+ </plugin>
+
+
+###Auto Reloading Example
+
+ <plugin>
+ <groupId>org.apache.openejb.maven</groupId>
+ <artifactId>tomee-maven-plugin</artifactId>
+ <version>1.7.1</version>
+ <configuration>
+ <synchronization>
+ <extensions>
+ <extension>.class</extension> <!-- if you want to update each time you build with mvn compile -->
+ </extensions>
+ </synchronization>
+ <reloadOnUpdate>true</reloadOnUpdate>
+ </configuration>
+ </plugin>
+
+The Synchronization block supports the following configuration options:
+
+* resourcesDir (default src/main/webapp)
+* binariesDir (default target/classes)
+* targetBinariesDir (default tomee/webapps/finalName/WEB-INF/classes)
+* targetResourcesDir (default tomee/webapps/finalName)
+* updateInterval (default 5 - in second)
+* extensions (default html, xhtml, js and css)
+* regex: a regex should match files to take into account when updating
+
+reloadOnUpdate means to reload the entire context (webapp). This means undeploying/redeploying the application.
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-mp-getting-started.md
----------------------------------------------------------------------
diff --git a/docs/tomee-mp-getting-started.md b/docs/tomee-mp-getting-started.md
new file mode 100644
index 0000000..a40f805
--- /dev/null
+++ b/docs/tomee-mp-getting-started.md
@@ -0,0 +1,65 @@
+index-group=Unrevised
+type=page
+status=published
+title=TomEE Maven Plugin
+~~~~~~
+
+###Add The TomEE Maven Plugin To An Existing Project
+
+If you already have a maven project set up then just add the plugin as described [here](maven/index.html)
+
+You will likely need the full Java EE API added to your pom file:
+
+ <dependency>
+ <groupId>org.apache.openejb</groupId>
+ <artifactId>javaee-api</artifactId>
+ <version>6.0-6</version>
+ <scope>provided</scope>
+ </dependency>
+
+The simplest path is to allow Maven to create an example project for you. Even if you have an existing project you can always use the template as a reference.
+
+###Generate a Basic TomEE-Project With Maven
+
+TomEE provides a maven-archetype for generating a template project. This template project is preconfigured with `javaee-api` (scope provided) and with the [`tomee-maven-plugin`](maven/index.html) for starting the application with TomEE.
+
+For example, if current version of the archetype is '1.7.1', then the required command to generate an application would be:
+
+ mvn archetype:generate -DarchetypeGroupId=org.apache.openejb.maven -DarchetypeArtifactId=tomee-webapp-archetype -DarchetypeVersion=1.7.1
+
+The first time you run this command maven downloads the archetype and some parts related to it. Afterwards you see a prompt which allows you to specify the groupId, artifactId, version and package of your application.
+If you are using 'tomee' as groupId, 'tomee-demo' as artifactId, '1.0' as version and 'myapp' as package, your console should show something like:
+
+ Define value for property 'groupId': : tomee
+ Define value for property 'artifactId': : tomee-demo
+ Define value for property 'version': 1.0-SNAPSHOT: : 1.0
+ Define value for property 'package': tomee: : myapp
+ Confirm properties configuration:
+ groupId: tomee
+ artifactId: tomee-demo
+ version: 1.0
+ package: myapp
+ ...
+ [INFO] BUILD SUCCESS
+ ...
+
+Afterwards you see a new folder with the name you used for the artifactId (in the previous example 'tomee-demo').
+For starting the application you have to change the current directory to the directory of the generated application:
+
+ cd tomee-demo
+
+###Starting a TomEE-Project with Maven
+
+With using the archetype everything you need is in place already. So you just have to start TomEE with:
+
+ mvn package tomee:run
+
+The first time you run this command takes a bit longer, because maven has to download e.g. TomEE.
+Once those parts are downloaded, starting maven, deploying and starting the generated application takes less than 10s (depending on your computer).
+
+###Accessing a running application
+
+The application gets deployed to `target/apache-tomee/webapps`. If everything worked correctly, you should see a directory ('ROOT') as well as a web-archive ('ROOT.war').
+The context-paths of the deployed application is ROOT. In our example the generated application contains a servlet mapped to '/index'. So you can access it via:
+
+ http://localhost:8080/index
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-version-policies.md
----------------------------------------------------------------------
diff --git a/docs/tomee-version-policies.md b/docs/tomee-version-policies.md
new file mode 100644
index 0000000..ae5c666
--- /dev/null
+++ b/docs/tomee-version-policies.md
@@ -0,0 +1,28 @@
+index-group=Unrevised
+type=page
+status=published
+~~~~~~
+.
+# TomEE versioning policies
+
+TomEE version policy is made of three dot-separated numbers: x.y.z
+
+ - x is the major version. It corresponds to the maximum Java EE specification supported by TomEE and a codebase generation, starting with value 1 for Java EE 6 support. Next major will be 7 targetting JavaEE 7 etc...
+
+ - y is the minor version. It corresponds to a features level, starting at 0. Initial TomEE release was 1.0.0, followed by 1.5.0 because of the accumulation of features changes delivered since 1.0.0. Note that features changes must comply with the Java EE specification level given by TomEE's major version.
+
+ - z is the fix level. It corresponds to bug fixes changes without new features, starting at 0. Upgrades of embedded components (Tomcat, OpenEJB, MyFaces, etc.) are normally part of bug fixes releases.
+
+These policies allow an Java EE application to be certified with a given TomEEE version x.y.z and to be compatible with TomEE versions x.y1.* with y1>y and compatible with TomEE version x.y.z1 with z1>z.
+
+Important: being JavaEE certified means the server passed the Test Compatibility Kit (TCK). To simplify/summarize it is a big test suite to validate your are compliant with a JavaEE version. TomEE 1.x passed the JavaEE 6 TCK which was donated to Apache Software Foundation by Oracle. This donation hasn't been done to Apache for JavaEE 7 so TomEE is not able for now to be validated against it and therefore TomEE versions targetting JavaEE 7 are not yet certified.
+
+To make it more explicit here is a small table showing the targetted JavaEE version and the related certification state by version:
+
+<table class="mdtable">
+<tr><td>TomEE Version</td><td>JavaEE Version</td><td>Certified</td></tr>
+<tr><td>1.x</td><td>6</td><td>Yes</td></tr>
+<tr><td>7.x</td><td>7</td><td>No</td></tr>
+</table>
+
+
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-webaccess.md
----------------------------------------------------------------------
diff --git a/docs/tomee-webaccess.md b/docs/tomee-webaccess.md
new file mode 100644
index 0000000..1859287
--- /dev/null
+++ b/docs/tomee-webaccess.md
@@ -0,0 +1,21 @@
+index-group=Unrevised
+type=page
+status=published
+title=
+~~~~~~
+Notice: 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 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, 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.
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/tomee-webapp.md
----------------------------------------------------------------------
diff --git a/docs/tomee-webapp.md b/docs/tomee-webapp.md
new file mode 100644
index 0000000..2eb0f55
--- /dev/null
+++ b/docs/tomee-webapp.md
@@ -0,0 +1,62 @@
+index-group=Unrevised
+type=page
+status=published
+title=About the 'tomee' webapp
+~~~~~~
+Notice: 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 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, 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.
+
+There are two forms of the `tomee` webapp to consider:
+
+ - from an **tomee-1.x.x.war** that has been downloaded and added to a Tomcat 7 install. This `tomee` webapp will contain all the necessary libraries to add the missing Java EE functionality to Tomcat as well as a small console.
+ - from an **apache-tomee-1.x.x.zip**. The `tomee` webapp shipped inside a TomEE zip or tar is the same webapp as above, but with the libraries moved into the `<tomcat-home>/lib/` directory
+
+The only real difference between a "Tomcat with drop-in tomee.war" and a "TomEE" install is where the additional libraries live.
+
+## Deleting from plain Tomcat
+
+Deleting the `tomee` webapp from a plain Tomcat install will effectively uninstall TomEE from Tomcat.
+
+## Deleting from TomEE
+
+Deleting the `tomee` webapp from a TomEE install is safe as the needed libraries have been moved into `<tomcat-home>/lib/`
+
+The only loss of functionality would be the ability to remotely execute EJBs over HTTP. However this can easily be added to a different webapp like so:
+
+ <servlet>
+ <servlet-name>ServerServlet</servlet-name>
+ <servlet-class>org.apache.openejb.server.httpd.ServerServlet</servlet-class>
+ </servlet>
+
+ <servlet-mapping>
+ <servlet-name>ServerServlet</servlet-name>
+ <url-pattern>/myejbs/*</url-pattern>
+ </servlet-mapping>
+
+
+Then you can create an `InitialContext` that points to that webapp like so:
+
+ Properties p = new Properties();
+ p.put("java.naming.factory.initial", "org.apache.openejb.client.RemoteInitialContextFactory");
+ p.put("java.naming.provider.url", "http://127.0.0.1:8080/mywebapp/myejbs");
+ // user and pass optional
+ p.put("java.naming.security.principal", "myuser");
+ p.put("java.naming.security.credentials", "mypass");
+
+ InitialContext ctx = new InitialContext(p);
+
+ MyBean myBean = (MyBean) ctx.lookup("MyBeanRemote");
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/topic-config.md
----------------------------------------------------------------------
diff --git a/docs/topic-config.md b/docs/topic-config.md
new file mode 100644
index 0000000..92b24da
--- /dev/null
+++ b/docs/topic-config.md
@@ -0,0 +1,36 @@
+index-group=Unrevised
+type=page
+status=published
+title=Topic Configuration
+~~~~~~
+
+
+A Topic can be declared via xml in the `<tomee-home>/conf/tomee.xml` file or in a `WEB-INF/resources.xml` file using a declaration like the following. All properties in the element body are optional.
+
+ <Resource id="myTopic" type="javax.jms.Topic">
+ destination =
+ </Resource>
+
+Alternatively, a Topic can be declared via properties in the `<tomee-home>/conf/system.properties` file or via Java VirtualMachine `-D` properties. The properties can also be used when embedding TomEE via the `javax.ejb.embeddable.EJBContainer` API or `InitialContext`
+
+ myTopic = new://Resource?type=javax.jms.Topic
+ myTopic.destination =
+
+Properties and xml can be mixed. Properties will override the xml allowing for easy configuration change without the need for ${} style variable substitution. Properties are not case sensitive. If a property is specified that is not supported by the declared Topic a warning will be logged. If a Topic is needed by the application and one is not declared, TomEE will create one dynamically using default settings. Multiple Topic declarations are allowed.
+# Supported Properties
+<table class="mdtable">
+<tr>
+<th>Property</th>
+<th>Type</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+<tr>
+ <td>destination</td>
+ <td>String</td>
+ <td></td>
+ <td>
+Specifies the name of the topic
+</td>
+</tr>
+</table>
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/transaction-annotations.md
----------------------------------------------------------------------
diff --git a/docs/transaction-annotations.md b/docs/transaction-annotations.md
new file mode 100644
index 0000000..403ae91
--- /dev/null
+++ b/docs/transaction-annotations.md
@@ -0,0 +1,219 @@
+index-group=Unrevised
+type=page
+status=published
+title=Transaction Annotations
+~~~~~~
+
+_Also see [Testing Transactions](testing-transactions-example.html)
+ for an example of how to use and test EJB transaction attributes_
+
+The *javax.ejb.TransactionAttribute* annotation (@TransactionAttribute) can
+be applied to a bean class or it's methods.
+
+Usage of the @TransactionAttribute requires you to specify one of six
+different transaction attribute types defined via the
+javax.ejb.TransactionAttributeType enum.
+
+ - TransactionAttributeType.*MANDATORY*
+ - TransactionAttributeType.*REQUIRED*
+ - TransactionAttributeType.*REQUIRES_NEW*
+ - TransactionAttributeType.*SUPPORTS*
+ - TransactionAttributeType.*NOT_SUPPORTED*
+ - TransactionAttributeType.*NEVER*
+
+Per EJB 3.0 the default transaction attribute for all EJB 3.0 applications
+is *REQUIRED*. The default transaction attribute for EJB 2.1, 2.0 and 1.1
+applications is vendor specific. In OpenEJB EJB 2.1, 2.0 and 1.1
+applications also use *REQUIRED* as the default.
+
+<a name="TransactionAnnotations-AttributeTypessummary"></a>
+## Attribute Types summary
+
+A simplistic way to visualize the transaction attributes is as follows.
+
+<table class="mdtable">
+<tr><td> </th><th> Failing </th><th> Correcting </th><th> No Change </th></tr>
+<tr><th> Transacted </td><td> MANDATORY </td><td> REQUIRED, REQUIRES_NEW </td><td> SUPPORTS </td></tr>
+<tr><th> Not Transacted </td><td> NEVER </td><td> NOT_SUPPORTED </td><td> SUPPORTS </td></tr>
+</table>
+
+The "*Transacted*" and "*Not Transacted*" categories represent the
+container guarantee, i.e. if the bean method will or will not be invoked in
+a transaction. The "*Failing*", "*Correcting*", and "*No Change*"
+categories represent the action take by the container to achieve that
+guarantee.
+
+For example, *Never* and *Mandatory* are categorized as "*Failing*" and
+will cause the container to throw an exception to the caller if there is
+(Tx Never) or is not (Tx Mandatory) a transaction in progress when the
+method is called. The attributes *Required*, *RequiresNew*, and
+*NotSupported* are categorized as "*Correcting*" as they will cause the
+container to adjust the transactional state automatically as needed to
+match the desired state, rather than blocking the invocation by throwing an
+exception.
+
+<a name="TransactionAnnotations-DetaileddescriptionofeachAttribute"></a>
+### Detailed description of each Attribute
+
+<a name="TransactionAnnotations-MANDATORY"></a>
+#### MANDATORY
+
+A _MANDATORY_ method is guaranteed to always be executed in a transaction.
+However, it's the caller's job to take care of suppling the transaction.
+If the caller attempts to invoke the method *outside* of a transaction,
+then the container will block the call and throw them an *exception*.
+
+<a name="TransactionAnnotations-REQUIRED"></a>
+#### REQUIRED
+
+A _REQUIRED_ method is guaranteed to always be executed in a transaction.
+If the caller attempts to invoke the method *outside* of a transaction, the
+container will *start* a transaction, execute the method, then *commit* the
+transaction.
+
+<a name="TransactionAnnotations-REQUIRES_NEW"></a>
+#### REQUIRES_NEW
+
+A _REQUIRES_NEW_ method is guaranteed to always be executed in a
+transaction. If the caller attempts to invoke the method *inside or
+outside* of a transaction, the container will still *start* a transaction,
+execute the method, then *commit* the transaction. Any transaction the
+caller may have in progress will be *suspended* before the method execution
+then *resumed* afterward.
+
+<a name="TransactionAnnotations-NEVER"></a>
+#### NEVER
+
+A _NEVER_ method is guaranteed to never be executed in a transaction.
+However, it's the caller's job to ensure there is no transaction. If the
+caller attempts to invoke the method *inside* of a transaction, then the
+container will block the call and throw them an *exception*.
+
+<a name="TransactionAnnotations-NOT_SUPPORTED"></a>
+#### NOT_SUPPORTED
+
+A _NOT_SUPPORTED_ method is guaranteed to never be executed in a
+transaction. If the caller attempts to invoke the method *inside* of a
+transaction, the container will *suspend* the caller's transaction, execute
+the method, then *resume* the caller's transaction.
+
+<a name="TransactionAnnotations-SUPPORTS"></a>
+#### SUPPORTS
+
+A _SUPPORTS_ method is guaranteed to adopt the exact transactional state of
+the caller. These methods can be invoked by caller's *inside or outside*
+of a transaction. The container will do nothing to change that state.
+
+
+<a name="TransactionAnnotations-OnMethods"></a>
+## On Methods
+
+
+ @Stateless
+ public static class MyBean implements MyBusinessInterface {
+
+ @TransactionAttribute(TransactionAttributeType.MANDATORY)
+ public String codeRed(String s) {
+ return s;
+ }
+
+ public String codeBlue(String s) {
+ return s;
+ }
+ }
+
+
+- _codeRed_ will be invoked with the attribute of _MANDATORY_
+- _codeBlue_ will be invoked with the default attribute of _REQUIRED_
+
+<a name="TransactionAnnotations-OnClasses"></a>
+## On Classes
+
+
+ @Stateless
+ @TransactionAttribute(TransactionAttributeType.MANDATORY)
+ public static class MyBean implements MyBusinessInterface {
+
+ public String codeRed(String s) {
+ return s;
+ }
+
+ public String codeBlue(String s) {
+ return s;
+ }
+ }
+
+
+- _codeRed_ and _codeBlue_ will be invoked with the attribute of
+_MANDATORY_
+
+<a name="TransactionAnnotations-Mixedonclassesandmethods"></a>
+## Mixed on classes and methods
+
+
+ @Stateless
+ @TransactionAttribute(TransactionAttributeType.SUPPORTS)
+ public static class MyBean implements MyBusinessInterface {
+
+ @TransactionAttribute(TransactionAttributeType.NEVER)
+ public String codeRed(String s) {
+ return s;
+ }
+
+ public String codeBlue(String s) {
+ return s;
+ }
+
+ @TransactionAttribute(TransactionAttributeType.REQUIRED)
+ public String codeGreen(String s) {
+ return s;
+ }
+ }
+
+
+- _codeRed_ will be invoked with the attribute of _NEVER_
+- _codeBlue_ will be invoked with the attribute of _SUPPORTS_
+- _codeGreen_ will be invoked with the attribute of _REQUIRED_
+
+<a name="TransactionAnnotations-IllegalUsage"></a>
+# Illegal Usage
+
+Generally, transaction annotationss cannot be made on AroundInvoke methods
+and most callbacks.
+
+The following usages of @TransactionAttribute have no effect.
+
+
+ @Stateful
+ public class MyStatefulBean implements MyBusinessInterface {
+
+ @PostConstruct
+ @TransactionAttribute(TransactionAttributeType.NEVER)
+ public void constructed(){
+
+ }
+
+ @PreDestroy
+ @TransactionAttribute(TransactionAttributeType.NEVER)
+ public void destroy(){
+
+ }
+
+ @AroundInvoke
+ @TransactionAttribute(TransactionAttributeType.NEVER)
+ public Object invoke(InvocationContext invocationContext) throws Exception {
+ return invocationContext.proceed();
+ }
+
+ @PostActivate
+ @TransactionAttribute(TransactionAttributeType.NEVER)
+ public void activated(){
+
+ }
+
+ @PrePassivate
+ @TransactionAttribute(TransactionAttributeType.NEVER)
+ public void passivate(){
+
+ }
+ }
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/transactionmanager-config.md
----------------------------------------------------------------------
diff --git a/docs/transactionmanager-config.md b/docs/transactionmanager-config.md
new file mode 100644
index 0000000..6faf550
--- /dev/null
+++ b/docs/transactionmanager-config.md
@@ -0,0 +1,166 @@
+index-group=Unrevised
+type=page
+status=published
+title=TransactionManager Configuration
+~~~~~~
+
+
+A TransactionManager can be declared via xml in the `<tomee-home>/conf/tomee.xml` file or in a `WEB-INF/resources.xml` file using a declaration like the following. All properties in the element body are optional.
+
+ <TransactionManager id="myTransactionManager" type="TransactionManager">
+ adler32Checksum = true
+ bufferSizeKb = 32
+ checksumEnabled = true
+ defaultTransactionTimeout = 10 minutes
+ flushSleepTime = 50 Milliseconds
+ logFileDir = txlog
+ logFileExt = log
+ logFileName = howl
+ maxBlocksPerFile = -1
+ maxBuffers = 0
+ maxLogFiles = 2
+ minBuffers = 4
+ threadsWaitingForceThreshold = -1
+ txRecovery = false
+ </TransactionManager>
+
+Alternatively, a TransactionManager can be declared via properties in the `<tomee-home>/conf/system.properties` file or via Java VirtualMachine `-D` properties. The properties can also be used when embedding TomEE via the `javax.ejb.embeddable.EJBContainer` API or `InitialContext`
+
+ myTransactionManager = new://TransactionManager?type=TransactionManager
+ myTransactionManager.adler32Checksum = true
+ myTransactionManager.bufferSizeKb = 32
+ myTransactionManager.checksumEnabled = true
+ myTransactionManager.defaultTransactionTimeout = 10 minutes
+ myTransactionManager.flushSleepTime = 50 Milliseconds
+ myTransactionManager.logFileDir = txlog
+ myTransactionManager.logFileExt = log
+ myTransactionManager.logFileName = howl
+ myTransactionManager.maxBlocksPerFile = -1
+ myTransactionManager.maxBuffers = 0
+ myTransactionManager.maxLogFiles = 2
+ myTransactionManager.minBuffers = 4
+ myTransactionManager.threadsWaitingForceThreshold = -1
+ myTransactionManager.txRecovery = false
+
+Properties and xml can be mixed. Properties will override the xml allowing for easy configuration change without the need for ${} style variable substitution. Properties are not case sensitive. If a property is specified that is not supported by the declared TransactionManager a warning will be logged. If a TransactionManager is needed by the application and one is not declared, TomEE will create one dynamically using default settings. Multiple TransactionManager declarations are allowed.
+# Supported Properties
+<table class="mdtable">
+<tr>
+<th>Property</th>
+<th>Type</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+<tr>
+ <td>adler32Checksum</td>
+ <td>boolean</td>
+ <td>true</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>bufferSizeKb</td>
+ <td>int</td>
+ <td>32</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>checksumEnabled</td>
+ <td>boolean</td>
+ <td>true</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>defaultTransactionTimeout</td>
+ <td><a href="configuring-durations.html">time</a></td>
+ <td>10 minutes</td>
+ <td>
+
+</td>
+</tr>
+<tr>
+ <td>flushSleepTime</td>
+ <td><a href="configuring-durations.html">time</a></td>
+ <td>50 Milliseconds</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>logFileDir</td>
+ <td>String</td>
+ <td>txlog</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>logFileExt</td>
+ <td>String</td>
+ <td>log</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>logFileName</td>
+ <td>String</td>
+ <td>howl</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>maxBlocksPerFile</td>
+ <td>int</td>
+ <td>-1</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>maxBuffers</td>
+ <td>int</td>
+ <td>0</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>maxLogFiles</td>
+ <td>int</td>
+ <td>2</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>minBuffers</td>
+ <td>int</td>
+ <td>4</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>threadsWaitingForceThreshold</td>
+ <td>int</td>
+ <td>-1</td>
+ <td>
+Requires TxRecovery
+</td>
+</tr>
+<tr>
+ <td>txRecovery</td>
+ <td>boolean</td>
+ <td>false</td>
+ <td>
+When set to true, Howl logging is enabled
+</td>
+</tr>
+</table>
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/understanding-callbacks.md
----------------------------------------------------------------------
diff --git a/docs/understanding-callbacks.md b/docs/understanding-callbacks.md
new file mode 100644
index 0000000..49eb893
--- /dev/null
+++ b/docs/understanding-callbacks.md
@@ -0,0 +1,92 @@
+index-group=Unrevised
+type=page
+status=published
+title=Understanding Callbacks
+~~~~~~
+The rules here are pretty hard to follow without examples.
+
+When they say one AroundInvoke per class they mean that in the most literal
+sense as in one individual java class definition, not including it's parent
+class or classes, may exactly one AroundInvoke method. The bean or
+interceptor class may have an AroundInvoke method, its parent class may
+have an AroundInvoke method, the parent's parent class may have an
+AroundInvoke method and so on.
+
+So the following is legal.
+
+
+ public class Plant {
+ @AroundInvoke
+ public Object a(InvocationContext ctx) throws Exception {
+ return ctx.proceed();
+ }
+ }
+
+ public class Fruit extends Plant {
+ @AroundInvoke
+ public Object b(InvocationContext ctx) throws Exception {
+ return ctx.proceed();
+ }
+ }
+
+ @Stateless
+ public class Apple extends Fruit implements AppleLocal {
+ @AroundInvoke
+ public Object c(InvocationContext ctx) throws Exception {
+ return ctx.proceed();
+ }
+
+ public String grow(){
+ return "ready to pick";
+ }
+ }
+
+ public interface AppleLocal {
+ public String grow();
+ }
+
+
+The result is that when the "grow" method on AppleLocal (and consequently
+on Apple) is invoked, the container will first invoke the following
+AroundInvoke methods in this order; a, b, c.
+
+What the ejb spec doesn't do such a good job at stating is that there are
+ways to effectively shut off the callbacks, including AroundInvoke, of a
+parent class by simply overriding the method. We can shut off the "a"
+around invoke with a slightly different version of Apple as follows:
+
+
+ @Stateless
+ public class Apple extends Fruit implements AppleLocal {
+
+ // This will now never be called.
+ public Object a(InvocationContext ctx) throws Exception {
+ return null;
+ }
+
+ @AroundInvoke
+ public Object c(InvocationContext ctx) throws Exception {
+ return ctx.proceed();
+ }
+
+ public String grow(){
+ return "ready to pick";
+ }
+ }
+
+
+The result of this is that when the "grow" method on AppleLocal is invoked,
+the container will first invoke the AroundInvoke methods "b" then "c"
+skipping "a" completely.
+
+When they say that an AroundInvoke method cannot be a business method, they
+mean that they cannot be exposed to clients through a local or remote
+interface. The following would be illegal.
+
+
+ public interface AppleLocal {
+ public String grow();
+
+ // This is an AroundInvoke method in the bean class, not a legal business method!
+ public Object c(InvocationContext ctx) throws Exception;
+ }
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/understanding-the-directory-layout.md
----------------------------------------------------------------------
diff --git a/docs/understanding-the-directory-layout.md b/docs/understanding-the-directory-layout.md
new file mode 100644
index 0000000..cae69ef
--- /dev/null
+++ b/docs/understanding-the-directory-layout.md
@@ -0,0 +1,72 @@
+index-group=Unrevised
+type=page
+status=published
+title=Understanding the Directory Layout
+~~~~~~
+
+Unpacking the standalone OpenEJB will result in the following directory layout:
+
+ apache-openejb-[version]\apps
+ apache-openejb-[version]\bin
+ apache-openejb-[version]\conf
+ apache-openejb-[version]\data
+ apache-openejb-[version]\lib
+ apache-openejb-[version]\logs
+ apache-openejb-[version]\LICENSE
+ apache-openejb-[version]\NOTICE
+ apache-openejb-[version]\README.txt
+
+<a name="UnderstandingtheDirectoryLayout-Directories"></a>
+# Directories
+
+<a name="UnderstandingtheDirectoryLayout-bin/"></a>
+## bin/
+
+Contains commands to start/stop the server (You can also do a lot of other
+stuff like deploy/undeploy, but we will just talk about things needed to
+get you started)
+
+<a name="UnderstandingtheDirectoryLayout-lib/"></a>
+## lib/
+
+Contains several jar files (you only need of few of these jars in your
+classpath to do EJB development)
+
+<a name="UnderstandingtheDirectoryLayout-apps/"></a>
+## apps/
+
+Once you create your EJB's and jar them up, you can place your jar file in
+this directory and start the server. The server will automatically deploy
+all the EJB's contained in this JAR.
+
+<a name="UnderstandingtheDirectoryLayout-logs/"></a>
+## logs/
+
+Contains log files.
+
+<a name="UnderstandingtheDirectoryLayout-conf/"></a>
+## conf/
+
+This directory contains nothing but a README.txt file at the time OpenEJB
+is unpacked. The first time OpenEJB is started however, these files will
+be created:
+
+ conf/
+ openejb.xml (main config file)
+ logging.properties (log levels and files)
+ login.config (jaas config file)
+ users.properties (users that can log in)
+ groups.properties (groups in which users belong)
+
+ conf.d/
+
+ admin.properties (network socket for administration)
+ ejbd.properties (network socket for ejb invocations)
+ hsql.properties (network socket for hsql client access)
+ httpejbd.properties (network socket for ejb invocations over http)
+ telnet.properties (network socket for telnet "server")
+
+These files can be edited as desired. If at any time you are unhappy with
+your changes or simply wish to start over, you can delete or move any of
+the files above and a new one containing the default values will be
+automatically created.
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/unix-daemon.md
----------------------------------------------------------------------
diff --git a/docs/unix-daemon.md b/docs/unix-daemon.md
new file mode 100644
index 0000000..12ebd38
--- /dev/null
+++ b/docs/unix-daemon.md
@@ -0,0 +1,108 @@
+index-group=Unrevised
+type=page
+status=published
+title=Unix Daemon
+~~~~~~
+
+Apache TomEE can be run as a daemon using the [jsvc](http://commons.apache.org/daemon/jsvc.html) tool from the [Apache Commons Daemon](http://commons.apache.org/daemon) project.
+
+Source tarballs for `jsvc` are included with Tomcat and therefore can be found in TomEE as well. These need to be compiled before jsvc can be used.
+
+# Building jsvc
+
+First, we'll need to locate and unpack the `commons-daemon-native.tar.gz`
+
+ cd $TOMEE_HOME/bin
+ tar xzvf commons-daemon-native.tar.gz
+ cd commons-daemon-1.0.7-native-src/unix/
+
+Note that the `commons-daemon-1.0.7-native-src` directory may have a slightly different version number.
+
+Second, we'll need to build the `jsvc` binary. Under a UNIX operating system you will need:
+
+ - An ANSI-C compliant compiler (GCC is good)
+ - GNU Make
+ - A Java Platform 2 compliant SDK
+
+You have to specify the `JAVA_HOME` of the SDK either with the `--with-java=<dir>` parameter or set the `JAVA_HOME` environment to
+point to your SDK installation. For example:
+
+ ./configure --with-java=/usr/java
+
+or
+
+ export JAVA_HOME
+ ./configure
+
+If your operating system is supported, configure will go through cleanly, otherwise it will report an error (please send us the details of your
+OS/JDK, or a patch against the sources). To build the binaries and libraries simply do:
+
+ make
+
+This will generate the executable file `jsvc`.
+
+Finally, we'll want to set the execution bits and move the `jsvc` binary
+
+ chmod 755 jsvc
+ mv jsvc $TOMEE_HOME/bin
+
+Done!
+
+As one script, the above might look like:
+
+ cd $TOMEE_HOME/bin
+ tar xzvf commons-daemon-native.tar.gz
+ cd commons-daemon-1.0.7-native-src/unix/
+ ./configure
+ make
+ chmod 755 jsvc
+ mv jsvc ../..
+
+# Starting (unix)
+
+ sudo "$TOMEE_HOME/bin/jsvc" -cp "$TOMEE_HOME/bin/bootstrap.jar:$TOMEE_HOME/bin/tomcat-juli.jar" \
+ "-javaagent:$TOMEE_HOME/lib/openejb-javaagent.jar" -outfile "$TOMEE_HOME/logs/catalina.out" \
+ -errfile "$TOMEE_HOME/logs/catalina.err" org.apache.catalina.startup.Bootstrap
+
+# Starting (osx)
+
+For a 64-bit JVM such as OSX Lion
+
+ sudo arch -arch x86_64 "$TOMEE_HOME/bin/jsvc" -jvm server -cp "$TOMEE_HOME/bin/bootstrap.jar:$TOMEE_HOME/bin/tomcat-juli.jar" \
+ "-javaagent:$TOMEE_HOME/lib/openejb-javaagent.jar" -outfile "$TOMEE_HOME/logs/catalina.out" \
+ -errfile "$TOMEE_HOME/logs/catalina.err" org.apache.catalina.startup.Bootstrap
+
+For a 32-bit JVM
+
+ sudo arch -arch i386 "$TOMEE_HOME/bin/jsvc" -jvm server -cp "$TOMEE_HOME/bin/bootstrap.jar:$TOMEE_HOME/bin/tomcat-juli.jar" \
+ "-javaagent:$TOMEE_HOME/lib/openejb-javaagent.jar" -outfile "$TOMEE_HOME/logs/catalina.out" \
+ -errfile "$TOMEE_HOME/logs/catalina.err" org.apache.catalina.startup.Bootstrap
+
+## Note on formatting
+
+Note that `\` at the end of each line is unix syntax to keep everything effectively as one line and one command. The command is simply too long to show as one line on a fixed width html page. The `\` can be removed as long as the resulting command is one long line.
+
+# Common Issues
+
+Ensure your `$TOME_HOME` and `$JAVA_HOME` variables are set correctly. You should see similar output with the following two commands
+
+ mingus:~ 01:51:37
+ $ ls $TOMEE_HOME
+ LICENSE RELEASE-NOTES bin endorsed logs webapps
+ NOTICE RUNNING.txt conf lib temp work
+
+ mingus:~ 01:51:46
+ $ ls $JAVA_HOME
+ bin bundle lib man
+
+The `jsvc -debug` option can also show useful information for troubleshooting:
+
+ $TOMEE_HOME/bin/jsvc -debug
+
+Note on OSX, `$JAVA_HOME` should be set to `/System/Library/Frameworks/JavaVM.framework/Home`
+
+# Further documentation
+
+See also the full Apache Commons Daemon documentation for jsvc.
+
+ - [http://commons.apache.org/daemon/jsvc.html](http://commons.apache.org/daemon/jsvc.html)
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/validation-tool.md
----------------------------------------------------------------------
diff --git a/docs/validation-tool.md b/docs/validation-tool.md
new file mode 100644
index 0000000..c9c6510
--- /dev/null
+++ b/docs/validation-tool.md
@@ -0,0 +1,141 @@
+index-group=Unrevised
+type=page
+status=published
+title=Validation Tool
+~~~~~~
+
+<a name="ValidationTool-NAME"></a>
+# NAME
+
+openejb validate - OpenEJB Validation Tool
+
+<a name="ValidationTool-SYNOPSIS"></a>
+# SYNOPSIS
+
+
+openejb validate [options](options.html)
+ jarfiles
+
+<a name="ValidationTool-NOTE"></a>
+# NOTE
+
+
+The OpenEJB Validation tool must be executed from the OPENEJB_HOME
+directory. This is the directory where OpenEJB was installed or unpacked.
+For for the remainder of this document we will assume you unpacked OpenEJB
+into the directory C:\openejb.
+
+In Windows, the validation tool can be executed as follows:
+
+*C:\openejb> openejb validate -help*
+
+
+{warning}
+There is a bug in the openejb.bat script of OpenEJB 0.9.0 that doesn't
+allow you to execute the validate command as above. For that release,
+Windows users can execute the following command:
+*C:\openejb> bin\validate.bat -help*
+
+{warning}
+
+
+In UNIX, Linux, or Mac OS X, the deploy tool can be executed as follows:
+
+`[user@host openejb](user@host-openejb.html)
+# ./openejb.sh validate -help`
+
+
+Depending on your OpenEJB version, you may need to change execution bits to
+make the scripts executable. You can do this with the following command.
+
+`[user@host openejb](user@host-openejb.html)
+# chmod 755 openejb.sh bin/*.sh`
+
+
+From here on out, it will be assumed that you know how to execute the right
+openejb script for your operating system and commands will appear in
+shorthand as show below.
+
+*openejb validate -help*
+
+
+<a name="ValidationTool-DESCRIPTION"></a>
+# DESCRIPTION
+
+
+The validation tool currently checks for the following things:
+* Does the Jar have all the ejb-class class files
+* Does the Jar have all the home class files
+* Does the Jar have all the remote class files
+* Is the ejb-class a sub-interface of SessionBean or EntityBean
+* Is the home a sub-interface of EJBHome
+* Is the remote a sub-interface of EJBObject
+* Are all the methods in the remote interface implemented in the ejb-class
+* Are there create methods in the home interface
+* Are the create methods in the home interface implemented in the ejb-class
+* Are the required post create methods in the ejb-class of EntityBeans
+* Are there any create methods in the ejb-class, but not in the home
+interface
+
+More checks will be added in the future.
+
+<a name="ValidationTool-OPTIONS"></a>
+# OPTIONS
+
+
+<table class="mdtable">
+<tr><td>-v</td><td>Sets the output level to 1. This will output just the minumum details
+on each failure.</td></tr>
+<tr><td>-vv</td><td>Default. Sets the output level to 2. Outputs one line summaries of
+each failure. This is the default output level.</td></tr>
+<tr><td>-vvv</td><td>Sets the output level to 3. Outputs verbose details on each failure,
+usually with details on how to correct the failures.</td></tr>
+<tr><td>-xml</td><td>Outputs information in well-formed XML.</td></tr>
+<tr><td>-nowarn</td><td>Suppresses warnings.</td></tr>
+<tr><td>-version</td><td>Print the version.</td></tr>
+<tr><td>-help</td><td>Print this help message.</td></tr>
+<tr><td>-examples</td><td>Show examples of how to use the options.</td></tr>
+</table>
+
+<a name="ValidationTool-COMMONISSUES"></a>
+# COMMON ISSUES
+
+<a name="ValidationTool-MisslocatedclassorNoClassDefFoundError"></a>
+## Misslocated class or NoClassDefFoundError
+
+The short explanation is that the parent doesn't have all the classes it
+needs as some of them are only in the child classloader, where the parent
+can't see them.
+
+This would occur, for example, if a class was loaded by the parent
+classloader, but that class' superclass wasn't visible to the parent
+classloader, perhaps because it is only in the child classloader.
+
+Here is a more concrete example:
+
+ public interface Person extends EJBObject {
+ }
+
+ public interface Employee extends Person {
+ }
+
+
+Ok, so when we build our ejb jar, we put both the Person and Employee
+interfaces in the jar, so everything should be good (so we think). But now
+let's say that for some reason the Employee interface is also in another
+jar and that jar was loaded into the system classpath.
+
+When a new classloader is create for my ejb-jar at runtime and the system
+attempts to load the Employee interface, the call goes right through that
+classloader and down to the system classloader. The Employee interface is
+found, because it was accidentally added to that extra jar in the system
+classpath. So now the system classloader goes looking for Employee's
+superinterface, Person, where it immediatly blows up and throws a
+NoClassDefFoundError: Person.
+
+Most people will look at their ejb-jar and think, "But all my classes are
+there!?", which is true. It really doesn't matter though, because one of
+those classes is also in the parent classloader. The first call to load
+that class will bypass your classloader completely and go to the parent.
+Once there, it is the parent's job to find *all* the dependent classes. If
+it can't ... NoClassDefFoundError.
http://git-wip-us.apache.org/repos/asf/tomee/blob/b93bd755/docs/version-checker.md
----------------------------------------------------------------------
diff --git a/docs/version-checker.md b/docs/version-checker.md
new file mode 100644
index 0000000..fcc4000
--- /dev/null
+++ b/docs/version-checker.md
@@ -0,0 +1,12 @@
+index-group=Unrevised
+type=page
+status=published
+title=Checking Your OpenEJB Version
+~~~~~~
+
+# Update checker
+
+To check your OpenEJB version each time OpenEJB/TomEE starts simple add the system property
+openejb.version.check=true.
+
+Note: it can be done through system.properties files.