svn commit: r1228938 - /openejb/site/trunk/content/unix-daemon.mdtext

[db...@apache.org]

Author: dblevins
Date: Sun Jan  8 20:14:36 2012
New Revision: 1228938

URL: http://svn.apache.org/viewvc?rev=1228938&view=rev
Log:
Documenting the unix daemon feature of Tomcat

Added:
    openejb/site/trunk/content/unix-daemon.mdtext

Added: openejb/site/trunk/content/unix-daemon.mdtext
URL: http://svn.apache.org/viewvc/openejb/site/trunk/content/unix-daemon.mdtext?rev=1228938&view=auto
==============================================================================
--- openejb/site/trunk/content/unix-daemon.mdtext (added)
+++ openejb/site/trunk/content/unix-daemon.mdtext Sun Jan  8 20:14:36 2012
@@ -0,0 +1,30 @@
+Title: Unix Daemon
+
+TomEE can be run as a daemon using the jsvc tool from the commons-daemon project. Source tarballs for jsvc are included with the TomEE binaries, and need to be compiled. Building jsvc requires a C ANSI compiler (such as GCC), GNU Autoconf, and a JDK.
+
+Before running the script, the JAVA_HOME environment variable should be set to the base path of the JDK. Alternately, when calling the ./configure script, the path of the JDK may be specified using the --with-java parameter, such as ./configure --with-java=/usr/java.
+
+Using the following commands should result in a compiled jsvc binary, located in the $CATALINA_HOME/bin folder. This assumes that GNU TAR is used, and that CATALINA_HOME is an environment variable pointing to the base path of the TomEE installation.
+
+Please note that you should use the GNU make (gmake) instead of the native BSD make on FreeBSD systems.
+
+# Building
+
+    tar xzvf apache-tomee-1.0.0-beta-2-webprofile.tar.gz
+    cd apache-tomee-webprofile-1.0.0-beta-2/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)
+
+    cd $TOMEE_HOME
+    sudo ./bin/jsvc -cp ./bin/bootstrap.jar:./bin/tomcat-juli.jar  -outfile ./logs/catalina.out -errfile ./logs/catalina.err  org.apache.catalina.startup.Bootstrap
+
+# Starting (osx)
+
+    cd $TOMEE_HOME
+    sudo arch -arch x86_64 ./bin/jsvc -jvm server  -cp ./bin/bootstrap.jar:./bin/tomcat-juli.jar         -outfile ./logs/catalina.out -errfile ./logs/catalina.err         org.apache.catalina.startup.Bootstrap