husted 01/02/11 13:36:19 Modified: . INSTALL Log: (Submitted by Ted Husted). Update with latest changes to installation.xml Revision Changes Path 1.4 +61 -78 jakarta-struts/INSTALL Index: INSTALL =================================================================== RCS file: /home/cvs/jakarta-struts/INSTALL,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- INSTALL 2001/02/05 18:58:51 1.3 +++ INSTALL 2001/02/11 21:36:19 1.4 @@ -1,4 +1,4 @@ -$Id: INSTALL,v 1.3 2001/02/05 18:58:51 mschachter Exp $ +$Id: INSTALL,v 1.4 2001/02/11 21:36:19 husted Exp $ Struts ====== @@ -7,48 +7,69 @@ 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 2.1+ Standalone - No additional steps required. +* WebLogic 6.0+ - No additional steps required. + +* Bluestone Universal Business Server - 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. + + 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. - * 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. - ORION APPLICATION SERVER ------------------------ @@ -119,44 +140,6 @@ Therefore, you should be sure you do not store sensitive information (such as database passwords) in this file. - - -RESIN STAND-ALONE ------------------ - -* In the steps below, $RESIN_HOME refers to the directory in which you - have installed Resin, and $STRUTS_HOME is the directory in which you - unpacked the Struts binary distribution. - -* These instructions have been tested with the default resin.conf settings - in the 1.2.2 release (16-Jan-2001). - -* Copy the Struts applications (*.war) from $STRUTS_HOME/webapps to your - $RESIN_HOME/webapps directory. - -* Restart Resin if it is already running. - -* You should now be able to access the Struts applications (assuming you are - using Resin's default port number of 8080) at, for example: - - http://localhost:8080/struts-documentation - -* When developing your own applications, you can create a new folder under - $RESIN_HOME/doc and modify the file "$RESIN_HOME/conf/resin.conf" to - recognize your application, for example: - - <web-app id='/struts-myapp' /> - - Resin will then read your application's configuration from WEB-INF/web.xml - - -TOMCAT 3.1 (OR LATER) STAND-ALONE ---------------------------------- - -* Copy "struts-documentation.war" and "struts-example.war" - to your $TOMCAT_HOME/webapps directory - -* Restart Tomcat if it is already running TOMCAT 3.1 (OR LATER) WITH APACHE