install

里面有个webapps目录

$Id: INSTALL,v 1.7 2001/07/21 06:19:14 martinc Exp $

                Struts
                ======

This document contains notes that have been accumulated on getting the Struts
applications (documentation and example) running in a variety of servlet
container environments.

For most containers, you need only to:

* Copy the WAR files in your Struts < /webapp > directory to your containers
  < webapps > directory.

* In some cases, you may need to restart your container if it is running.

Status of various containers -- as reported by volunteers on the Struts-User list.

* Tomcat 3.1+ Standalone - No additonal steps required.
* Resin 1.2+ Standalone - No additional steps required.
* WebLogic 6.0+ - No additional steps required.

* Bluestone Universal Business Server - Additional steps provided below.
* JRUN - Additional steps provided below.
* Orion Application Server - Additional steps provided below.
* Tomcat 3.1+ with Apache - Additional steps provided below.
* Weblogic 5.1 (sp8) - Additional steps provided below.

* Websphere - Determination pending.


BLUESTONE UNIVERSAL BUSINESS SERVER
-----------------------------------

*   You need UBS version 7.2 to run war file applications.  The UBS 7.2.2
    evaluation is located here:

        http://www.bluestone.com/SaISAPI.dll/SaServletEngine.class/products/downloads.jsp

*   If you're using version 7.2.1, you need to download the WAR file patch,
    located in the product enhancement section of Bluestone's website:

        http://www.bluestone.com/SaISAPI.dll/SaServletEngine.class/products/wfe.jsp

*   After installation of the correct version and/or patch of UBS 7.2, you
    need to modify your apserver.txt file to point to the correct directory
    for your war file applications.  Look for the section that says something
    similar to the following:

        [SaServletEngine.class]
        session_affinity=1
        type=1
        program=/SaServletEngine.class
        file_path=f:\webapps
        host=localhost:20000

*   Use the directory specified by the "file_path" variable, or modify it
    to point to your own custom webapp directory.  Copy the
    "struts-documention.war" and "struts-example.war" files into that
    webapp directory, and start the UBS (read documentation distributed
    with UBS for information on how to start it if necessary).  Your webapps
    are now accessible from the following URL's:

        http://localhost/<PLUGIN>/SaServletEngine.class/struts-example/
        http://localhost/<PLUGIN>/SaServletEngine.class/struts-documentation/


*   "<PLUGIN>" represents the plugin you are using for your specific
    webserver.  For apache on Windows, it might be "cgi-bin/SaCGI.exe",
    for IIS on Windows, it might be "scripts/SaCGI.exe" or "scripts/ISAPI.dll".
    Consult the UBS documentation for more information.


JRUN 3.0 SP2A, VERSION 3.02A.11614
----------------------------------
Tested with: Microsoft IIS 5.0, Windows 2000


Important Note:
===============

At the moment, JRun 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 JRun. This 
includes the Struts Example Application. Attempting to run the example 
application will result in an exception similar to the following being 
thrown:

    /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)".

(For more details refer to:

< http://www.mail-archive.com/[e-mail]/msg01860.html >)

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


The following instructions assume the following:

* JRun has been installed and integrated with the web server of choice

* $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)

* $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.

Installing The Struts Example Application
-----------------------------------------

* Login to the JRun Management Console.

* On the left pane, select $APP_SERVER_NAME.  A page showing the
  current server status will be shown on the right pane.

* On the right pane, click on the WAR Deployment link.  A page
  containing a list of the currently deployed web applications will be 
  shown.

* On the right pane, click on Deploy an Application.  Complete the Web 
  Application Information form as follows:
  
    o Servlet War File or Directory:  Enter the full path where
      struts-example.war is found or click on Browse to select 
      the path.
    o JRun Server Name:  $APP_SERVER_NAME
    o Application Name:  Struts Example
    o Application Hosts:  All Hosts
    o Application URL:   /struts-example
    o Application Deploy Directory:  will default to 
      $APP_SERVER_NAME/Struts Example (or the name as specified for 
      Application Name)

* Once the form is complete, click on the Deploy button.

* If deployment is successful, restart the application server by
  clicking on $APP_SERVER_NAME 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.

* Test the sample application by using the following URL in the
  browser:
            http://hostname/struts-example/index.jsp

  The struts-documentation.war can be installed using the same 
  procedure.


Installing Unpacked Web Applications
------------------------------------

The above steps should be followed for applications deployed as *.war files.

For unpacked web applications, configuration involves the following steps:

* From the JRun Management Console, select $APP_SERVER_NAME (on the
  left pane) and click on WAR Deployment (on the right pane)

* On the right pane, click on Create an Application and complete the
  Web Application Information form as follows:

* JRun Server Name:  $APP_SERVER_NAME

  o Application Name:  myApplication
  o Application Hosts:  All Hosts
  o Application URL:   /myApplication
  o Application Deploy Directory:  will default to
    $APP_SERVER_NAME/myApplication

* Click on Create to submit the form.

* Once the web application is created, install and configure the struts
  components (struts.jar, struts*.tld, etc) for the web application under 
  $APP_SERVER_NAME/myApplication/WEB-INF
  
* Install the remaining components of the application:  .class files,
  JSP pages,.properties files etc  as required.

* To configure the extension mapping of the request URI (ie *.do) to
  the action servlet, expand $APP_SERVER_NAME 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:
  
  o Virtual Path/Extension:   *.do
  o Servlet Invoked:  action

* Click on the Update button to save the changes.
* Restart the application server.
* The application should now be accessible from the browser.

The JRun application server will need to be restarted each time one of the
following changes are made to the web application:

* .class or .jar files are modified

* .properties files are modified

* .xml files are modified


Patching The Struts Example Application
---------------------------------------

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:

* index.jsp, logon.jsp: Change <html:html locale="true"> to
                               <html:html locale=<%= true %>>
                               
* registration.jsp, subscription.jsp: Change all instances of 
  filter="true" to filter=<%= true %>
 

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 the <web-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 web site) to include the following
  declarations, after the declaration for the <default-web-app> if any: