markt 2004/06/18 11:28:15
Modified: . BUILDING.txt
Log:
Fix bug 19869. Update to reflect a number of changes:
- Use 4.x rather than 4.0
- Update library versions to agree with build.properties.default
- Add missing libraries
- Add steps to build installer and release distributions
Revision Changes Path
1.34 +126 -62 jakarta-tomcat-4.0/BUILDING.txt
Index: BUILDING.txt
===================================================================
RCS file: /home/cvs/jakarta-tomcat-4.0/BUILDING.txt,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- BUILDING.txt 29 Jul 2002 19:06:09 -0000 1.33
+++ BUILDING.txt 18 Jun 2004 18:28:15 -0000 1.34
@@ -1,10 +1,10 @@
$Id$
- Building The Tomcat 4.0 Servlet/JSP Container
+ Building The Tomcat 4.x Servlet/JSP Container
=============================================
-This subproject contains the source code Tomcat 4.0, a server that implements
+This subproject contains the source code Tomcat 4.x, a server that implements
the Servlet 2.3 and JSP 1.2 Specifications from Java Software. In order to
build a binary distribution version of the container from a source
distribution, you must have a Java Development Kit (JDK) for version 1.3 (or
@@ -26,12 +26,12 @@
(1) Download and Install the Ant Binary Distribution
-NOTE: Previous versions of Tomcat 4.0 relied on Ant 1.3 for the build
+NOTE: Previous versions of Tomcat 4.x relied on Ant 1.3 for the build
process. The 1.5 release is now required.
-* Download a binary distribution of Ant 1.5 from:
+* Download a binary distribution of Ant 1.5 or later from:
- http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/bin/
+ http://archive.apache.org/dist/ant/binaries/
On a Windows platform, you will need:
jakarta-ant-1.5-bin.zip
@@ -93,7 +93,7 @@
http://xml.apache.org/dist/xerces-j/
- (Tomcat was tested with "Xerces-J-bin.1.4.3.zip")
+ (Tomcat was tested with "Xerces-J-bin.2.5.0.zip")
* Unpack the binary distribution into a convenient location so that the
distribution resides in its own directory (conventionally named
@@ -116,19 +116,14 @@
(5) Download and Install Subproject Source Code
* Use Anonymous CVS (as described on the Jakarta web site at
- <http://jakarta.apache.org/site/cvsindex.html>, or
- download a source distribution from:
-
- http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/src/
+ http://jakarta.apache.org/site/cvsindex.html>) to obtain the
+ "jakarta-tomcat-4.0" repository.
- On a Windows platform, you will need:
- jakarta-tomcat-4.0-src-YYYYMMDD.zip
+ NOTE 1: Nightly builds and source distributions are no longer
+ produced for tomcat 4.x
- On a Unix platform, you will need:
- jakarta-tomcat-4.0-src-YYYYMMDD.tar.gz
-
- (NOTE: Alternatively, you can grab the source distribution from a
- formal release, if you wish, by following links on the Jakarta web site).
+ NOTE 2: Alternatively, you can grab the source distribution from a
+ formal release, if you wish, by following links on the Jakarta web site.
* Unpack the source distribution into a convenient location so that the
distribution resides in its own directory (conventionally named
@@ -145,7 +140,18 @@
"jakarta-tomcat-connectors"). By default, the build system will try to find
this repository in the "${tomcat.source}/../jakarta-tomcat-connectors"
directory. Set the "jtc.home" property in the build.properties file
- described below (see 26) if it resides in a different directory.
+ described below (see 27) if it resides in a different directory.
+
+* Use Anonymous CVS (as described on the Jakarta web site at
+ <http://jakarta.apache.org/site/cvsindex.html>, or
+ download a source distribution of the "jakarta-tomcat-jasper" repository.
+
+* Unpack the source distribution into a convenient location so that the
+ distribution resides in its own directory (conventionally named
+ "jakarta-tomcat-jasper"). By default, the build system will try to find
+ this repository in the "${tomcat.source}/../jakarta-tomcat-jasper"
+ directory. Set the "jasper.home" property in the build.properties file
+ described below (see 27) if it resides in a different directory.
(6) Download and Install the Servlet API Binary Distribution
@@ -153,7 +159,7 @@
NOTE: Alternatively, you can download the sources of the
"jakarta-servletapi-4" subproject, and build a binary distribution yourself,
or use the binary distribution that is available with binary distributions
-of Tomcat 4.0.
+of Tomcat 4.x.
* Download a binary distribution from:
@@ -173,7 +179,7 @@
* Download a binary distribution of Version 1.1 or later from:
- http://jakarta.apache.org/builds/jakarta-commons/release/commons-beanutils
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
commons-beanutils-X.Y.zip
@@ -189,7 +195,7 @@
* Download a binary distribution of Version 1.0 or later from:
- http://jakarta.apache.org/builds/jakarta-commons/release/commons-collections
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
commons-collections-X.Y.zip
@@ -205,7 +211,7 @@
* Download a binary distribution of Version 1.1.1 or later from:
- http://jakarta.apache.org/builds/jakarta-commons/release/commons-digester
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
commons-digester-X.Y.zip
@@ -217,27 +223,43 @@
distribution resides in its own directory.
-(10) Download and Install the Commons Logging Binary Distribution
+(10) Download and Install the Commons FileUpload Binary Distribution
+
+* Download a binary distribution of Version 1.0 or later from:
+
+ http://jakarta.apache.org/site/binindex.cgi
+
+ On a Windows platform, you will need:
+ commons-fileupload-X.Y.zip
+
+ On a Unix platform, you will need:
+ commons-fileupload-X.Y.tar.gz
+
+* Unpack the binary distribution into a convenient location so that the
+ distribution resides in its own directory.
+
+
+(11) Download and Install the Commons Logging Binary Distribution
-* Download a binary distribution (nightly build for now) from:
+* Download a binary distribution Version 1.0.1 or later from:
- http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-logging
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
- commons-logging-YYYYMMDD.zip
+ commons-logging-X.Y.Z.zip
On a Unix platform, you will need:
- commons-logging-YYYYMMDD.tar.gz
+ commons-logging-X.Y.Z.tar.gz
* Unpack the binary distribution into a convenient location so that the
distribution resides in its own directory.
-(11) Download and Install the Regexp Binary Distribution
+(12) Download and Install the Regexp Binary Distribution
* Download a binary distribution of Version 1.2 or later from:
- http://jakarta.apache.org/builds/jakarta-regexp/release/
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
jakarta-regexp-X.Y.zip
@@ -249,14 +271,14 @@
distribution resides in its own directory.
-(12) Steps (13)-(25) are optional, but are necessary to build a complete binary
- distribution of Tomcat 4.0. Set the "full.dist" property to "on" in the
- build.properties file (see step (26)) to build a complete distribution.
+(13) Steps (14)-(26) are optional, but are necessary to build a complete binary
+ distribution of Tomcat 4.x. Set the "full.dist" property to "on" in the
+ build.properties file (see step (27)) to build a complete distribution.
Regular contributors to Tomcat are encouraged to use the complete build
option.
-(13) Download and Install JDBC Optional Package API Binary Distribution
+(14) Download and Install JDBC Optional Package API Binary Distribution
* Download the JDBC Optional Pacakge API package (version 2.0) from:
@@ -265,7 +287,7 @@
* Place the jar in a convenient location.
-(14) Download and Install an implementation of the JMX 1.0 specification. This
+(15) Download and Install an implementation of the JMX 1.0 specification. This
can be either MX4J (http://mx4j.sourceforge.net) or Sun JMX 1.0 Reference
Implementation.
@@ -286,7 +308,7 @@
* Unpack MX4J or the reference implementation into a convenient location
so that it resides in its own subdirectory.
-(15) Download and Install the Java Activation Framework 1.0.1
+(16) Download and Install the Java Activation Framework 1.0.1
* Download the Java Activation Framework package (version 1.0.1 or later) from
@@ -296,7 +318,7 @@
resides in its own subdirectory.
-(16) Download and Install JavaMail 1.2
+(17) Download and Install JavaMail 1.2
* Download the JavaMail package (version 1.2 or later) from
@@ -306,7 +328,7 @@
it resides in its own subdirectory.
-(17) Download and Install the JSSE 1.0.2 Reference Implementation
+(18) Download and Install the JSSE 1.0.2 Reference Implementation
* Download the Java Secure Sockets Extension (JSSE) package,
(version 1.0.2 or later) from
@@ -316,8 +338,10 @@
* Unpack the reference implementation into a convenient location so that
it resides in its own subdirectory.
+* This is optional with JDK 1.4 or later.
+
-(18) Download and Install the Java Transaction APIs
+(19) Download and Install the Java Transaction APIs
* Download the Java Transaction API (JTA) package (version 1.0.1) from:
@@ -327,11 +351,11 @@
own subdirectory.
-(19) Download and Install the Struts Binary Distribution
+(20) Download and Install the Struts Binary Distribution
* Download a binary distribution of Struts 1.0.1 from:
- http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.1/
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
jakarta-struts-1.0.1.zip
@@ -343,23 +367,23 @@
distribution resides in its own directory.
-(20) Download and Install the Tyrex Data Source Package
+(21) Download and Install the Tyrex Data Source Package
NOTE: This step is only required if you wish to build the Tyrex connection
pool implementation for JNDI-accessed data sources.
* Download the Tyrex JAR or release (version 1.0) from:
- http://tyrex.exolab.org/download.html
+ http://tyrex.sourceforge.net/download.html
* Unpack the package into a convenient location so that it resides in its
own subdirectory.
-(21) Download and Install the JUnit Testing Package (OPTIONAL)
+(22) Download and Install the JUnit Testing Package (OPTIONAL)
NOTE: This step is only required if you wish to build and execute the unit
-tests that are part of the Tomcat 4.0 source base.
+tests that are part of the Tomcat 4.x source base.
* Download the JUnit unit test package (version 3.7 or later) from:
@@ -369,45 +393,45 @@
own subdirectory.
-(22) Download and Install the Commons Modeler Binary Distribution
+(23) Download and Install the Commons Modeler Binary Distribution
NOTE: This step is only required if you wish to build the Config/Admin
web application.
-* Download a binary distribution of version 20020117 or later from:
+* Download a binary distribution of version 1.1 or later from:
- http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-modeler
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
- commons-modeler-YYYYMMDD.zip
+ commons-modeler-X.Y.zip
On a Unix platform, you will need:
- commons-modeler-YYYYMMDD.tar.gz
+ commons-modeler-X.Y.tar.gz
* Unpack the binary distribution into a convenient location so that the
distribution resides in its own directory.
-(23) Download and Install the Commons DBCP Binary Distribution
+(24) Download and Install the Commons DBCP Binary Distribution
NOTE: This step is only required if you wish to use the database JDBC data
source factory.
-* Download a binary distribution of version 20011030 or later from:
+* Download a binary distribution of version 1.0 or later from:
- http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-dbcp
+ http://jakarta.apache.org/site/binindex.cgi
On a Windows platform, you will need:
- commons-dbcp-YYYYMMDD.zip
+ commons-dbcp-X.Y.zip
On a Unix platform, you will need:
- commons-dbcp-YYYYMMDD.tar.gz
+ commons-dbcp-X.Y.tar.gz
* Unpack the binary distribution into a convenient location so that the
distribution resides in its own directory.
-(24) Download and Install the Commons Pool Binary Distribution
+(25) Download and Install the Commons Pool Binary Distribution
NOTE: This step is only required if you wish to use the database JDBC data
source factory.
@@ -426,26 +450,26 @@
distribution resides in its own directory.
-(25) Download and Install the Commons Daemon Binary Distribution
+(26) Download and Install the Commons Daemon Binary Distribution
NOTE: This step is only required if you wish to build the classes needed to
run Tomcat as a native operating system daemon using commons-daemon.
-* Download a binary distribution of version 20020730 or later from:
+* Download a binary distribution of version 1.0-Alpha or later from:
http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-daemon
On a Windows platform, you will need:
- commons-daemon-YYYYMMDD.zip
+ commons-daemon-1.0-Alpha.zip
On a Unix platform, you will need:
- commons-daemon-YYYYMMDD.tar.gz
+ commons-daemon-1.0-Alpha.tar.gz
* Unpack the binary distribution into a convenient location so that the
distribution resides in its own directory.
-(26) Customize Build Properties For This Subproject
+(27) Customize Build Properties For This Subproject
Most Jakarta subprojects allow you to customize Ant properties (with default
values defined in the "build.xml" file. This is done by creating a text file
@@ -469,7 +493,7 @@
each developer will have their own version.
-(27) Build A Binary Distribution
+(28) Build A Binary Distribution
Open a command line shell, and issue the following commands:
@@ -498,3 +522,43 @@
See the document RUNNING.txt for instructions on how to start up and shut down
the servlet/JSP container.
+
+
+(29) Steps (30) to (32) Build the Windows Installer Distribution - OPTIONAL
+
+(30) NSIS
+
+* Download the NSIS Installer version 2.0 from:
+
+ http://prdownloads.sourceforge.net/nsis/nsis20.exe?download
+
+* Install the application into a convenient location so that it resides in its
+ own subdirectory.
+
+
+(31) JavaService
+
+* Download the JavaService package (version 1.2.0 or later) from:
+
+ http://www.alexandriasc.com/software/JavaService/JavaService-bin-1.2.0.zip
+
+* Install the application into a convenient location so that it resides in its
+ own subdirectory.
+
+
+(32) Run Ant
+
+Open a command line shell, and issue the following commands:
+
+ cd ${tomcat.source}
+ ant installer
+
+
+
+(33) Build the release distribution - OPTIONAL
+
+Open a command line shell, and issue the following commands:
+
+ cd ${tomcat.source}
+ ant release
+
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
