husted 01/03/12 03:05:55
Modified: src/doc installation-ipas.xml
Log:
Revise installation instructions for iPortal. Submitted by John Ueltzhoeffer.
Revision Changes Path
1.3 +143 -160 jakarta-struts/src/doc/installation-ipas.xml
Index: installation-ipas.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/installation-ipas.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- installation-ipas.xml 2001/03/08 15:08:37 1.2
+++ installation-ipas.xml 2001/03/12 11:05:52 1.3
@@ -1,175 +1,158 @@
<?xml version="1.0"?>
<document url="./installation-ipas.xml">
-<properties>
-<author>John Ueltzhoeffer</author>
-<title>The Struts Framework Project - Installation - iPortal Application
Server</title>
-</properties>
-<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
-
-<h3><a name="ipas13">iPortal Application Server 1.3</a></h3>
-
-<p>Tested with: Windows 2000</p>
-
-<p><i>Important Note:</i> At the moment, iPAS 1.3 is not fully compliant with the
-JSP 1.1/1.2 specification. 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.
-As it stands, JSP pages that make use of Struts taglibs whose parameters
-require conversion (such as booleans) will not compile under iPAS 1.3.
-This includes the Struts Example Application. Attempting to run the
-example application will result in an exception similar to the
-following being thrown: </p>
-
+ <properties>
+ <author>John Ueltzhoeffer</author>
+ <title>The Struts Framework Project - Installation - iPortal Application
Server</title>
+ </properties>
+ <body>
+ <section name="Installing Struts with your servlet container"
href="Containers">
+ <h3>
+ <a name="ipas13">iPortal Application Server 1.3</a>
+ </h3>
+ <b>Tested with: Windows 2000</b>
+ <h4>Important Note:</h4>
+ <p>At the moment, iPAS 1.3 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:
+
Compilation failed [IT_Builder:1000]
- at com.iona.j2ee.builder.JavaBuilder.build(JavaBuilder.java:84)
- at com.iona.j2ee.builder.JspBuilder.build(JspBuilder.java:51)
- at com.iona.j2ee.builder.WarBuilder.build(WarBuilder.java:111)
- at com.iona.j2ee.builder.EarBuilder.build(EarBuilder.java:99)
- at com.iona.j2ee.builder.EarBuilder.main(EarBuilder.java:223)
- at iportal.build.main(build.java:14)
- ocale(boolean) in org.apache.struts.taglib.html.HtmlTag
- cannot be applied to (java.lang.String)
- _x0.setLocale("true");
- ^
- 1 error
+ at com.iona.j2ee.builder.JavaBuilder.build(JavaBuilder.java:84)
+ at com.iona.j2ee.builder.JspBuilder.build(JspBuilder.java:51)
+ at com.iona.j2ee.builder.WarBuilder.build(WarBuilder.java:111)
+ at com.iona.j2ee.builder.EarBuilder.build(EarBuilder.java:99)
+ at com.iona.j2ee.builder.EarBuilder.main(EarBuilder.java:223)
+ at iportal.build.main(build.java:14)
+ ocale(boolean) in org.apache.struts.taglib.html.HtmlTag
+ cannot be applied to (java.lang.String)
+ _x0.setLocale("true");
+ ^
+ 1 error
</pre>
-
-<p>(For more details see refer to:
-<a href="http://www.mail-archive.com/struts-user@jakarta.apache.org/msg01860.html">
-http://www.mail-archive.com/struts-user@jakarta.apache.org/msg01860.html</a>)</p>
-
-<p>The following instructions describe how to install the Struts Example
-Application under iPAS 1.3. A subsequent section describes how the Struts
+ <p>(For more details see refer to:<br/>
+ <font size="-1">
+ <a
href="http://www.mail-archive.com/struts-user@jakarta.apache.org/msg01860.html">http://www.mail-archive.com/struts-user@jakarta.apache.org/msg01860.html</a>
+ </font>)
+ </p>
+ <p>The following instructions describe how to install the Struts Example
+Application under iPAS 1.3. 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>iPortal Application Server 1.3 has been installed.</li>
-<li>Both the Strut and XML Parser libraries are in your classpath.</li>
-</ul>
-
-<h4>Installing the struts example application</h4>
-
-<ul>
-<li>Start iPAS Services by clicking on the [Start iPAS Services] menu item. </li>
-<li>Start the iPortal Application Server by clicking on the [iPortal Application
-Server] menu item. </li>
-<li>Start a command shell. Change to the <code>$INSTALLDIR\IONA</code> and run the
+ <p>The following instructions assume the following:</p>
+ <ul>
+ <li>iPortal Application Server 1.3 has been installed.</li>
+ <li>Both the Strut and XML Parser libraries are in your
classpath.</li>
+ </ul>
+ <h4>Installing the struts example application</h4>
+ <ul>
+ <li>Start iPAS Services by clicking on the [Start iPAS Services]
menu item. </li>
+ <li>Start the iPortal Application Server by clicking on the
[iPortal Application Server] menu item. </li>
+ <li>Start a command shell. Change to the
<code>$INSTALLDIR\IONA</code> and run the
setenvs.bat file.</li>
-<li>Create a directory called jars.</li>
-</ul>
-
-<p>Now run the EARSCO tool. Type <code>java iportal.earsco</code> and at the
prompts do:</p>
-
-<ul>
-<li>Next</li>
-<li>Type in the application name of <code>struts-example</code> then click
next.</li>
-<li>In step three click the check box and enter the name of the
- WAR <code>struts-example</code>.Then click next.</li>
-<li>Click on Finish.</li>
-</ul>
-
-<p>Now you must copy the contents of the struts-example war into the EARSCO
+ <li>Create a directory called jars.</li>
+ </ul>
+ <p>Now run the EARSCO tool. Type <code>java iportal.earsco</code> and
at the prompts do:</p>
+ <ul>
+ <li>Next</li>
+ <li>Type in the application name of <code>struts-example</code>
then click next.</li>
+ <li>In step three click the check box and enter the name of the
+ WAR <code>struts-example</code>.Then click next.</li>
+ <li>Click on Finish.</li>
+ </ul>
+ <p>Now you must copy the contents of the struts-example war into the
EARSCO
directory structure as follows: </p>
-
-<p>Under <code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war</code>
you
+ <p>Under
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war</code> you
copy contents into the following directories: etc, lib, src and web.</p>
-
-<ul>
-<li>Copy all files in the root directory <br/>
- <code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example\WEB-INF</code><br/>
- into the earsco directory<br/>
-
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\etc.</code><br/>
- Do not copy in the classes or lib directories.</li>
-
-<li>Copy the directory <br/>
-
<code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example\WEB-INF\lib</code><br/>
- into the earsco directory<br/>
-
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\lib.</code></li>
-
-<li>Copy the directory <br/>
-
<code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example\WEB-INF\classes</code><br/>
- into the earsco directory<br/>
-
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\src.</code>br/></li>
-
-<li>Copy the directory <br/>
- <code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example </code><br/>
- into the earsco directory <br/>
-
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\web.</code><br/>
</li>
-
-<li>Next modify the application.xml in the <br/>
- <code>$INSTALLDIR\IONA\jars\struts-examples\etc</code> directory to this: </li>
-</ul>
-
-<pre>
- <application>
-
- <!-- Add display name -->
- <display-name>Struts Example</display-name>
- .......
+ <ul>
+ <li>Copy all files in the root directory <br/>
+
<code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example\WEB-INF</code>
+ <br/>
+ into the earsco directory<br/>
+
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\etc</code>
+ <br/>
+ Do not copy in the classes or lib directories.</li>
+ <li>Copy the directory <br/>
+
<code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example\WEB-INF\lib</code>
+ <br/>
+ into the earsco directory<br/>
+
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\lib</code>
+ </li>
+ <li>Copy the directory <br/>
+ <code><font
size="-1">$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example\WEB-INF\classes</font></code>
+ <br/>
+ into the earsco directory<br/>
+
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\src</code>
+ <br/>
+ </li>
+ <li>Copy the directory <br/>
+ <code>$INSTALLDIR\jakarta-tomcat-3.2.1\webapps\struts-example
</code>
+ <br/>
+ into the earsco directory <br/>
+
<code>$INSTALLDIR\IONA\jars\struts-examples\src\struts-example.war\web</code>
+ <br/>
+ </li>
+ <li>Next modify the application.xml in the <br/>
+ <code>$INSTALLDIR\IONA\jars\struts-examples\etc</code>
directory to this: </li>
+ </ul>
+ <pre>
+ <application>
+
+ <!-- Add display name -->
+ <display-name>Struts Example</display-name>
+ .......
</pre>
-
-<ul>
-<li>Last update the cc.xml in the <br/>
- <code>$INSTALLDIR\IONA\jars\struts-examples directory as follows:</code></li>
-</ul>
-
-<pre>
- <configuration>
- <web-app>
- <context-root>struts-example</context-root>
- </web-app>
- </configuration>
+ <ul>
+ <li>Last update the cc.xml in the <br/>
+ <code>$INSTALLDIR\IONA\jars\struts-examples directory as
follows:</code>
+ </li>
+ </ul>
+ <pre>
+ <configuration>
+ <web-app>
+ <context-root>struts-example</context-root>
+ </web-app>
+ </configuration>
</pre>
-
-<p>Now you are ready to compile and deploy the struts-example.</p>
-
-<p>To compile the source from the $INSTALLDIR\IONA\jars\struts-examples type </p>
-
-<p><code>java iportal.build</code></p>
-
-<p>Next, type</p>
-
-<p><code>java iportal.deploy</code></p>
-
-<p>The first time you deploy you will be prompted by a Deploy wizard and asked to
-supply both locations of the struts-example.ear file and of the cc.xml file.
-Once both elements have been satisfied continue until the finish button and
+ <p>Now you are ready to compile and deploy the struts-example.</p>
+ <p>To compile the source from the $INSTALLDIR\IONA\jars\struts-examples
type </p>
+ <p>
+ <code>java iportal.build</code>
+ </p>
+ <p>Next, type</p>
+ <p>
+ <code>java iportal.deploy</code>
+ </p>
+ <p>The first time you deploy you will be prompted by a Deploy wizard
and asked to
+supply both locations of the struts-example.ear file and of the cc.xml file.
+Once both elements have been satisfied continue until the finish button and
click it. The EAR file should deploy sucessfully.</p>
-
-<p>Test the sample application by using the following URL in the browser:</p>
-
-<p><code>http://hostname:9000/struts-example/index.jsp</code></p>
-
-<p>The <code>struts-documentation.war</code> can be installed using the same
procedure.</p>
-
-<h4>Patching the struts example application</h4>
-
-<p>As mentioned at the beginning of these notes, the Struts Example Application
-will not run under iPAS 1.3 without modification. The following changes will
+ <p>Test the sample application by using the following URL in the
browser:</p>
+ <p>
+ <code>http://hostname:9000/struts-example/index.jsp</code>
+ </p>
+ <p>The <code>struts-documentation.war</code> can be installed using the
same procedure.</p>
+ <h4>Patching the struts example application</h4>
+ <p>As mentioned at the beginning of these notes, the Struts Example
Application
+will not run under iPAS 1.3 without modification. The following changes will
need to be made:</p>
-
-<p><code>index.jsp</code>, <code>logon.jsp</code>: Change <code><html:html
locale="true"></code>
-to <code><html:html locale=<%= true %>></code></p>
-
-<p><code>registration.jsp</code>, <code>subscription.jsp</code>: Change all
instances of
-<code>filter="true"</code> to <code>filter=<%= true %></code> </p>
-
-<hr/>
-
-<ul>
- <li>Author: John Ueltzhoeffer</li>
-</ul>
-
-<hr/>
-
-<p>Back to <a href="installation.html#Containers">Installation</a></p></section>
-
-</body>
+ <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>
+ <hr/>
+ <ul>
+ <li>Author: John Ueltzhoeffer</li>
+ </ul>
+ <hr/>
+ <p>Back to <a href="installation.html#Containers">Installation</a>
+ </p>
+ </section>
+ </body>
</document>
-
