User: sylvain Date: 00/07/03 16:17:31 Modified: src/docs index.html Added: src/docs tomcat.html Log: Updated documentation with Tomcat integration info. Revision Changes Path 1.3 +8 -9 jboss/src/docs/index.html Index: index.html =================================================================== RCS file: /products/cvs/ejboss/jboss/src/docs/index.html,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- index.html 2000/04/23 14:29:24 1.2 +++ index.html 2000/07/03 23:17:30 1.3 @@ -8,19 +8,18 @@ <BODY BGCOLOR="white"> <H1>jBoss 2.0</H1> <H2 >Description</H2> -<P>jBoss 2.0 is an EJB-server.<P/> +<P>jBoss 2.0 is an EJB-server.</P> <H2 >Documentation</H2> -<P> +jBoss website is at <a href="http://www.jboss.org/">www.jboss.org</a> <OL> -<LI>Server information can be found <a href="server.html">here</a>.</LI> -<LI>EJB development information can be found <a href="ejb.html">here</a>.</LI> -<LI>EJB container information can be found <a href="container.html">here</a>.</LI> + <LI>Server information can be found <a href="server.html">here</a>.</LI> + <LI>EJB development information can be found <a href="ejb.html">here</a>.</LI> + <LI>EJB container information can be found <a href="container.html">here</a>.</LI> + <li>Information on running <a href="http://jakarta.apache.org">Tomcat</a> with + jBoss can be found <a href="tomcat.html">here</a>.</li> </OL> -<P/> - <H3 >License</H3> -<P>jBoss 2.0 is licensed under the GPL license. See www.gnu.org for details. -<P/> +<P>jBoss 2.0 is licensed under the GPL license. See www.gnu.org for details. </P> </BODY> </HTML> 1.1 jboss/src/docs/tomcat.html Index: tomcat.html =================================================================== <html> <head> <title>Running Tomcat in jBoss</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> </head> <body bgcolor="#FFFFFF"> <h1>Running Tomcat in jBoss 2.0</h1> <h2>Goal</h2> <p>Running Tomcat inside the same VM as jBoss provides a couple of benefits :</p> <ul> <li>Better performance: if you have servlets, Java Beans or JSPs which access some EJBs, the speed will dramatically increase since there's no more RMI calls. Plain Java calls are used instead. <i><br> Nota : As of 07/03/2000, due to some ClassLoader problems, this feature is not yet implemented, and the calls are not as fast as we would like. We hope to fix this soon.</i></li> <li>Provides a more complete J2EE server, requiring only one command to startup both the EJB server and the Servlet/JSP server.</li> </ul> <h2>How-To</h2> <p>By default, when you start jBoss, it automatically tries to launch Tomcat as well. To disable this feature, suppress the lines<br> <font face="Courier New, Courier, mono" size="2"><MLET CODE = "org.jboss.tomcat.TomcatService" ARCHIVE="jboss.jar" CODEBASE="../lib/ext/"><br> </MLET><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet></font><font face="Courier New, Courier, mono"><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet></font><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><br> <mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/">at the end of the file <i>jboss.conf</i></mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> .</mlet></p> <p>In order for jBoss to find Tomcat's classes, you need to set a couple of environment variables :</p> <ul> <li>TOMCAT_HOME must point to the base directory of Tomcat's binaries. Typically, if you built Tomcat from jakarta/jakarta-tomcat, TOMCAT_HOME should point to jakarta/build/tomcat.</li> <li>SERVLETAPI_HOME must point to the source directory "jakarta-servletapi". The file $SERVLETAPI_HOME/lib/servlet.jar will be required.</li> <li>Your CLASSPATH must contain $JAVA_HOME/lib/tools.jar since Tomcat needs this to compile JSPs.</li> </ul> <p>Note that all these requirements are those of Tomcat. If you fail in any of these, you won't be able to start Tomcat in jBoss VM.</p> <h2>Future enhancements</h2> <p>Integrate Tomcat more tightly to jBoss. Fix the invocation speed problem. Provide an EAR deployer. Unify the security model... What else ?<mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet><mlet code = "org.jboss.tomcat.TomcatService" archive="jboss.jar" codebase="../lib/ext/"> </mlet></p> </body> </html>
