RUNNING.txt
上传用户:bj_pst
上传日期:2019-07-07
资源大小:7353k
文件大小:8k
源码类别:

Java编程

开发平台:

Java

  1.   Licensed to the Apache Software Foundation (ASF) under one or more
  2.   contributor license agreements.  See the NOTICE file distributed with
  3.   this work for additional information regarding copyright ownership.
  4.   The ASF licenses this file to You under the Apache License, Version 2.0
  5.   (the "License"); you may not use this file except in compliance with
  6.   the License.  You may obtain a copy of the License at
  7.       http://www.apache.org/licenses/LICENSE-2.0
  8.   Unless required by applicable law or agreed to in writing, software
  9.   distributed under the License is distributed on an "AS IS" BASIS,
  10.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  11.   See the License for the specific language governing permissions and
  12.   limitations under the License.
  13. $Id: RUNNING.txt 609438 2008-01-06 22:14:28Z markt $
  14.                  ============================================
  15.                  Running The Tomcat 5.5 Servlet/JSP Container
  16.                  ============================================
  17. Out of the box, Tomcat 5.5 requires the Java 2 Standard Edition Runtime
  18. Environment (JRE) version 5.0 or later.  However, you can also run Tomcat
  19. 5.5 on earlier versions of the JRE, as detailed below.
  20. =============================
  21. Running With JRE 5.0 Or Later
  22. =============================
  23. (1) Download and Install the J2SE Runtime Environment (JRE)
  24. (1.1) Download the Java 2 Standard Edition Runtime Environment (JRE),
  25.       release version 5.0 or later, from http://java.sun.com/j2se.
  26. (1.2) Install the JRE according to the instructions included with the
  27.       release.
  28. (1.3) Set an environment variable named JRE_HOME to the pathname of
  29.       the directory into which you installed the JRE, e.g. c:jre5.0
  30.       or /usr/local/java/jre5.0.
  31. NOTE: You may also use the full JDK rather than just the JRE. In this
  32.       case set the JAVA_HOME environment variable to the pathname of
  33.       the directory into which you installed the JDK, e.g. c:j2sdk5.0
  34.       or /usr/local/java/j2sdk5.0.
  35. (2) Download and Install the Tomcat Binary Distribution
  36. NOTE:  As an alternative to downloading a binary distribution, you can create
  37. your own from the Tomcat source repository, as described in "BUILDING.txt".
  38. If you do this, the value to use for "${catalina.home}" will be the "dist"
  39. subdirectory of your source distribution.
  40. (2.1) Download a binary distribution of Tomcat from:
  41.       http://tomcat.apache.org
  42. (2.2) Unpack the binary distribution into a convenient location so that the
  43.       distribution resides in its own directory (conventionally named
  44.       "apache-tomcat-[version]").  For the purposes of the remainder of this document,
  45.       the symbolic name "$CATALINA_HOME" is used to refer to the full
  46.       pathname of the release directory.
  47. (3) Start Up Tomcat
  48. (3.1) Tomcat can be started by executing the following commands:
  49.       $CATALINA_HOMEbinstartup.bat          (Windows)
  50.       $CATALINA_HOME/bin/startup.sh           (Unix)
  51. (3.2) After startup, the default web applications included with Tomcat will be
  52.       available by visiting:
  53.       http://localhost:8080/
  54. (3.3) Further information about configuring and running Tomcat can be found in
  55.       the documentation included here, as well as on the Tomcat web site:
  56.       http://tomcat.apache.org
  57. (4) Shut Down Tomcat
  58. (4.1) Tomcat can be shut down by executing the following command:
  59.       $CATALINA_HOMEbinshutdown            (Windows)
  60.       $CATALINA_HOME/bin/shutdown.sh         (Unix)
  61. ====================================
  62. Running Tomcat With J2SE Version 1.4
  63. ====================================
  64. (1) Obtain the compat package:
  65. (1.1) Download the compat package from the binary download site:
  66.       http://tomcat.apache.org
  67.       * Or build this package yourself from the source code: see 
  68.         "BUILDING.txt" in this directory.
  69. (2) Unzip the package in $CATALINA_HOME.  It will place the XML
  70.     parser APIs and Xerces implementation in the common/endorsed
  71.     directory, and the JMX API jar (jmx.jar from Sun) in the bin
  72.     directory.
  73. (3) Follow the same directions for starting and stopping the
  74.     server as if you were using J2SE 5.0.
  75. ==================================================
  76. Advanced Configuration - Multiple Tomcat Instances
  77. ==================================================
  78. In many circumstances, it is desirable to have a single copy of a Tomcat
  79. binary distribution shared among multiple users on the same server.  To make
  80. this possible, you can pass a "-Dcatalina.base=$CATALINA_BASE" argument when
  81. executing the startup command (see (2)). In this
  82. "-Dcatalina.base=$CATALINA_BASE" argument, replace $CATALINA_BASE with the
  83. directory that contains the files for your 'personal' Tomcat instance.
  84. When you use this "-Dcatalina.base=$CATALINA_BASE" argument, Tomcat will
  85. calculate all relative references for files in the following directories based
  86. on the value of $CATALINA_BASE instead of $CATALINA_HOME:
  87. * bin  - Only setenv.sh (*nix) and setenv.bat (windows)
  88. * conf - Server configuration files (including server.xml)
  89. * logs - Log and output files
  90. * shared - For classes and resources that must be shared across all web
  91.            applications
  92. * webapps - Automatically loaded web applications
  93. * work - Temporary working directories for web applications
  94. * temp - Directory used by the JVM for temporary files (java.io.tmpdir)
  95. If you do not pass the "-Dcatalina.base=$CATALINA_BASE" argument to the
  96. startup command, $CATALINA_BASE will default to the same value as $CATALINA_HOME,
  97.  which means that the same directory is used for all relative path resolutions.
  98. The administration and manager web applications, which are defined in the
  99. $CATALINA_BASE/conf/Catalina/localhost/admin.xml
  100. and 
  101. $CATALINA_BASE/conf/Catalina/localhost/manager.xml files, will
  102. not run in that configuration, unless either:
  103. - The path specified in the docBase attribute of the Context element is made
  104.   absolute, and replaced respectively by $CATALINA_HOME/server/webapps/admin
  105.   and $CATALINA_HOME/server/webapps/manager
  106. - Both web applications are copied or moved to $CATALINA_BASE, 
  107.   and the path specified in the docBase attribute of the Context
  108.   element is modified appropriately.
  109. - Both web applications are disabled by removing
  110.   $CATALINA_BASE/conf/Catalina/localhost/admin.xml
  111.   and
  112.   $CATALINA_BASE/conf/Catalina/localhost/manager.xml.
  113. ================
  114. Troubleshooting
  115. ================
  116. There are only really 3 things likely to go wrong during the stand-alone
  117. Tomcat install:
  118. (1) The most common hiccup is when another web server (or any process for that
  119.     matter) has laid claim to port 8080.  This is the default HTTP port that
  120.     Tomcat attempts to bind to at startup.  To change this, open the file:
  121.        $CATALINA_HOME/conf/server.xml
  122.     and search for '8080'.  Change it to a port that isn't in use, and is
  123.     greater than 1024, as ports less than or equal to 1024 require superuser
  124.     access to bind under UNIX.
  125.    Restart Tomcat and you're in business.  Be sure that you replace the "8080"
  126.    in the URL you're using to access Tomcat.  For example, if you change the
  127.    port to 1977, you would request the URL http://localhost:1977/ in your browser.
  128. (2) An "out of environment space" error when running the batch files in
  129.     Windows 95, 98, or ME operating systems.
  130.     Right-click on the STARTUP.BAT and SHUTDOWN.BAT files.  Click on
  131.     "Properties", then on the "Memory" tab.  For the "Initial environment" field,
  132.     enter in something like 4096.
  133.     After you click apply, Windows will create shortcuts which you can use
  134.     to start and stop the container.
  135. (3) The 'localhost' machine isn't found.  This could happen if you're behind a
  136.     proxy.  If that's the case, make sure the proxy configuration for your
  137.     browser knows that you shouldn't be going through the proxy to access the
  138.     "localhost".
  139.     In Netscape, this is under Edit/Preferences -> Advanced/Proxies, and in
  140.     Internet Explorer, Tools -> Internet Options -> Connections -> LAN Settings.