[cvs] expresso commit by dlloyd: Updated to reflect current
procedures
JCorporate Ltd
jcorp at jcorporate.com
Thu Feb 3 19:36:24 UTC 2005
Log Message:
-----------
Updated to reflect current procedures
Modified Files:
--------------
expresso/expresso-web/expresso/doc/appserv:
tomcat.html
Revision Data
-------------
Index: tomcat.html
===================================================================
RCS file: /home/javacorp/.cvs/expresso/expresso/expresso-web/expresso/doc/appserv/tomcat.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -Lexpresso-web/expresso/doc/appserv/tomcat.html -Lexpresso-web/expresso/doc/appserv/tomcat.html -u -r1.2 -r1.3
--- expresso-web/expresso/doc/appserv/tomcat.html
+++ expresso-web/expresso/doc/appserv/tomcat.html
@@ -7,107 +7,27 @@
</head>
<body class="jc-default">
-<p><strong>NOTE:</strong> The "Expresso Complete" bundle comes with a much later
-version of Tomcat than the one discussed here. Please check the
-documentation for Expresso complete for details. We've left this documentation
-here for reference if you're using VisualAge or older version of Tomcat,
-but parts of it are probably out of date!</p>
-<br>
<p class="jc-pageheader">Tomcat</p>
- <p>This page shows an example configuration of Tomcat with Expresso: This example was taken from an installation of Tomcat running within IBM's VisualAge, which is a very valuable technique for debugging servlets, but the Tomcat configuration should be basically the same no matter what JVM is used.</p>
- <p>Of course, you should refer to the release notes and install documents for Tomcat first, to ensure you have Tomcat up and operational before attempting to install or configure Expresso.</p>
- <h3>Directories</h3>
- <p>In this example, Tomcat is installed in the directory c:\IBMVJava2\ide\project_resources\Tomcat. In this directory is the "conf" directory from the Tomcat installation, the "webapps" directory, and several others relating to Tomcat.</p>
- <p>In this same directory is another directory entitled
-"expresso_config", which contains a single file: The properties
-file for Expresso, discussed in the Configuration instructions.</p>
- <p>In the webapps/ROOT directory, under the above directory is a directory called WEB-INF. In this directory is the web.xml file, which registers each of the Expresso servlets. It contains the following text:</p>
- <blockquote>
- <p><?xml version="1.0" encoding="ISO-8859-1"?><br>
- <web-app><br>
- <servlet><br>
- <servlet-name>Status</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.services.servlet.Status</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>DBMaint</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.DBMaint</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>Login</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>Logout</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>ShowLog</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.services.servlet.ShowLog</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>DBCreate</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.services.servlet.DBCreate</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>ControllerServlet</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.ControllerServlet</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>RegisterUser</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.ext.servlet.RegisterUser</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>SendNotice</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.ext.servlet.SendNotice</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>ControllerActionServlet</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.ControllerActionServlet</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>ClearLogs</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.services.servlet.ClearLogs</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>Test</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.Test</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>ChangePassword</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.ChangePassword</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>RunSQL</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.ext.servlet.RunSQL</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>Download</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.ext.servlet.Download</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>InitServletProps</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.Props</servlet-class><br>
- </servlet><br>
- <servlet><br>
- <servlet-name>DefaultInit</servlet-name><br>
- <servlet-class>com.jcorporate.expresso.core.servlet.DefaultInit</servlet-class><br>
- <init-param><br>
- <param-name>configDir</param-name><br>
- <param-value>c:\IBMVJava2\ide\project_resources\Tomcat\expresso_config</param-value><br>
- </init-param><br>
- <load-on-startup>1</load-on-startup><br>
- </servlet><br>
- </web-app><br>
- <br>
- </p>
- </blockquote>
- <p>Installing Expresso in the ROOT application is not necessarily the best practice with Tomcat, and we're working on additional sample installs that use Web Application Archive (.WAR) files, but this configuration should help you get started!</p>
- <h4>Class Path</h4>
- <p>Tomcat can be started up by running the org.apache.tomcat.startup.Tomcat class. From within VisualAge (again, from our sample installation), the Classpath is set (via the properties of the Tomcat object) as follows:</p>
- <blockquote>
- .; c:\ibmvjava2\ide\project_resources\Expresso; c:\ibmvjava2\ide\project_resources\Expresso XML; c:\ibmvjava2\ide\project_resources\Java Activation Framework; c:\ibmvjava2\ide\project_resources\JavaMail; c:\ibmvjava2\ide\project_resources\mySQL Driver; c:\ibmvjava2\ide\project_resources\Tomcat Examples; c:\ibmvjava2\ide\project_resources\Xanlan; c:\ibmvjava2\ide\project_resources\Xerces; C:\IBMVJava2\ide\project_resources\Tomcat\lib\mysql.jar; C:\IBMVJava2\ide\project_resources\Tomcat\lib\jasper.jar; C:\IBMVJava2\ide\project_resources\Tomcat\lib\servlet.jar; C:\IBMVJava2\ide\project_resources\Tomcat\work\; C:\IBMVJava2\ide\project_resources\Tomcat\work\localhost_8080\; C:\IBMVJava2\ide\project_resources\Tomcat\work\localhost_8080%2Fexamples\; C:\IBMVJava2\ide\project_resources\Tomcat\; C:\IBMVJava2\ide\project_resources\Tomcat\webapps\admin\WEB-INF\classes\; C:\IBMVJava2\ide\project_resources\Tomcat\webapps\examples\WEB-INF\classes\;</blockquote>
+
+ <p class="jc-info">
+ This page provides instructions on using Expresso with <a href="http://jakarta.apache.org/tomcat" target="_new">the Tomcat Servlet Container</a>. The instructions are for version 5.5.7 (Servlet API 2.4), but the procedure will be almost identical for most recent versions.
+ </p>
+
+ <ol>
+ <li>Obtain Tomcat - <a href="http://jakarta.apache.org/site/binindex.cgi" target="_new">http://jakarta.apache.org/site/binindex.cgi</a>. Uncompress the files into a local directory. It'll uncompress into <LOCAL_DIR>/jakarta-tomcat-5.5.7 (let's call this <CATALINA_HOME>, they do). That's pretty much it for primary installation.
+ </li>
+ <li>Create context directory. If you want to access the application by http://example.com/myapp, then create a directory <CATALINA_HOME>/webapps/myapp. There are other ways to accomplish this. Consult Tomcat's excellect documentation for instruction.
+ <li>Unjar the Expresso .war file into the new directory (i.e. myapp). This should create a hierarchy like myapp/expresso/... and myapp/WEB-INF/....
+ </li>
+ <li>Make sure there is a <CATALINA_HOME>/webapps/myapp/WEB-INF/log directory (or where ever the WEB-INF directory is located). If not, create an empty directory. This is where the Expresso logs will go, if you need to debug later.
+ <li>
+ Navigate to <CATALINA_HOME>/bin and run startup.bat on Windows, startup.sh on Unix/Linux.
+ </li>
+ <li>Access <a href=http://localhost:8080/myapp>http://localhost:8080/myapp</a> to get to Expresso!
+ </li>
+ </ol>
+
<p>Please report any difficulties or updates to this configuration example to support at <a href="mailto:support at jcorporate.com">support at jcorporate.com</a>
</body>
More information about the cvs
mailing list