cvs commit: jakarta-tomcat-5 RUNNING.txt
remm2005/08/10 09:00:05 Modified:.RUNNING.txt Log: - Fix JDK requirements. Revision ChangesPath 1.10 +6 -6 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- RUNNING.txt 3 Sep 2004 17:50:34 - 1.9 +++ RUNNING.txt 10 Aug 2005 16:00:05 - 1.10 @@ -72,9 +72,9 @@ -=== -Running Tomcat With J2SE Version 1.4 or 1.3 -=== + +Running Tomcat With J2SE Version 1.4 + (1) Obtain the compat package: @@ -93,9 +93,9 @@ server as if you were using J2SE 5.0. - +== Advanced Configuration - Multiple Tomcat Instances - +== In many circumstances, it is desirable to have a single copy of a Tomcat binary distribution shared among multiple users on the same server. To make - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
yoavs 2004/09/03 10:50:34 Modified:.RUNNING.txt Log: Clarified instructions for installaing the compat distribution. Revision ChangesPath 1.9 +5 -3 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- RUNNING.txt 30 Aug 2004 17:27:21 - 1.8 +++ RUNNING.txt 3 Sep 2004 17:50:34 - 1.9 @@ -84,8 +84,10 @@ * Or build this package yourself from the source code: see BUILDING.txt in this directory. -(2) Place the compat package jar in Tomcat's server classpath -by copying it into the $CATALINA_HOME/server/lib directory. +(2) Unzip the package in $CATALINA_HOME. It will place the XML +parser APIs and Xerces implementation in the common/endorsed +directory, and the JMX API jar (jmx.jar from Sun) in the bin +directory. (3) Follow the same directions for starting and stopping the server as if you were using J2SE 5.0. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
markt 2004/06/18 16:32:53 Modified:.RUNNING.txt Log: Fix bug 23203. JDK should be renamed to J2SE SDK. Add note about using SDK rather than JRE. - Patch based on contribution from Glen Mazza - Ported from TC4 Revision ChangesPath 1.7 +11 -5 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- RUNNING.txt 17 Jun 2004 22:28:55 - 1.6 +++ RUNNING.txt 18 Jun 2004 23:32:53 - 1.7 @@ -10,16 +10,22 @@ the following: -(0) Download and Install a Java Development Kit +(0) Download and Install the J2SE Software Development Kit (SDK) -* Download a Java Development Kit (JDK) release (version 1.3 or later) from: +* Download the Java 2 Standard Edition (J2SE) SDK, release version 1.3 or + later, from: http://java.sun.com/j2se/ -* Install the JDK according to the instructions included with the release. +NOTE: Downloading the Java Runtime Environment (JRE) instead is *not* +sufficient for most users because Tomcat uses the javac.exe that is not +present in the JRE to compile JSP pages. Unless you are *very* sure of +what you are doing, please use the full SDK. + +* Install the SDK according to the instructions included with the release. * Set an environment variable JAVA_HOME to the pathname of the directory - into which you installed the JDK release. + into which you installed the SDK release. (1) Download and Install the Tomcat 5 Binary Distribution - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
markt 2004/06/17 15:28:55 Modified:.RUNNING.txt Log: Fix bug 23520. Add shared to list of directories relative to CATALINA_BASE. - Ported from TC4. Revision ChangesPath 1.6 +4 -1 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- RUNNING.txt 11 May 2004 23:45:33 - 1.5 +++ RUNNING.txt 17 Jun 2004 22:28:55 - 1.6 @@ -85,6 +85,9 @@ * logs - Log and output files +* shared - For classes and resources that must be shared across all web + applications + * webapps - Automatically loaded web applications * work - Temporary working directories for web applications - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
funkman 2004/05/11 16:38:37 Modified:.RUNNING.txt Log: BZ 28910 RUNNING.txt has wrong info for admin.xml and manager.xml (documentation) Revision ChangesPath 1.4 +9 -9 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- RUNNING.txt 8 Sep 2003 10:10:23 - 1.3 +++ RUNNING.txt 11 May 2004 23:38:37 - 1.4 @@ -96,12 +96,12 @@ The administration and manager web applications, which are defined in the $CATALINA_BASE/webapps/admin.xml and $CATALINA_BASE/webapps/manager.xml files, will not run in that configuration, unless either: -- The path specified in the docBase attribute of the Context element is made - absolute, and replaced respectively by $CATALINA_HOME/server/webapps/admin +- The path specified in the docBase attribute of the Context element is made + absolute, and replaced respectively by $CATALINA_HOME/server/webapps/admin and $CATALINA_HOME/server/webapps/manager - Both web applications are copied or moved to $CATALINA_BASE, and the path specified in the docBase attribute of the Context element is modified appropriately. -- Both web applications are disabled by removing $CATALINA_BASE/webapps/admin.xml - and $CATALINA_BASE/webapps/manager.xml +- Both web applications are disabled by removing $CATALINA_BASE/conf/Catalina/localhost/admin.xml + and $CATALINA_BASE/conf/Catalina/localhost/manager.xml (5) Troubleshooting: @@ -114,11 +114,11 @@ Tomcat attempts to bind to at startup. To change this, open the file: $CATALINA_HOME/conf/server.xml - + and search for '8080'. Change it to a port that isn't in use, and is greater than 1024, as ports less than or equal to 1024 require superuser access to bind under UNIX. - + Restart Tomcat and you're in business. Be sure that you replace the 8080 in the URL you're using to access Tomcat. For example, if you change the port to 1977, you would request the URL http://localhost:1977/ in your browser. @@ -129,13 +129,13 @@ Right-click on the STARTUP.BAT and SHUTDOWN.BAT files. Click on Properties, then on the Memory tab. For the Initial environment field, enter in something like 4096. - + After you click apply, Windows will create shortcuts which you can use to start and stop the container. 3) The 'localhost' machine isn't found. This could happen if you're behind a proxy. If that's the case, make sure the proxy configuration for your browser knows that you shouldn't be going through the proxy to access the localhost. - + In Netscape, this is under Edit/Preferences - Advanced/Proxies, and in Internet Explorer, Tools - Internet Options - Connections - LAN Settings. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
funkman 2004/05/11 16:45:33 Modified:.RUNNING.txt Log: Also fix previous paragraph for BZ 28910 since it was still out of sync. This paragraph could use a better rewording since system properties can be used in config files. Revision ChangesPath 1.5 +2 -2 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- RUNNING.txt 11 May 2004 23:38:37 - 1.4 +++ RUNNING.txt 11 May 2004 23:45:33 - 1.5 @@ -94,7 +94,7 @@ If you do not pass the -Dcatalina.base=$CATALINA_BASE argument to the startup command, $CATALINA_BASE will default to the same value as $CATALINA_HOME (which means that the same directory is used for all relative path resolutions). The administration and manager web applications, which are defined in the -$CATALINA_BASE/webapps/admin.xml and $CATALINA_BASE/webapps/manager.xml files, will +$CATALINA_BASE/conf/Catalina/localhost/admin.xml and $CATALINA_BASE/conf/Catalina/localhost/manager.xml files, will not run in that configuration, unless either: - The path specified in the docBase attribute of the Context element is made absolute, and replaced respectively by $CATALINA_HOME/server/webapps/admin - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
remm2003/09/08 03:10:23 Modified:.RUNNING.txt Log: - Update running instructions. Revision ChangesPath 1.3 +3 -9 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- RUNNING.txt 25 Jun 2003 02:18:26 - 1.2 +++ RUNNING.txt 8 Sep 2003 10:10:23 - 1.3 @@ -12,7 +12,7 @@ (0) Download and Install a Java Development Kit -* Download a Java Development Kit (JDK) release (version 1.2 or later) from: +* Download a Java Development Kit (JDK) release (version 1.3 or later) from: http://java.sun.com/j2se/ @@ -31,13 +31,7 @@ * Download a binary distribution of Tomcat from: -http://jakarta.apache.org/builds/jakarta-tomcat-5/nightly/ - - On a Windows platform, you will need: -jakarta-tomcat-5-MMDD.zip - - On a Unix platform, you will need: -jakarta-tomcat-5-MMDD.zip +http://jakarta.apache.org/site/binindex.cgi * Unpack the binary distribution into a convenient location so that the distribution resides in its own directory (conventionally named - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-5 RUNNING.txt
yoavs 2003/06/24 19:18:26 Modified:.RUNNING.txt Log: Fixed bug 19910 Revision ChangesPath 1.2 +27 -30jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === RCS file: /home/cvs/jakarta-tomcat-5/RUNNING.txt,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- RUNNING.txt 1 Aug 2002 21:00:18 - 1.1 +++ RUNNING.txt 25 Jun 2003 02:18:26 - 1.2 @@ -6,7 +6,7 @@ This subproject contains Tomcat 5, a server that implements the Servlet 2.4 and JSP 2.0 specifications from the Java Community Process -(http://www.jcp.org). In order to install and run this container, you must do +http://www.jcp.org/. In order to install and run this container, you must do the following: @@ -42,7 +42,7 @@ * Unpack the binary distribution into a convenient location so that the distribution resides in its own directory (conventionally named jakarta-tomcat-5). For the purposes of the remainder of this document, - the symbolic name CATALINA_HOME is used to refer to the full + the symbolic name $CATALINA_HOME is used to refer to the full pathname of the release directory. @@ -50,12 +50,12 @@ Tomcat 5 can be started by executing the following commands: - CATALINA_HOME\bin\startup.bat (Windows) + $CATALINA_HOME\bin\startup.bat (Windows) - CATALINA_HOME/bin/startup.sh (Unix) + $CATALINA_HOME/bin/startup.sh (Unix) After startup, the default web applications included with Tomcat 5 will be -available by browsing: +available by visiting: http://localhost:8080/ @@ -69,23 +69,23 @@ Tomcat 5 can be shut down by executing the following command: - CATALINA_HOME\bin\shutdown(Windows) + $CATALINA_HOME\bin\shutdown(Windows) - CATALINA_HOME/bin/shutdown.sh (Unix) + $CATALINA_HOME/bin/shutdown.sh (Unix) (4) Advanced Configuration - Multiple Tomcat 5 Instances In many circumstances, it is desirable to have a single copy of a Tomcat 5 binary distribution shared among multiple users on the same server. To make -this possible, you must pass a -Dcatalina.base=CATALINA_BASE argument when -executing the to the startup command (see (2)). In this --Dcatalina.base=CATALINA_BASE argument, replace CATALINA_BASE with the -directory that contains the files unique to your Tomcat 5 instance. +this possible, you can pass a -Dcatalina.base=$CATALINA_BASE argument when +executing the startup command (see (2)). In this +-Dcatalina.base=$CATALINA_BASE argument, replace $CATALINA_BASE with the +directory that contains the files for your 'personal' Tomcat 5 instance. -When you use this -Dcatalina.base=CATALINA_BASE argument, Tomcat 5 will +When you use this -Dcatalina.base=$CATALINA_BASE argument, Tomcat 5 will calculate all relative references for files in the following directories based -on the value of CATALINA_BASE instead of CATALINA_HOME: +on the value of $CATALINA_BASE instead of $CATALINA_HOME : * conf - Server configuration files (including server.xml) @@ -97,24 +97,22 @@ * temp - Directory used by the JVM for temporary files (java.io.tmpdir) -If you do not pass the -Dcatalina.base=CATALINA_BASE argument to the startup command, CATALINA_BASE will default to the same value as CATALINA_HOME (which means that the same directory is used for all relative path resolutions). +If you do not pass the -Dcatalina.base=$CATALINA_BASE argument to the startup command, $CATALINA_BASE will default to the same value as $CATALINA_HOME (which means that the same directory is used for all relative path resolutions). The administration and manager web applications, which are defined in the -CATALINA_BASE/webapps/admin.xml and CATALINA_BASE/webapps/manager.xml will +$CATALINA_BASE/webapps/admin.xml and $CATALINA_BASE/webapps/manager.xml files, will not run in that configuration, unless either: - The path specified in the docBase attribute of the Context element is made - absolute, and replaced respectively by CATALINA_HOME/server/webapps/admin - and CATALINA_HOME/server/webapps/manager -- Copying and linking both web applications in CATALINA_BASE, and modify - accordingly the path specified in the docBase attribute of the Context - element -- Disabling both web applications by removing CATALINA_BASE/webapps/admin.xml - and CATALINA_BASE/webapps/manager.xml + absolute, and replaced respectively by $CATALINA_HOME/server/webapps/admin + and $CATALINA_HOME/server/webapps/manager +- Both web applications are copied or moved to $CATALINA_BASE, and the path specified in the docBase attribute of the Context element is modified
cvs commit: jakarta-tomcat-5 RUNNING.txt build.xml
patrickl2002/08/01 14:00:18 Modified:.build.xml Added: .RUNNING.txt Log: Added initial startup and shutdown instructions. Still need to enumerate the various -Dname=value arguments that can be used with the Launcher-based scripts. However, I have included the -Dcatalina.base=... argument in the instructions. Revision ChangesPath 1.16 +5 -0 jakarta-tomcat-5/build.xml Index: build.xml === RCS file: /home/cvs/jakarta-tomcat-5/build.xml,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- build.xml 1 Aug 2002 14:30:36 - 1.15 +++ build.xml 1 Aug 2002 21:00:18 - 1.16 @@ -86,6 +86,11 @@ property name=catalina.home value=${tomcat.build}/ /ant +!-- Correct permissions and line endings on bin scripts -- +fixcrlf srcdir=${tomcat.build}/bin includes=*.sh eol=lf/ +fixcrlf srcdir=${tomcat.build}/bin includes=*.bat eol=crlf/ +chmod dir=${tomcat.build}/bin includes=*.sh perm=+x/ + /target 1.1 jakarta-tomcat-5/RUNNING.txt Index: RUNNING.txt === $Id: RUNNING.txt,v 1.1 2002/08/01 21:00:18 patrickl Exp $ Running The Tomcat 5 Servlet/JSP Container == This subproject contains Tomcat 5, a server that implements the Servlet 2.4 and JSP 2.0 specifications from the Java Community Process (http://www.jcp.org). In order to install and run this container, you must do the following: (0) Download and Install a Java Development Kit * Download a Java Development Kit (JDK) release (version 1.2 or later) from: http://java.sun.com/j2se/ * Install the JDK according to the instructions included with the release. * Set an environment variable JAVA_HOME to the pathname of the directory into which you installed the JDK release. (1) Download and Install the Tomcat 5 Binary Distribution NOTE: As an alternative to downloading a binary distribution, you can create your own from the Tomcat source repository, as described in BUILDING.txt. If you do this, the value to use for ${catalina.home} will be the dist subdirectory of your source distribution. * Download a binary distribution of Tomcat from: http://jakarta.apache.org/builds/jakarta-tomcat-5/nightly/ On a Windows platform, you will need: jakarta-tomcat-5-MMDD.zip On a Unix platform, you will need: jakarta-tomcat-5-MMDD.zip * Unpack the binary distribution into a convenient location so that the distribution resides in its own directory (conventionally named jakarta-tomcat-5). For the purposes of the remainder of this document, the symbolic name CATALINA_HOME is used to refer to the full pathname of the release directory. (2) Start Up Tomcat 5 Tomcat 5 can be started by executing the following commands: CATALINA_HOME\bin\startup.bat (Windows) CATALINA_HOME/bin/startup.sh (Unix) After startup, the default web applications included with Tomcat 5 will be available by browsing: http://localhost:8080/ Further information about configuring and running Tomcat 5 can be found in the documentation included here, as well as on the Tomcat web site: http://jakarta.apache.org/tomcat/ (3) Shut Down Tomcat 5 Tomcat 5 can be shut down by executing the following command: CATALINA_HOME\bin\shutdown(Windows) CATALINA_HOME/bin/shutdown.sh (Unix) (4) Advanced Configuration - Multiple Tomcat 5 Instances In many circumstances, it is desirable to have a single copy of a Tomcat 5 binary distribution shared among multiple users on the same server. To make this possible, you must pass a -Dcatalina.base=CATALINA_BASE argument when executing the to the startup command (see (2)). In this -Dcatalina.base=CATALINA_BASE argument, replace CATALINA_BASE with the directory that contains the files unique to your Tomcat 5 instance. When you use this -Dcatalina.base=CATALINA_BASE argument, Tomcat 5 will calculate all relative references for files in the following directories based on the value of CATALINA_BASE instead of CATALINA_HOME: * conf - Server configuration files (including server.xml) * logs - Log and output files * webapps - Automatically loaded web applications * work - Temporary working directories for web applications * temp - Directory used by the JVM for temporary files (java.io.tmpdir) If you do not pass the -Dcatalina.base=CATALINA_BASE argument to the startup command, CATALINA_BASE will default to the same value as CATALINA_HOME (which