struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: jakarta-struts INSTALL
Date Tue, 13 Feb 2001 17:11:35 GMT
husted      01/02/13 09:11:35

  Modified:    .        INSTALL
  (Submitted by Ted Husted.) Add JRUN to installation guide, contributed by Eric Wu.
  Revision  Changes    Path
  1.6       +164 -2    jakarta-struts/INSTALL
  Index: INSTALL
  RCS file: /home/cvs/jakarta-struts/INSTALL,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- INSTALL	2001/02/13 16:01:38	1.5
  +++ INSTALL	2001/02/13 17:11:34	1.6
  @@ -1,4 +1,4 @@
  -$Id: INSTALL,v 1.5 2001/02/13 16:01:38 husted Exp $
  +$Id: INSTALL,v 1.6 2001/02/13 17:11:34 husted Exp $
  @@ -21,11 +21,11 @@
   * 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.
  -* JRUN - Determination pending.
   * Websphere - Determination pending.
  @@ -70,6 +70,168 @@
       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
  +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 
  +    /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/

  +    Error: No match was found for method "setLocale(java.lang.String)".
  +(For more details refer to:
  +< >)
  +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 %>

View raw message