blob: 81aa9f474bed6a66013abcc52c1c63152c5ef6ec [file] [log] [blame]
<?xml version="1.0"?>
<document url="installation-oas.html">
<title>The Struts Framework Project - Installation - Orion Application Server</title>
<chapter name="5.2 Installation" href="installation">
<section name="Installing Struts with your servlet container" href="Containers">
<h4 id="orion">Orion Application Server</h4>
<p>In the steps below, <code>$ORION_HOME</code> refers to the directory in which
you have installed Orion, and <code>$STRUTS_HOME</code> is the directory in
which you unpacked the Struts binary distribution.</p>
<li>Modify the file <code>$ORION_HOME/config/application.xml</code> to define
the two new applications, by adding the following declarations, immediately
following the <code>web-module</code> directive for the default web application:</li>
<pre>&lt;web-module id="strutsDoc"
&lt;web-module id="strutsExample"
<li>Modify the file <code>$ORION_HOME/config/default-web-site.xml</code> (or
the configuration file for any other Orion web site) to include the following
declarations, after the declaration for the &lt;default-web-app> if any:</li>
<pre>&lt;web-app application="default" name="strutsDoc"
&lt;web-app application="default" name="strutsExample"
<li>After you start Orion, you should now be able to access these applications
(assuming you haven't changed the port number from the default of 80) at:</li>
<li>Versions of Orion up to at least 1.0.3 have a bug related to ServletContext.getResource()
calls that prevent the Struts example application from working out of the
box. This manifests itself as a JSP error when you try to access the example
application, with the following message:<br/>
<code>javax.servlet.jsp.JspException: Missing resources attributeorg.apache.struts.action.MESSAGE</code><br/>
followed by an error traceback. There will also be an initialization error
message in the <code>ORION_HOME/log/global-application.log</code> log file.
To work around this problem, you can take the following steps:
<li>Go to the <code>$STRUTS_HOME/webapps</code> directory, where you will
note that Orion has automatically expanded each web application into an
unpacked directory structure.</li>
<li>Go to the <code>$STRUTS_HOME/webapps/struts-example/WEB-INF</code> directory,
and copy the file <code>struts-config.xml</code> one directory up (that
is, into <code>$STRUTS_HOME/webapps/struts-example</code>.</li>
<li>Modify the <code>$STRUTS_HOME/webapps/struts-example/WEB-INF/web.xm</code>
file, changing the value of the "config" initialization parameter (for the
action servlet) from <code>/WEB-INF/struts-config.xml</code> to <code>/action.xml</code>.</li>
<li>Restart Orion, and you should be able to access the example application.</li>
<li>Note that this workaround has a negative security-related side effect:
your <code>struts-conifig.xml</code> file can now be retrieved by remote
clients at the following URL:<br/>
Therefore, you should be sure you do not store sensitive information (such
as database passwords) in this file. </li>
<p>Back to <a href="installation.html#Containers">Installation</a></p>