larryi 01/06/20 21:51:33
Modified: . README
Log:
Update for Milestone 4.
Updated build instructions to address new dependencies on other projects.
As a result of these dependencies, the base directory name from expanded
source archives will have to be renamed to match the module's checkout
name.
Revision Changes Path
1.16 +46 -29 jakarta-tomcat/README
Index: README
===================================================================
RCS file: /home/cvs/jakarta-tomcat/README,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- README 2001/05/15 13:04:28 1.15
+++ README 2001/06/21 04:51:32 1.16
@@ -16,16 +16,17 @@
all of the required distributions.
* Download and install a version 1.1 or later Java Development Kit
- implementation for your operating system platform. Set a "JAVA_HOME"
- environment variable to point at the directory where your JDK is installed,
- and add "$JAVA_HOME/bin" ("%JAVA_HOME%\bin" for Windows) to your PATH.
- Configure the CLASSPATH environment variable as well, if required.
+ implementation for your operating system platform. JDK 1.2.2 or later
+ is recommended. Set a "JAVA_HOME" environment variable to point at the
+ directory where your JDK is installed, and add "$JAVA_HOME/bin"
+ ("%JAVA_HOME%\bin" for Windows) to your PATH. Configure the CLASSPATH
+ environment variable as well, if required.
* Download the Ant version 1.3 binary distribution from
<http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/bin> and install
it in the $JAKARTA_HOME directory. Set an "ANT_HOME" environment variable
to point to $JAKARTA_HOME/jakarta-ant-1.3. If you are using Windows 9x,
- you should set ANT_HOME using DOS 8.3 names. Also, add "$ANT_HOME/bin"
+ you should set ANT_HOME using the DOS 8.3 name. Also, add "$ANT_HOME/bin"
(%ANT_HOME%/bin for Windows) to your PATH.
* Download JAXP version 1.0.1 from <http://java.sun.com/xml> and install it
@@ -35,26 +36,42 @@
Extension (JSSE) implementation (current version number is 1.0.2) from
<http://java.sun.com/products/jsse> and install it into $JAKARTA_HOME.
-* Download the source distribution archive of Tomcat 3.3 and expand it
- in the $JAKARTA_HOME directory. It will expand using a base directory named
- "jakarta-tomcat-3.3", or something similar indicating the release. If a
- different directory is used, substitute its name for "jakarta-tomcat-3.3"
- in the commands below. You can now build an "unpacked" version of Tomcat
- (builds quicker because no time is spent JARing up results) by executing
- the following commands:
+* Obtain the following source distributions either from anonymous CVS (see
+ <http://jakarta.apache.org/site/cvsindex.html> for details) or by
+ downloading the appropriate source archives from the Jakarta site
+ (see <http://jakarta.apache.org/site/sourceindex.html>):
+
+ jakarta-tomcat
+ jakarta-tomcat-connectors
+ jakarta-tomcat-jasper
+
+ If you download source archives, you will need to expand them and rename
+ the resulting directories to match the following build directory structure.
+ JAXP and JSSE are shown below as well.
+
+ <$JAKARTA_HOME>
+ jakarta-tomcat
+ jakarta-tomcat-connectors
+ jakarta-tomcat-jasper
+ jaxp1.0.1
+ jsse1.0.2 optional
+
- cd $JAKARTA_HOME/jakarta-tomcat-3.3
+* You can now build an "unpacked" version of Tomcat (builds quicker because
+ no time is spent JARing up results) by executing the following commands:
+
+ cd $JAKARTA_HOME/jakarta-tomcat
ant
This version can be executed as follows:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/build/tomcat
+ cd $JAKARTA_HOME/jakarta-tomcat/build/tomcat
./bin/startup.sh <-- Unix
bin\startup <-- Windows
and it can be shut down as follows:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/build/tomcat
+ cd $JAKARTA_HOME/jakarta-tomcat/build/tomcat
./bin/shutdown.sh <-- Unix
bin\shutdown <-- Windows
@@ -64,7 +81,7 @@
ant dist
This will create a binary distribution in
- "$JAKARTA_HOME/jakarta-tomcat-3.3/dist/tomcat" that is equivalent
+ "$JAKARTA_HOME/jakarta-tomcat/dist/tomcat" that is equivalent
(in file arrangement) to the binary distribution releases of Tomcat 3.3
that can be downloaded from the Jakarta web site at
<http://jakarta.apache.org/site/binindex.html>.
@@ -72,7 +89,7 @@
* You can delete the generated files in the "build/tomcat" and "dist/tomcat"
directories by executing the following:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3
+ cd $JAKARTA_HOME/jakarta-tomcat
ant clean
@@ -83,7 +100,7 @@
* To start Tomcat, execute the following commands:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/build/tomcat
+ cd $JAKARTA_HOME/jakarta-tomcat/build/tomcat
./bin/startup.sh <-- Unix
bin\startup <-- Windows
@@ -93,7 +110,7 @@
* To stop Tomcat, execute the following commands:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/build/tomcat
+ cd $JAKARTA_HOME/jakarta-tomcat/build/tomcat
./bin/shutdown.sh <-- Unix
bin\shutdown <-- Windows
@@ -101,7 +118,7 @@
* To start Tomcat, execute the following commands:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/dist/tomcat
+ cd $JAKARTA_HOME/jakarta-tomcat/dist/tomcat
./bin/startup.sh <-- Unix
bin\startup <-- Windows
@@ -111,15 +128,15 @@
* To stop Tomcat, execute the following commands:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/dist/tomcat
+ cd $JAKARTA_HOME/jakarta-tomcat/dist/tomcat
./bin/shutdown.sh <-- Unix
bin\shutdown <-- Windows
Alternatively, you can run Tomcat without changing your current working
directory, by setting the TOMCAT_HOME environment variable to point at the
Tomcat files you have built (for example, at directory
-"$JAKARTA_HOME/jakarta-tomcat-3.3/build/tomcat" or
-"$JAKARTA_HOME/jakarta-tomcat-3.3/dist/tomcat"). Now, you can start Tomcat
+"$JAKARTA_HOME/jakarta-tomcat/build/tomcat" or
+"$JAKARTA_HOME/jakarta-tomcat/dist/tomcat"). Now, you can start Tomcat
as follows:
$TOMCAT_HOME/bin/startup.sh <-- Unix
@@ -134,7 +151,7 @@
XML Parsing specification. Parsers known to successfully run Tomcat include:
* The JAXP reference implementation (version 1.0 or later), which can be
- downloaded from <http://java.sun.com/xml>. JAXP version 1.0.1 is
+ downloaded from <http://java.sun.com/xml>. JAXP version 1.1 is
included in the Tomcat binary distribution.
* The Xerces parser (version 1.1.2 or later), which can be downloaded
@@ -150,21 +167,21 @@
default. To add the "test" web application to your "unpackaged" build,
execute:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3
+ cd $JAKARTA_HOME/jakarta-tomcat
ant sanity-test
To add the "test" web application to the distribution build, execute:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3
+ cd $JAKARTA_HOME/jakarta-tomcat
ant test.war
Before you can run the test, you must set the Admin web application to
"trusted". This can be accomplished by executing the following:
- cd $JAKARTA_HOME/jakarta-tomcat-3.3/build/tomcat <-- Unix
+ cd $JAKARTA_HOME/jakarta-tomcat/build/tomcat <-- Unix
./bin/tomcat.sh run -enableAdmin
- cd %JAKARTA_HOME%\jakarta-tomcat-3.3\build\tomcat <-- Windows
+ cd %JAKARTA_HOME%\jakarta-tomcat\build\tomcat <-- Windows
bin\tomcat run -enableAdmin
Next, start Tomcat with:
@@ -181,7 +198,7 @@
completed, the results will appear with "FAILED Tests" listed first,
followed the "PASSED Tests". This same procedure will also work with the
binary distribution which is created in
-"$JAKARTA_HOME/jakarta-tomcat-3.3/dist/tomcat".
+"$JAKARTA_HOME/jakarta-tomcat/dist/tomcat".
For security reasons, after you are done with the test, you should either
restore the Admin web application to the default "untrusted" state, or change
