Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm
Date: 16 Oct 1999 03:09:29 -0000
Message-ID: <19991016030929.12259.qmail@hyperreal.org>
From: bergsten@hyperreal.org
To: jakarta-tomcat-cvs@apache.org
Subject: cvs commit: jakarta-tomcat/src/etc faq readme

bergsten    99/10/15 20:09:29

  Modified:    src/etc  faq readme
  Log:
  Added info about problem serving files on Windows, replaced JSWD with Tomcat and updated with the new script names
  
  Revision  Changes    Path
  1.2       +23 -7     jakarta-tomcat/src/etc/faq
  
  Index: faq
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat/src/etc/faq,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- faq	1999/10/09 00:19:58	1.1
  +++ faq	1999/10/16 03:09:27	1.2
  @@ -1,17 +1,33 @@
  -Some Frequently Asked Questions (FAQ) on JSWDK
  +Some Frequently Asked Questions (FAQ) on Tomcat
   ----------------------------------------------
   
   Q: I am getting a 404 Error, what does it mean?
   
   A: In simple terms, it means the server was not able to locate 
  -   the resource you requested. This can occur because of two 
  +   the resource you requested. This can occur because of four 
      reasons:
   
  -   One, the URL you typed was wrong or has a typo.
  -   And two, the URL you requested could not be resolved with 
  -   the current "docsBase". If you are trying to run your own 
  -   "web-application" please read  the questions related to 
  -   "installing your own web-application" in this FAQ.
  +   * One, the URL you typed was wrong or has a typo.
  +   * Two, the URL you requested could not be resolved with 
  +     the current "docsBase". If you are trying to run your own 
  +     "web-application" please read  the questions related to 
  +     "installing your own web-application" in this FAQ.
  +   * Three, you're using JDK 1.1.x on a Windows platform. It's
  +     a known bug (see Readme) that the server doesn't serve files
  +     in this configuration. Use JDK 1.2.x instead.
  +   * And four, on a Windows platform you have installed Tomcat in
  +     a directory with a path part longer than 8 characters, e.g.
  +     C:\Program Files\jakarta, and run the "startup" script from
  +     a command tool after you have cd'd to the directory using
  +     the short form of the name, e.g.
  +
  +      > cd C:\Progra~1\jakarta
  +      > startup
  +
  +     If you cd using the long name it works fine, e.g.
  +
  +      > cd "C:\Program Files\jakarta"
  +      > startup
   
   Q: I am getting a 500 Error, what does it mean?
   
  
  
  
  1.3       +10 -7     jakarta-tomcat/src/etc/readme
  
  Index: readme
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat/src/etc/readme,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- readme	1999/10/15 09:02:49	1.2
  +++ readme	1999/10/16 03:09:28	1.3
  @@ -1,4 +1,4 @@
  -$Id: readme,v 1.2 1999/10/15 09:02:49 duncan Exp $
  +$Id: readme,v 1.3 1999/10/16 03:09:28 bergsten Exp $
   	
   Tomcat 2.2 (development version)
   
  @@ -26,17 +26,17 @@
   
   If you are using JDK 1.2, tools.jar (which can be found in
   /path/to/jdk1.2/lib/tools.jar) needs to be in your
  -CLASSPATH. Tools.jar contains "javac" which is used by the JSP engine
  +CLASSPATH. tools.jar contains "javac" which is used by the JSP engine
   to compile the servlets generated from .jsp's.
   
   There is a Unix based Korn Shell Script and a Windows based Batch File
  -provided in the installation directory. To startup the server on Unix:
  +provided in the installation directory. To start up the server on Unix:
   
  -     % startserver
  +     % startup.sh
   
   To start up the server on Windows
   
  -     C:\jswdk\> startserver
  +     C:\tomcat\> startup
   
   Once the server is running, you can use any web browser to browse
   
  @@ -48,8 +48,8 @@
   
   To stop the server, use the following commands:
   
  -    Unix: 		% stopserver
  -    Windows: 		> stopserver
  +    Unix: 		% shutdown.sh
  +    Windows: 		> shutdown
   
   KNOWN BUGS AND ISSUES
   ---------------------
  @@ -67,6 +67,9 @@
      .jar file that contains .class files for all user-defined tags and
      the tag library descriptor in the META-INF directory -
      META-INF/taglib.tld. 
  +
  +5. The server can not serve static files on a Windows platform if
  +   you use JDK 1.1.x. Use JDK 1.2.x instead.
   
   
   TROUBLESHOOTING