husted 01/02/13 09:10:35
Modified: src/doc installation.xml
Log:
(Submitted by Ted Husted.) Add JRUN to installation guide, contributed by Eric Wu.
Revision Changes Path
1.13 +169 -1 jakarta-struts/src/doc/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/installation.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- installation.xml 2001/02/13 16:01:02 1.12
+++ installation.xml 2001/02/13 17:10:34 1.13
@@ -8,6 +8,7 @@
<author>Robert Hayden</author>
<author>Wong Kok Kai</author>
<author>John Rousseau</author>
+ <author>Eric Wu</author>
<title>The Struts Framework Project - Installation</title>
</properties>
@@ -241,6 +242,7 @@
<ul>
<li>Bluestone Universal Business Server - <a href="#bluestone">Additional steps
provided below.</a></li>
+ <li>JRUN - <a href="#jrun">Additional steps provided below.</a></li>
<li>Orion Application Server - <a href="#orion">Additional steps provided
below.</a></li>
<li>Silverstream - - <a href="#silverstream">Additional steps provided
below.</a></li>
<li>Tomcat 3.1+ with Apache - <a href="#tomcat_apache">Additional steps provided
@@ -249,7 +251,6 @@
</ul>
<ul>
- <li>JRUN - Determination pending.</li>
<li>Websphere - Determination pending.</li>
</ul>
@@ -290,6 +291,173 @@
on Windows, it might be "scripts/SaCGI.exe" or "scripts/ISAPI.dll". Consult
the UBS documentation for more information. </li>
</ul>
+
+<h4><a name="jrun">JRUN 3.0 SP2A, VERSION 3.02A.11614</a></h4>
+
+<b>Tested with: Microsoft IIS 5.0, Windows 2000</b>
+
+
+<h5>Important Note:</h5>
+
+<p>At the moment, JRun is not fully compliant with the JSP 1.1/1.2
+specification. </p>
+
+<p>Specifically, the automatic type conversions for custom tag parameters
+specified in "Issue 7" of the JSP 1.1 Errata and in the JSP 1.2 Proposed
+Final Draft have not yet been implemented.</p>
+
+<p>As it stands, JSP pages that make use of Struts taglibs whose parameters
+require conversion (such as booleans) will not compile under JRun. This
+includes the Struts Example Application. Attempting to run the example
+application will result in an exception similar to the following being
+thrown:</p>
+
+<pre>
+/struts-example/index.jsp:
+
+javax.servlet.ServletException: Compilation error occured:
+
+allaire.jrun.scripting.DefaultCFE:
+
+Errors reported by compiler:
+c:/JRun/servers/default/Struts
+ Example/WEB-INF/jsp/jrun__index2ejspa.java:41:1:41:27:
+
+Error: No match was found for method "setLocale(java.lang.String)".
+</pre>
+
+<p>(For more details see refer to:<br/>
+<font size="-1"><a
href="http://www.mail-archive.com/[email protected]/msg01860.html">http://www.mail-archive.com/[email protected]/msg01860.html</a></font>)</p>
+
+<p>The following instructions describe how to install the Struts Example
+Application under JRun. A subsequent section describes how the Struts Example
+Application can be patched to work with Struts</p>
+
+<p>The following instructions assume the following:</p>
+
+<ul>
+<li>JRun has been installed and integrated with the web server of choice.</li>
+
+<li>$APP_SERVER_NAME is the name of the application server used to host the
+ application. (When JRun is first installed, it creates an application
+ server called JRun Default Server).</li>
+
+<li>$APP_SERVER_DIR is the directory used to hold applications hosted by
+ $APP_SERVER_NAME. For the JRun Default Server, the directory is
+ $JRUN_HOME/servers/default where $JRUN_HOME is the directory where
+ JRun is installed.</li>
+</ul>
+
+<h5>Installing the struts example application</h5>
+
+<ul>
+<li>Login to the JRun Management Console.</li>
+
+<li>On the left pane, select $APP_SERVER_NAME. A page showing the
+ current server status will be shown on the right pane.</li>
+
+<li>On the right pane, click on the WAR Deployment link. A page
+ containing a list of the currently deployed web applications will be
+ shown.</li>
+
+<li>On the right pane, click on Deploy an Application. Complete the Web
+ Application Information form as follows:</li>
+
+ <ul>
+ <li>Servlet War File or Directory: Enter the full path where
+ struts-example.war is found or click on Browse to select
+ the path.</li>
+ <li>JRun Server Name: $APP_SERVER_NAME</li>
+ <li>Application Name: Struts Example</li>
+ <li>Application Hosts: All Hosts</li>
+ <li>Application URL: /struts-example</li>
+ <li>Application Deploy Directory: will default to
+ $APP_SERVER_NAME/Struts Example (or the name as specified for
+ Application Name).</li>
+ </ul>
+
+<li>Once the form is complete, click on the Deploy button.</li>
+
+<li>If deployment is successful, restart the application server by
+ clicking on <code>$APP_SERVER_NAME</code> on the left pane. A page showing the
+ current server status will be shown on the right pane. Click the
+ Restart Server button to restart the application server.</li>
+
+<li>Test the sample application by using the following URL in the
+ browser:<br/>
+ <code>http://hostname/struts-example/index.jsp</code><br/>
+ The struts-documentation.war can be installed using the same
+ procedure.</li>
+</ul>
+
+<h5>Installing unpacked web applications</h5>
+
+<p>The above steps should be followed for applications deployed as
<code>*.war</code> files.</p>
+
+<p>For unpacked web applications, configuration involves the following steps:</p>
+
+<ul>
+<li>From the JRun Management Console, select <code>$APP_SERVER_NAME</code> (on the
+ left pane) and click on WAR Deployment (on the right pane).</li>
+
+<li>On the right pane, click on Create an Application and complete the
+ Web Application Information form as follows:</li>
+
+<li>JRun Server Name: $APP_SERVER_NAME</li>
+
+ <ul>
+ <li>Application Name: myApplication</li>
+ <li>Application Hosts: All Hosts</li>
+ <li>Application URL: /myApplication</li>
+ <li>Application Deploy Directory: will default to<br/>
+ <code>$APP_SERVER_NAME/myApplication</code></li>
+ </ul>
+
+<li>Click on Create to submit the form.</li>
+
+<li>Once the web application is created, install and configure the struts
+ components (struts.jar, struts*.tld, etc) for the web application under
+ <code>$APP_SERVER_NAME/myApplication/WEB-INF</code></li>
+
+<li>Install the remaining components of the application: .class files,
+ JSP pages,.properties files etc as required.</li>
+
+<li>To configure the extension mapping of the request URI (ie *.do) to
+ the action servlet, expand <code>$APP_SERVER_NAME</code> on the left pane, expand
+ the Web Applications branch and click on myApplication. The right pane
+ will display the configuration options for myApplication. Click on
+ Servlet URL Mappings. A list of existing mappings will be shown. Click
+ the Edit button and create the following entry:</li>
+
+ <ul>
+ <li>Virtual Path/Extension: *.do</li>
+ <li>Servlet Invoked: action</li>
+ </ul>
+
+<li>Click on the Update button to save the changes.</li>
+<li>Restart the application server.</li>
+<li>The application should now be accessible from the browser.</li>
+</ul>
+
+<p>The JRun application server will need to be restarted each time one of the
+following changes are made to the web application:</p>
+
+<ul>
+<li><code>.class</code> or <code>.jar</code> files are modified</li>
+<li><code>.properties</code> files are modified</li>
+<li><code>.xml</code> files are modified</li>
+</ul>
+
+<h5>Patching the struts example application</h5>
+
+<p>As mentioned at the beginning of these notes, the Struts Example Application
+will not run under JRun without modification. The following changes will need
+to be made:</p>
+
+<ul>
+<li>index.jsp, logon.jsp: Change <html:html locale="true"> to <br/><html:html
locale=<%= true %>></li>
+<li>registration.jsp, subscription.jsp: Change all instances of filter="true" to
<br/>filter=<%= true %></li>
+</ul>
<h4><a name="orion">Orion Application Server</a></h4>
