You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tomee.apache.org by bu...@apache.org on 2011/12/15 18:12:35 UTC
svn commit: r800289 -
/websites/staging/openejb/trunk/content/dev/source-code.html
Author: buildbot
Date: Thu Dec 15 17:12:35 2011
New Revision: 800289
Log:
Staging update by buildbot
Modified:
websites/staging/openejb/trunk/content/dev/source-code.html
Modified: websites/staging/openejb/trunk/content/dev/source-code.html
==============================================================================
--- websites/staging/openejb/trunk/content/dev/source-code.html (original)
+++ websites/staging/openejb/trunk/content/dev/source-code.html Thu Dec 15 17:12:35 2011
@@ -72,7 +72,8 @@
<h1>Source Code</h1>
</div>
-<p><a name="SourceCode-Browsing"></a></p>
+<p>Title: Source Code
+<a name="SourceCode-Browsing"></a></p>
<h1>Browsing</h1>
@@ -84,29 +85,29 @@
<h1>Downloading</h1>
<p>You can download (aka checkout) the sources of Apache OpenEJB with
-Subversion client using the following URL <a href="http://svn.apache.org/repos/asf/openejb/trunk/openejb3">http://svn.apache.org/repos/asf/openejb/trunk/openejb3</a>
+Subversion client using the following URL <a href="http://svn.apache.org/repos/asf/openejb/trunk/openejb">http://svn.apache.org/repos/asf/openejb/trunk/openejb</a>
.</p>
<p>Performing the checkout from the command line using the subversion client
is as easy as executing the following command:</p>
<blockquote>
- <p>$ svn co <a href="http://svn.apache.org/repos/asf/openejb/trunk/openejb3">http://svn.apache.org/repos/asf/openejb/trunk/openejb3</a></p>
+ <p>$ svn co <a href="http://svn.apache.org/repos/asf/openejb/trunk/openejb">http://svn.apache.org/repos/asf/openejb/trunk/openejb</a></p>
</blockquote>
<p>If you are experiencing problems with errors like "400 Bad Request
(http://svn.apache.org)", try using:</p>
<blockquote>
- <p>$ svn co <a href="https://svn.apache.org/repos/asf/openejb/trunk/openejb3">https://svn.apache.org/repos/asf/openejb/trunk/openejb3</a></p>
+ <p>$ svn co <a href="https://svn.apache.org/repos/asf/openejb/trunk/openejb">https://svn.apache.org/repos/asf/openejb/trunk/openejb</a></p>
</blockquote>
<p>or alternatively with Apache Maven 2 or later:</p>
<blockquote>
<p>mvn scm:checkout
- -DconnectionUrl=scm:svn:http://svn.apache.org/repos/asf/openejb/trunk/openejb3
- -DcheckoutDirectory=openejb3</p>
+ -DconnectionUrl=scm:svn:http://svn.apache.org/repos/asf/openejb/trunk/openejb
+ -DcheckoutDirectory=openejb</p>
</blockquote>
<p>It's not yet known how to see the progress of the checkout as mvn
@@ -135,17 +136,18 @@ All builders are available <a href="http
<p>To build the code, you'll need to grab a copy of <a href="http://maven.apache.org">Apache Maven</a>
version 2.0.4 or later. The standard build command is as follows:</p>
-<blockquote>
- <p>$ cd openejb3
- $ mvn -Dassemble clean install
- or alternatively when on Unix-like OSes
- $ cd openejb3
- $ mvn -o -Dmaven.{test,itest}.skip -Dassemble clean install
- Running with the <em>assemble</em> option turned on enables a profile that builds
- OpenEJB's assemblies (distros). They live in <em>assembly</em> directory. You can
- remove it from the command line if you're not interested in them - just
- remove -Dassemble from the command line and you're ready to go.</p>
-</blockquote>
+<pre><code>
+$ cd openejb3
+$ mvn -Dassemble clean install
+or alternatively when on Unix-like OSes
+$ cd openejb3
+$ mvn \-o \-Dmaven.\{test,itest\}.skip \-Dassemble clean install
+</code></pre>
+
+<p>Running with the <em>assemble</em> option turned on enables a profile that builds
+OpenEJB's assemblies (distros). They live in <em>assembly</em> directory. You can
+remove it from the command line if you're not interested in them - just
+remove -Dassemble from the command line and you're ready to go.</p>
<p><em>NOTE:</em> When importing a project into an IDE (Eclipse, NetBeans, IDEA) you
should run with the assemble profile on. It's because the assembly modules
@@ -158,23 +160,15 @@ on MacOS and Unices or <em>set MAVEN</em
<p>The output of that command should end with "BUILD SUCCESSFUL"</p>
-<pre><code>[INFO]
-</code></pre>
-
-<hr />
-
-<pre><code>[INFO]
-</code></pre>
-
-<p>Reactor Summary:
- [INFO]</p>
-
-<hr />
-
-<pre><code>[INFO]
-</code></pre>
-
-<p>OpenEJB ............................................... SUCCESS [3.722s]
+<pre><code>
+ [INFO]
+ ------------------------------------------------------------------------
+ [INFO]
+ Reactor Summary:
+ [INFO]
+ ------------------------------------------------------------------------
+ [INFO]
+ OpenEJB ............................................... SUCCESS [3.722s]
[INFO]
OpenEJB :: Dependencies ............................... SUCCESS [0.086s]
[INFO]
@@ -376,34 +370,23 @@ SUCCESS [0.271s]
OpenEJB :: Assembly :: Webapp ......................... SUCCESS [7.104s]
[INFO]
OpenEJB :: Assembly :: Java EE API Libraries .......... SUCCESS [1.787s]
- [INFO]</p>
-
-<hr />
-
-<pre><code>[INFO]
-</code></pre>
-
-<hr />
-
-<pre><code>[INFO]
-</code></pre>
-
-<p>BUILD SUCCESSFUL
- [INFO]</p>
-
-<hr />
-
-<pre><code>[INFO]
-</code></pre>
-
-<p>Total time: 5 minutes 40 seconds
+ [INFO]
+ ------------------------------------------------------------------------
+ [INFO]
+ ------------------------------------------------------------------------
+ [INFO]
+ BUILD SUCCESSFUL
+ [INFO]
+ ------------------------------------------------------------------------
+ [INFO]
+ Total time: 5 minutes 40 seconds
[INFO]
Finished at: Sat Jun 19 20:49:51 CEST 2010
[INFO]
Final Memory: 153M/338M
- [INFO]</p>
-
-<hr />
+ [INFO]
+ ------------------------------------------------------------------------
+</code></pre>
<p><a name="SourceCode-Running"></a></p>
@@ -414,14 +397,13 @@ turned on, you can find assemblies in th
<em>assembly</em> directory of each custom assembly. Go to the assembly directory
and have a look at its content.</p>
-<pre><code>jacek@devmac /Users/jacek/oss/openejb3/assembly
-$ ls -l
-total 8
-drwxr-xr-x 6 jacek staff 204 Jun 19 20:49 javaee-api-libs
-drwxr-xr-x 6 jacek staff 204 Jun 19 20:46
-</code></pre>
-
-<p>openejb-itests-standalone-client
+<pre><code>
+ jacek@devmac /Users/jacek/oss/openejb3/assembly
+ $ ls -l
+ total 8
+ drwxr-xr-x 6 jacek staff 204 Jun 19 20:49 javaee-api-libs
+ drwxr-xr-x 6 jacek staff 204 Jun 19 20:46
+openejb-itests-standalone-client
drwxr-xr-x 8 jacek staff 272 Jun 19 20:49 openejb-jetty
drwxr-xr-x 9 jacek staff 306 Jun 19 20:47 openejb-standalone
drwxr-xr-x 12 jacek staff 408 Jun 19 20:48 openejb-tomcat
@@ -429,7 +411,8 @@ drwxr-xr-x 6 jacek staff 204 Jun 19
drwxr-xr-x 6 jacek staff 204 Jun 19 20:46 openejb-webapp-common
-rw-r--r-- 1 jacek staff 1726 Jun 1 22:51 pom.xml
drwxr-xr-x 4 jacek staff 136 Jun 19 20:46 target
- drwxr-xr-x 4 jacek staff 136 Jun 1 22:51 test</p>
+ drwxr-xr-x 4 jacek staff 136 Jun 1 22:51 test
+</code></pre>
<p>The most common choice is to go to openejb-standalone which is exactly what
the name stands for - it lets you get OpenEJB up and running from a command
@@ -438,34 +421,31 @@ your EJBs right away. Looking at the <em
reveals the tar.gz'ed and zip'ed distributions. Unpack one and give it a
go.</p>
-<pre><code>jacek@devmac /Users/jacek/oss/openejb3/assembly/openejb-standalone/target
-$ jar -xvf openejb-3.2-SNAPSHOT.zip
- created: openejb-3.2-SNAPSHOT/
- ...
-
-jacek@devmac /Users/jacek/oss/openejb3/assembly/openejb-standalone/target
-$ cd openejb-3.2-SNAPSHOT
-
-jacek@devmac
-</code></pre>
+<pre><code>
+ jacek@devmac /Users/jacek/oss/openejb3/assembly/openejb-standalone/target
+ $ jar -xvf openejb-3.2-SNAPSHOT.zip
+ created: openejb-3.2-SNAPSHOT/
+ ...
-<p>/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
- $ chmod +x ./bin/openejb</p>
+ jacek@devmac /Users/jacek/oss/openejb3/assembly/openejb-standalone/target
+ $ cd openejb-3.2-SNAPSHOT
-<pre><code>jacek@devmac
-</code></pre>
+ jacek@devmac
+/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
+ $ chmod +x ./bin/openejb
-<p>/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
+ jacek@devmac
+/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
$ ./bin/openejb start
ERROR - Logging may not operate as expected. The directories for the
following files do not exist so no file can be created. See the list
below.
- ERROR - [0]</p>
+ ERROR - [0]
-<p>/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/transaction.log
- ERROR - [1]</p>
+/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/transaction.log
+ ERROR - [1]
-<p>/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/openejb.log
+/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/openejb.log
Apache OpenEJB 3.2-SNAPSHOT build: 20100619-08:45
http://openejb.apache.org/
log4j:WARN No appenders could be found for logger
@@ -476,37 +456,37 @@ below.
Jun 19, 2010 9:00:58 PM org.apache.cxf.bus.spring.BusApplicationContext
getConfigResources
INFO: No cxf.xml configuration file detected, relying on defaults.
- <em>* Starting Services *</em>
- NAME IP PORT <br />
- httpejbd 127.0.0.1 4204 <br />
- admin thread 127.0.0.1 4200 <br />
- ejbd 127.0.0.1 4201 <br />
- ejbd 127.0.0.1 4203 <br />
- hsql 127.0.0.1 9001 <br />
- telnet 127.0.0.1 4202 <br />
+ ** Starting Services **
+ NAME IP PORT
+ httpejbd 127.0.0.1 4204
+ admin thread 127.0.0.1 4200
+ ejbd 127.0.0.1 4201
+ ejbd 127.0.0.1 4203
+ hsql 127.0.0.1 9001
+ telnet 127.0.0.1 4202
-------
- Ready!</p>
+ Ready!
+</code></pre>
<p>There's another, slightly less error-prone approach using a shell script -
<em>try.sh</em> - that's tailor-made for that particular task - running OpenEJB 3
right after it's been built locally. No need to remember these
aforementioned steps but the mere name of the script itself</p>
-<pre><code>jacek@devmac /Users/jacek/oss/openejb3/assembly/openejb-standalone
-$ ./try.sh
-x openejb-3.2-SNAPSHOT/lib/xmlsec-1.4.3.jar
-...
-ERROR - Logging may not operate as expected. The directories for the
-</code></pre>
-
-<p>following files do not exist so no file can be created. See the list
+<pre><code>
+ jacek@devmac /Users/jacek/oss/openejb3/assembly/openejb-standalone
+ $ ./try.sh
+ x openejb-3.2-SNAPSHOT/lib/xmlsec-1.4.3.jar
+ ...
+ ERROR - Logging may not operate as expected. The directories for the
+following files do not exist so no file can be created. See the list
below.
- ERROR - [0]</p>
+ ERROR - [0]
-<p>/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/transaction.log
- ERROR - [1]</p>
+/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/transaction.log
+ ERROR - [1]
-<p>/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/openejb.log
+/Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT/conf/logs/openejb.log
Apache OpenEJB 3.2-SNAPSHOT build: 20100619-08:45
http://openejb.apache.org/
2010-06-19 21:09:35,780 - INFO - openejb.home =
@@ -520,12 +500,12 @@ below.
2010-06-19 21:09:53,376 - INFO - [Server@230cc23b]
: [Thread[main,5,main]
]: checkRunning(false) exited
- <em>* Starting Services *</em>
- NAME IP PORT <br />
- httpejbd 127.0.0.1 4204 <br />
- admin thread 127.0.0.1 4200 <br />
- ejbd 127.0.0.1 4201 <br />
- ejbd 127.0.0.1 4203 <br />
+ ** Starting Services **
+ NAME IP PORT
+ httpejbd 127.0.0.1 4204
+ admin thread 127.0.0.1 4200
+ ejbd 127.0.0.1 4201
+ ejbd 127.0.0.1 4203
2010-06-19 21:09:54,475 - INFO - [Server@230cc23b]
: Initiating startup sequence...
2010-06-19 21:09:54,479 - INFO - [Server@230cc23b]
@@ -542,10 +522,12 @@ below.
2010-06-19 21:09:54,656 - INFO - [Server@230cc23b]
: From command line, use [Ctrl]
+[C] to abort abruptly
- hsql 127.0.0.1 9001 <br />
- telnet 127.0.0.1 4202 <br />
+ hsql 127.0.0.1 9001
+ telnet 127.0.0.1 4202
-------
- Ready!</p>
+ Ready!
+
+</code></pre>
<p>The old 2 finger salute - Ctrl-C - stops the OpenEJB instance.</p>
@@ -560,25 +542,25 @@ debug options. There are essentially two
debugged at any point you wish. If you are in the directory where you
extracted the assembly to, just issue the following command...</p>
-<pre><code>jacek@devmac
-</code></pre>
-
-<p>Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
+<pre><code>
+ jacek@devmac
+Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
$ OPENEJB_OPTS="-Xdebug
-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8001"
-./bin/openejb start</p>
+./bin/openejb start
+</code></pre>
<p>Debug and suspend until a debugger has been attached. This is helpful if
the code that is to be debugged happens to be some of the startup code. The
following command would achieve this mode...</p>
-<pre><code>jacek@devmac
-</code></pre>
-
-<p>Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
+<pre><code>
+ jacek@devmac
+Users/jacek/oss/openejb3/assembly/openejb-standalone/target/openejb-3.2-SNAPSHOT
$ OPENEJB_OPTS="-Xdebug
-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8001"
-./bin/openejb start</p>
+./bin/openejb start
+</code></pre>
<p>Once either mode is started, just attach your favourite development IDE or
debugger, and away you go.</p>