| |
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <HTML> |
| <HEAD> |
| <!-- $PAGETITLE --> |
| <TITLE>OpenEJB - Tomcat Detailed Instructions</TITLE> |
| <LINK href="http://openejb.apache.org/all.css" rel="stylesheet" type="text/css"> |
| <!--[if IE]><link rel="stylesheet" type="text/css" media="screen, projection" href="openejb.apache.org/ie.css"><![endif]--> |
| |
| <LINK rel="SHORTCUT ICON" href="http://openejb.apache.org/images/favicon.ico"> |
| <SCRIPT language="JavaScript" src="http://cwiki.apache.org/confluence/pages/viewpage.action?spaceKey=OPENEJB&title=functions.js" type="text/javascript"></SCRIPT> |
| <META http-equiv="Content-Type" content="text/html;charset=UTF-8"> |
| </HEAD> |
| <BODY> |
| |
| <!-- Delay the loading of the external javascript file needed for labels (as it takes too long to load and visibly holds loading of the page body) --> |
| <!-- To do this without javascript errors over undefined functions, we need to declare stubs here (that are overrided later by the proper implementations) --> |
| <SCRIPT language="JavaScript" type="text/javascript"> |
| function doAddLabel(hideTextfieldAfterAddParam) |
| { |
| // stub |
| } |
| |
| function onAddLabel() |
| { |
| // stub |
| } |
| |
| function showLabelsInput() |
| { |
| // stub |
| } |
| </SCRIPT> |
| |
| <A name="top"></A> |
| <TABLE class="frameTable" cellpadding="0" cellspacing="0" border="0"> |
| <TR class="Row1"> |
| <TD class="Col1"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col2"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col3"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col4"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col5"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| </TR> |
| <TR class="Row2"> |
| <TD class="Col1"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col2"> </TD> |
| <TD class="Col3" id="breadcrumbs"> |
| <!-- $TOP_NAV_BAR --> |
| <A href="index.html" title="Index">Home</A> | <A href="news.html" title="News">News</A> | <A href="faq.html" title="FAQ">FAQ</A> | <A href="download.html" title="Download">Download</A> | <A href="mailing-lists.html" title="Mailing Lists">Lists</A> | <A href="http://issues.apache.org/jira/browse/OPENEJB" class="external-link" rel="nofollow">Issues</A> |
| |
| </TD> |
| <TD class="Col4"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col5"> </TD> |
| </TR> |
| <TR class="Row3"> |
| <TD class="Col1"><IMG alt="" class="Row3Img" id="thinLine" src="http://openejb.apache.org/images/line_sm.gif"></TD> |
| <TD class="Col2"><IMG alt="" class="Row3Img" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col3"><IMG alt="" class="Row3Img" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col4"><IMG alt="" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col5"><IMG alt="" class="Row3Img" src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| </TR> |
| <TR class="Row4"> |
| <TD class="Col1"> |
| <SPAN id="Navigation"> |
| |
| <H3><A name="Navigation-Overview"></A>Overview</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="index.html" title="Index">Home</A></LI> |
| <LI><A href="news.html" title="News">News</A></LI> |
| <LI><A href="faq.html" title="FAQ">FAQ</A></LI> |
| <LI><A href="download.html" title="Download">Download</A></LI> |
| <LI><A href="../OPENEJBx30/index.html" title="Index">Documentation</A></LI> |
| <LI><A href="examples.html" title="Examples">Examples</A></LI> |
| <LI><A href="mailing-lists.html" title="Mailing Lists">Mailing Lists</A></LI> |
| <LI><A href="source-code.html" title="Source Code">Source Code</A></LI> |
| <LI><A href="http://blogs.apache.org/openejb" class="external-link" rel="nofollow">Project Blog</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Configuration"></A>Configuration</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="configuration.html" title="Configuration">General</A></LI> |
| <LI><A href="../OPENEJBx30/deployments.html" title="Deployments">Deployments</A></LI> |
| <LI><A href="containers.html" title="Containers">Containers</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Servers"></A>Servers</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="local-server.html" title="Local Server">Local</A></LI> |
| <LI><A href="remote-server.html" title="Remote Server">Remote</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Integrations"></A>Integrations</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="tomcat.html" title="Tomcat">Tomcat</A></LI> |
| <LI><A href="geronimo.html" title="Geronimo">Geronimo</A></LI> |
| <LI><A href="webobjects.html" title="WebObjects">WebObjects</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Community"></A>Community</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="team.html" title="Team">Team</A></LI> |
| <LI><A href="articles.html" title="Articles">Articles</A></LI> |
| <LI><A href="irc://irc.freenode.net/#openejb" class="external-link" rel="nofollow">IRC</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-RelatedProjects"></A>Related Projects</H3> |
| |
| <UL class="alternate" type="square"> |
| <LI><A href="http://activemq.apache.org/" class="external-link" rel="nofollow">ActiveMQ</A></LI> |
| <LI><A href="http://openjpa.apache.org/" class="external-link" rel="nofollow">OpenJPA</A></LI> |
| <LI><A href="http://cxf.apache.org/" class="external-link" rel="nofollow">CXF</A></LI> |
| </UL> |
| |
| |
| <H3><A name="Navigation-Index"></A>Index</H3> |
| <UL class="alternate" type="square"> |
| <LI><A href="space-index.html" title="Space Index">Site Index</A></LI> |
| <LI><A href="../OPENEJBx30/space-index.html" title="Space Index">Doc Index</A></LI> |
| </UL> |
| |
| <H3> |
| <A name="Navigation-Feeds"></A> |
| Feeds |
| </H3> |
| |
| <UL class="feeds"> |
| <LI> |
| <A href="http://cwiki.apache.org/confluence/spaces/rss.action?key=OPENEJB&newPages=false"> |
| <IMG src="http://openejb.apache.org/images/rss.gif"></A> |
| <A class="feedsText" href="http://cwiki.apache.org/confluence/spaces/rss.action?key=OPENEJB&newPages=false">Site</A> |
| </LI> |
| |
| <LI><A href="http://cwiki.apache.org/confluence/spaces/blogrss.action?key=OPENEJB"> |
| <IMG src="http://openejb.apache.org/images/rss.gif"></A> |
| <A class="feedsText" href="http://cwiki.apache.org/confluence/spaces/blogrss.action?key=OPENEJB">News</A> |
| </LI> |
| </UL> |
| </SPAN> |
| </TD> |
| <TD class="Col2"> </TD> |
| <TD class="Col3"> |
| <TABLE id="PageHeader" border="0" width="100%"> |
| <TR> |
| <TD> |
| <A href="http://openejb.org/"> |
| <IMG hspace="0" src="http://openejb.apache.org/images/logo_openejb.gif" vspace="0"> |
| </A> |
| </TD> |
| <TD align="right"> |
| <A href="http://www.apache.org/"> |
| <IMG src="http://www.apache.org/images/asf-logo.gif" width="258" height="66"> |
| </A> |
| </TD> |
| </TR> |
| <TR> |
| <TD id="page_title"> |
| <!-- $TITLE --> |
| Tomcat Detailed Instructions |
| </TD> |
| |
| <TD align="right"> |
| <BR><BR> |
| <!-- Google CSE Search Box Begins --> |
| <FORM id="searchbox_010475492895890475512:_t4iqjrgx90" action="http://www.google.com/cse"> |
| <INPUT type="hidden" name="cx" value="010475492895890475512:_t4iqjrgx90"> |
| <INPUT type="hidden" name="cof" value="FORID:0"> |
| <INPUT name="q" type="text" size="25"> |
| <INPUT type="submit" name="sa" value="Search"> |
| </FORM> |
| <SCRIPT type="text/javascript" src="http://www.google.com/coop/cse/brand?form=searchbox_010475492895890475512:_t4iqjrgx90"></SCRIPT> |
| <!-- Google CSE Search Box Ends --> |
| |
| </TD> |
| </TR> |
| </TABLE> |
| <P> |
| <!-- $BODY --> |
| <DIV id="PageContent"> |
| |
| |
| <H1><A name="TomcatDetailedInstructions-DetailedInstallationInstructions"></A><A name="TomcatDetailedInstructions-detailedinstructions"></A> Detailed Installation Instructions</H1> |
| |
| <P>These instructions assume you have a standard Tomcat installation running on port 8080. If you do not have an existing Tomcat installation, or want to start with a fresh installation for OpenEJB, the <A href="tomcat-installation.html" title="Tomcat Installation">Tomcat Installation</A> will show you how to setup and verify a Tomcat installation.</P> |
| |
| <H2><A name="TomcatDetailedInstructions-Addopenejb.wartoTomcat"></A>Add openejb.war to Tomcat</H2> |
| |
| <P>The OpenEJB plugin for Tomcat is distributed as a standalone war file containing all of the necessary files and an installer Servlet. The war can be obtained from the <A href="download.html" title="Download">OpenEJB download page</A>. Once downloaded, simply copy the file into the Tomcat webapps directory. </P> |
| |
| <DIV id="deck:Copy openejb.war" class="deck" tablocation="top" style="display: none" loopcards="false"><DIV class="cards tabbed"> |
| <P><DIV class="card" label="Windows" labelrendered="Windows"><PRE>C:\>copy openejb.war apache-tomcat-6.0.14\webapps\openejb.war |
| 1 file(s) copied. |
| |
| C:\>dir apache-tomcat-6.0.14\webapps |
| Volume in drive C has no label. |
| Volume Serial Number is 0000-0000 |
| |
| Directory of C:\apache-tomcat-6.0.14\webapps |
| |
| 09/20/2007 03:03 PM <DIR> . |
| 09/20/2007 03:03 PM <DIR> .. |
| 09/20/2007 03:02 PM <DIR> docs |
| 09/20/2007 03:01 PM <DIR> examples |
| 09/20/2007 03:01 PM <DIR> host-manager |
| 09/20/2007 03:03 PM <DIR> manager |
| 09/19/2007 09:31 AM 13,394,733 openejb.war |
| 09/20/2007 03:01 PM <DIR> ROOT |
| 1 File(s) 13,394,733 bytes |
| 7 Dir(s) 5,100,126,208 bytes free |
| </PRE></DIV><BR> |
| <DIV class="card" label="Unix" labelrendered="Unix"><PRE>$ cp openejb.war apache-tomcat-6.0.14/webapps/openejb.war |
| |
| $ ls apache-tomcat-6.0.14/webapps/ |
| ROOT/ docs/ examples/ host-manager/ manager/ openejb.war |
| </PRE></DIV></P> |
| </DIV></DIV> |
| |
| <H2><A name="TomcatDetailedInstructions-RunInstallerServlet"></A>Run Installer Servlet</H2> |
| |
| <P>The OpenEJB Plugin for Tomcat contains an installer servlet which adds the OpenEJB listener and JavaAgent to the Tomcat installation. To run the installer, you must first start Tomcat.</P> |
| |
| <DIV id="deck:Start Tomcat" class="deck" tablocation="top" style="display: none" loopcards="false"><DIV class="cards tabbed"> |
| <P><DIV class="card" label="Windows" labelrendered="Windows"><PRE>C:\>set JRE_HOME=C:\Program Files\Java\jre1.5.0_06 |
| |
| C:\>cd apache-tomcat-6.0.14\bin |
| |
| C:\apache-tomcat-6.0.14\bin>startup.bat |
| Using CATALINA_BASE: C:\apache-tomcat-6.0.14 |
| Using CATALINA_HOME: C:\apache-tomcat-6.0.14 |
| Using CATALINA_TMPDIR: C:\apache-tomcat-6.0.14\temp |
| Using JRE_HOME: C:\your\java\installation |
| </PRE></DIV><BR> |
| <DIV class="card" label="Unix" labelrendered="Unix"><PRE>$ cd apache-tomcat-6.0.14/bin |
| |
| apache-tomcat-6.0.14/bin$ chmod u+x *.sh |
| |
| apache-tomcat-6.0.14/bin$ ./startup.sh |
| Using CATALINA_BASE: /your/tomcat/installation/apache-tomcat-6.0.14 |
| Using CATALINA_HOME: /your/tomcat/installation/apache-tomcat-6.0.14 |
| Using CATALINA_TMPDIR: /your/tomcat/installation/apache-tomcat-6.0.14/temp |
| Using JRE_HOME: /your/java/installation |
| </PRE></DIV></P> |
| </DIV></DIV> |
| |
| <P><B>NOTE:</B> Your output will be different from the example above due to differences in installation locations.</P> |
| |
| <P>It is a good idea to wait a 5-60 seconds (depending on the speed of your computer) for Tomcat to fully start. Once Tomcat is fully started, simply visit <A href="http://localhost:8080/openejb/installer" class="external-link" rel="nofollow">http://localhost:8080/openejb/installer</A> and click the 'install' button to run the installer. The installer should report that the installation was successful. If it didn't work click <A href="#TomcatDetailedInstructions-problems">here</A>.</P> |
| |
| <DIV class="panelMacro"><TABLE class="warningMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cwiki.apache.org/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>The installer servlet adds the OpenEJB JavaAgent declaration to the catalina.sh and catalina.bat files. If you are using an IDE or some other mechanism to start Tomcat, you will need to <A href="manual-installation.html#ManualInstallation-javaagent">manually</A> add the JavaAgent declaration to the Java VM options of the launcher you are using.</TD></TR></TABLE></DIV> |
| |
| <H2><A name="TomcatDetailedInstructions-RestartTomcat"></A>Restart Tomcat</H2> |
| |
| <P>OpenEJB uses OpenJPA for persistence and OpenJPA currently requires a JavaAgent to function. Unfortunately, there is no way to install a JavaAgent at runtime, so you will have to restart Tomcat to enable the JavaAgent. Simply execute the shutdown command, wait 5-60 seconds (depending on the speed of your computer) for Tomcat to fully stop, and run the startup command to restart Tomcat.</P> |
| |
| <DIV id="deck:Start Tomcat" class="deck" tablocation="top" style="display: none" loopcards="false"><DIV class="cards tabbed"> |
| <P><DIV class="card" label="Windows" labelrendered="Windows"><PRE>C:\>cd apache-tomcat-6.0.14\bin |
| |
| C:\apache-tomcat-6.0.14\bin>shutdown.bat |
| Using CATALINA_BASE: C:\apache-tomcat-6.0.14 |
| Using CATALINA_HOME: C:\apache-tomcat-6.0.14 |
| Using CATALINA_TMPDIR: C:\apache-tomcat-6.0.14\temp |
| Using JRE_HOME: C:\your\java\installation |
| |
| C:\apache-tomcat-6.0.14\bin>startup.bat |
| Using CATALINA_BASE: C:\apache-tomcat-6.0.14 |
| Using CATALINA_HOME: C:\apache-tomcat-6.0.14 |
| Using CATALINA_TMPDIR: C:\apache-tomcat-6.0.14\temp |
| Using JRE_HOME: C:\your\java\installation |
| </PRE></DIV><BR> |
| <DIV class="card" label="Unix" labelrendered="Unix"><PRE>$ cd apache-tomcat-6.0.14/bin |
| |
| apache-tomcat-6.0.14/bin$ ./shutdown.sh |
| Using CATALINA_BASE: /your/tomcat/installation/apache-tomcat-6.0.14 |
| Using CATALINA_HOME: /your/tomcat/installation/apache-tomcat-6.0.14 |
| Using CATALINA_TMPDIR: /your/tomcat/installation/apache-tomcat-6.0.14/temp |
| Using JRE_HOME: /your/java/installation |
| |
| apache-tomcat-6.0.14/bin$ ./startup.sh |
| Using CATALINA_BASE: /your/tomcat/installation/apache-tomcat-6.0.14 |
| Using CATALINA_HOME: /your/tomcat/installation/apache-tomcat-6.0.14 |
| Using CATALINA_TMPDIR: /your/tomcat/installation/apache-tomcat-6.0.14/temp |
| Using JRE_HOME: /your/java/installation |
| </PRE></DIV></P> |
| </DIV></DIV> |
| |
| <P><B>NOTE:</B> Your output will be different from the example above due to differences in installation locations.</P> |
| |
| <P>Once Tomcat is fully started, simply visit <A href="http://localhost:8080/openejb/installer" class="external-link" rel="nofollow">http://localhost:8080/openejb/installer</A> to verify the installation is complete.</P> |
| |
| <H1><A name="TomcatDetailedInstructions-Examples%2CTutorialsandTests"></A>Examples, Tutorials and Tests</H1> |
| |
| <H2><A name="TomcatDetailedInstructions-ejbexamples.war"></A>ejb-examples.war</H2> |
| |
| <P>Download the <A href="http://people.apache.org/~dain/openejb-temp/examples" class="external-link" rel="nofollow">ejb-examples.war</A>, copy it into the Tomcat webapps directory, and visit <A href="http://localhost:8080/ejb-examples" class="external-link" rel="nofollow">http://localhost:8080/ejb-examples</A>.</P> |
| |
| <H2><A name="TomcatDetailedInstructions-OpenEJBiTests"></A>OpenEJB iTests</H2> |
| |
| <P>OpenEJB uses a large test suite to verify the final server assembly, and you can use this to verify your OpenEJB installation. Simply download the <A href="http://people.apache.org/~dain/openejb-temp/itests" class="external-link" rel="nofollow">openejb-itests.war and openejb-standalone-client.jar</A> and copy it the war into the Tomcat webapps directory. It will take a bit to load the application because it contains a huge number of EJBs. Finally, run the test client executable jar.</P> |
| |
| <DIV id="deck:Start Tomcat" class="deck" tablocation="top" style="display: none" loopcards="false"><DIV class="cards tabbed"> |
| <P><DIV class="card" label="Windows" labelrendered="Windows"><PRE>C:\>java -jar openejb-itests-standalone-client.jar tomcat |
| _________________________________________________ |
| |_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_| |
| |
| Running EJB compliance tests on HTTP/Tomcat Server |
| _________________________________________________ |
| WARNING: No test suite configuration file specified, assuming system properties contain all |
| needed information. To specify a test suite configuration file by setting its location using |
| the system property "openejb.testsuite.properties" |
| test server = org.apache.openejb.test.TomcatRemoteTestServer |
| entry = java.naming.provider.url:http://127.0.0.1:8080/openejb/ejb |
| entry = java.naming.factory.initial:org.apache.openejb.client.RemoteInitialContextFactory |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ............................ |
| Time: 20.644 |
| |
| OK (889 tests) |
| |
| |
| _________________________________________________ |
| CLIENT JNDI PROPERTIES |
| java.naming.provider.url = http://127.0.0.1:8080/openejb/ejb |
| java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| _________________________________________________ |
| </PRE></DIV><BR> |
| <DIV class="card" label="Unix" labelrendered="Unix"><PRE>$ java -jar openejb-itests-standalone-client.jar tomcat |
| _________________________________________________ |
| |_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_| |
| |
| Running EJB compliance tests on HTTP/Tomcat Server |
| _________________________________________________ |
| WARNING: No test suite configuration file specified, assuming system properties contain all |
| needed information. To specify a test suite configuration file by setting its location using |
| the system property "openejb.testsuite.properties" |
| test server = org.apache.openejb.test.TomcatRemoteTestServer |
| entry = java.naming.provider.url:http://127.0.0.1:8080/openejb/ejb |
| entry = java.naming.factory.initial:org.apache.openejb.client.RemoteInitialContextFactory |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ......................................... |
| ............................ |
| Time: 12.186 |
| |
| OK (889 tests) |
| |
| |
| _________________________________________________ |
| CLIENT JNDI PROPERTIES |
| java.naming.provider.url = http://127.0.0.1:8080/openejb/ejb |
| java.naming.factory.initial = org.apache.openejb.client.RemoteInitialContextFactory |
| _________________________________________________ |
| </PRE></DIV></P> |
| </DIV></DIV> |
| |
| <DIV class="panelMacro"><TABLE class="tipMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Failures</B><BR>The tests should completely pass the first time they are run. If you execute the test client a second time, 21 tests fail for some unknown reason.</TD></TR></TABLE></DIV> |
| |
| <H1><A name="TomcatDetailedInstructions-Problems%3F"></A><A name="TomcatDetailedInstructions-problems"></A> Problems?</H1> |
| |
| <H2><A name="TomcatDetailedInstructions-HTTPStatus403"></A>HTTP Status 403 </H2> |
| |
| <P>Did you get a "HTTP Status 403" error page containing the description "Access to the specified resource () has been forbidden." when visiting <A href="http://localhost:8080/openejb" class="external-link" rel="nofollow">http://localhost:8080/openejb</A>?</P> |
| |
| <P>The openejb.war is protected by a Tomcat valve that restricts access to the application to the computer on which Tomcat is running. If your browser is running on the same computer as Tomcat, try accessing OpenEJB using this link instead <A href="http://127.0.0.1:8080/openejb" class="external-link" rel="nofollow">http://127.0.0.1:8080/openejb</A>.</P> |
| |
| <P>If you want to access the openejb.war from another computer, you will need to either remove the valve, or modify the IP list in the valve declaration. The easiest way to remove the valve it to simply delete the webapps/openejb/META-INF/context.xml file and and the webapps/openejb.war file <B>while Tomcat is stopped</B>. The openejb.war file must be removed because some versions of Tomcat will use the context.xml file packed in the openejb.war file regardless of what is in the unpacked directory.</P> |
| |
| <H2><A name="TomcatDetailedInstructions-OtherIssues"></A>Other Issues</H2> |
| |
| <P>If you are having problems with the installation, please send a message to the OpenEJB users <A href="mailing-lists.html" title="Mailing Lists">mailing list</A> containing any error message(s) and the following information:</P> |
| |
| <UL> |
| <LI>OpenEJB Version</LI> |
| <LI>Tomcat Version</LI> |
| <LI>Java Version (execute java -version)</LI> |
| <LI>Operating System Type and Version</LI> |
| </UL> |
| |
| |
| |
| <H1><A name="TomcatDetailedInstructions-Limitations"></A>Limitations</H1> |
| |
| <P> <B>Tomcat 6.x</B> - Currently, only Tomcat 6.x is supported due to API difference between 5.5.x and 6.x. It is expected that 5.5 will be supported in the future, but there are no plans to support 5.0.x due to the lack of annotation support in 5.0.x.</P> |
| |
| <P> <B>Security</B> - Unfortunately, at this time security with Tomcat/OpenEJB is not integrated, but is being worked on.</P> |
| |
| <P> <B>EAR Files</B> - The integration only supports war (and collapsed-ear) files. EAR, EJB Jar, and RAR files will be supported in a future release.</P> |
| |
| <P> <B>JavaAgent</B> - OpenEJB uses OpenJPA to provide JPA and CMP persistence, and OpenJPA currently requires a JavaAgent to function properly. This requirement is something that the OpenJPA project is working on removing. Once removed, the OpenEJB plugin for Tomcat will no longer need to modify the startup shell scripts and you will not need to restart Tomcat after the OpenEJB installation.</P> |
| |
| <H1><A name="TomcatDetailedInstructions-Misc"></A>Misc</H1> |
| |
| <P>This document is a starting point for using OpenEJB in Tomcat and will evolve based on user contributions. If you wish to contribute to this document, feel very welcome to click the 'Edit' link in the upper right and make changes and add new HOWTO's and other docs. </P> |
| |
| </DIV> |
| </P> |
| </TD> |
| <TD class="Col4"><IMG src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col5"> |
| |
| </TD> |
| </TR> |
| <TR class="Row5"> |
| <TD class="Col1"> </TD> |
| <TD class="Col2"> </TD> |
| <TD class="Col3"> |
| <BR> |
| <BR> |
| <IMG width="100%" height="1" src="http://openejb.apache.org/images/line_light.gif"> |
| <TABLE width="100%"> |
| <TR> |
| <TD> |
| <SPAN class="bodyGrey"> |
| <SMALL> |
| <NOTICE><!-- $FOOTER --> |
| Apache OpenEJB is an project of The Apache Software Foundation (ASF) |
| </NOTICE> |
| <BR> |
| Site Powered by |
| <A href="http://atlassian.com/">Atlassian</A> |
| <A href="http://atlassian.com/confluence/">Confluence</A> |
| . |
| </SMALL> |
| </SPAN> |
| </TD> |
| <TD align="right"> |
| <A style="color:#999;font-size:small;font-weight:normal;" href="http://cwiki.apache.org/confluence/pages/editpage.action?spaceKey=OPENEJB&title=Tomcat%20Detailed%20Instructions">[ edit ]</A> |
| </TD> |
| </TR> |
| </TABLE> |
| <BR> |
| </TD> |
| <TD class="Col4"><IMG src="http://openejb.apache.org/images/dotTrans.gif"></TD> |
| <TD class="Col5"> </TD> |
| </TR> |
| </TABLE> |
| |
| <!-- Needed for composition plugin --> |
| <!-- delay the loading of large javascript files to the end so that they don't interfere with the loading of page content --> |
| <SPAN style="display: none"> |
| <SCRIPT type="text/javascript" language="JavaScript" src="http://cwiki.apache.org/confluence/labels-javascript"></SCRIPT> |
| |
| <SCRIPT src="http://www.google-analytics.com/urchin.js" type="text/javascript"> |
| </SCRIPT> |
| <SCRIPT type="text/javascript"> |
| _uacct = "UA-2717626-1"; |
| urchinTracker(); |
| </SCRIPT> |
| </SPAN> |
| |
| </BODY> |
| </HTML> |
