6.2 Installation
Installing Struts with your servlet container
Orion Application Server
In the steps below,
$ORION_HOME
refers to the directory in which
you have installed Orion, and
$STRUTS_HOME
is the directory in
which you unpacked the Struts binary distribution.
- Modify the file
$ORION_HOME/config/application.xml
to define the two new applications, by adding the following declarations, immediately following theweb-module
directive for the default web application:
<web-module id="strutsDoc" path="$STRUTS_HOME/webapps/struts-documentation.war"/> <web-module id="strutsExample" path="$STRUTS_HOME/webapps/struts-example.war"/>
- Modify the file
$ORION_HOME/config/default-web-site.xml
(or the configuration file for any other Orion website) to include the following declarations, after the declaration for the <default-web-app> if any:
<web-app application="default" name="strutsDoc" root="/struts-documentation"/> <web-app application="default" name="strutsExample" root="/struts-example"/>
- 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:
http://localhost/struts-documentation http://localhost/struts-example
- 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:
javax.servlet.jsp.JspException: Missing resources attributeorg.apache.struts.action.MESSAGE
followed by an error traceback. There will also be an initialization error message in theORION_HOME/log/global-application.log
log file. To work around this problem, you can take the following steps:- Go to the
$STRUTS_HOME/webapps
directory, where you will note that Orion has automatically expanded each web application into an unpacked directory structure. - Go to the
$STRUTS_HOME/webapps/struts-example/WEB-INF
directory, and copy the filestruts-config.xml
one directory up (that is, into$STRUTS_HOME/webapps/struts-example
. - Modify the
$STRUTS_HOME/webapps/struts-example/WEB-INF/web.xm
file, changing the value of the "config" initialization parameter (for the action servlet) from/WEB-INF/struts-config.xml
to/action.xml
. - Restart Orion, and you should be able to access the example application.
- Note that this workaround has a negative
security-related side effect:
your
struts-conifig.xml
file can now be retrieved by remote clients at the following URL:
http://localhost/struts-example/struts-config.xml
Therefore, you should be sure you do not store sensitive information (such as database passwords) in this file.
- Go to the
Back to Installation