You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by pi...@apache.org on 2001/10/16 00:16:33 UTC
cvs commit: jakarta-tomcat-connectors/webapp/docs build-u.html index.html
pier 01/10/15 15:16:33
Modified: webapp/docs index.html
Added: webapp/docs build-u.html
Log:
Added initial Unix build document.
Updated pointers in the index.
Revision Changes Path
1.3 +10 -5 jakarta-tomcat-connectors/webapp/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-tomcat-connectors/webapp/docs/index.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index.html 2001/10/15 18:28:15 1.2
+++ index.html 2001/10/15 22:16:33 1.3
@@ -1,22 +1,27 @@
<HTML>
<HEAD>
- <TITLE>WebApp Module - Version 1.0</TITLE>
+ <TITLE>WebApp Module</TITLE>
<LINK rel="stylesheet" type="text/css" href="style.css" title="Style">
</HEAD>
<BODY>
<H1>Apache WebApp Module</H1>
<P class="note">
- <EM>Abstract:</EM> This is the abstract
+ This set of documents includes all informations required to obtain, build
+ and install the WebApp module used to connect a web server with the Apache
+ Tomcat 4.x servlet container. For comments or corrections please notify
+ the Tomcat developers mailing list at:<BR>
+ <A href="mailto:tomcat-dev@jakarta.apache.org"><tomcat-dev@jakarta.apache.org></A>.
</P>
<H2>Index:</H2>
<OL>
<LI>
- <A href="build.html">Building and Installing the WebApp module</A>
+ <A href="build-u.html">Building the WebApp module on UNIX platforms</A>
<OL>
- <LI><A href="build.html#download">Downloading the source code</A></LI>
- <LI><A href="build.html#configure">The <CODE>configure</CODE> script</A></LI>
+ <LI><A href="build-u.html#prereq">Prerequisites</A></LI>
+ <LI><A href="build-u.html#download">Obtaining the sources</A></LI>
+ <LI><A href="build-u.html#configure">The <CODE>configure</CODE> script</A></LI>
</OL>
</LI>
<LI>
@@ -35,7 +40,7 @@
Foundation</A> 1999-2001. All Rights Reserved.<BR>
Written by <A href="mailto:pier.fumagalli@sun.com">Pier Fumagalli</A>,
<A href="http://java.sun.com/">Sun Microsystems INC.</A><BR>
- CVS Revision $Id: index.html,v 1.2 2001/10/15 18:28:15 pier Exp $
+ CVS Revision $Id: index.html,v 1.3 2001/10/15 22:16:33 pier Exp $
</P>
</BODY>
</HTML>
1.1 jakarta-tomcat-connectors/webapp/docs/build-u.html
Index: build-u.html
===================================================================
<HTML>
<HEAD>
<TITLE>Building the WebApp module on UNIX platforms</TITLE>
<LINK rel="stylesheet" type="text/css" href="style.css" title="Style">
</HEAD>
<BODY>
<H1>Building the WebApp module</H1>
<P class="note">
Outlined here are the procedures required to build the WebApp module on
UNIX platforms. Please note that due to the difference across the different
UNIX or UNIX-like platforms, some of the steps might be slightly inaccurate
for your specific setup. Please report any inconsistency or error to our
developers mailing list at:<BR>
<A href="mailto:tomcat-dev@jakarta.apache.org"><tomcat-dev@jakarta.apache.org></A>.
</P>
<A name="prereq"><H2>Prerequisites</H2></A>
<P>
There are two major components in the WebApp module: a set of C-language
files containing the web-server side of the module, and a set of Java source
files containing the Tomcat portion of the connector.
</P>
<P>
To compile the C portion of the module, you will need an ANSI-C compliler
(we recommend using GCC the GNU C Compiler) and a make tool (again, the
recommended version is GNU make).
</P>
<P>
The C portion of the container relies on the Apache Portable Runtime
library (APR). If you are compiling the module for a web server different
from Apache HTTPd 2.0, you will need to compile the APR library, and this
requires GNU libtool.
</P>
<P>
If you decide not to download a source distribution, but rely on a CVS
snapshot to build the module, you will also require an M4 macro processor
and GNU autoconf installed.
</P>
<P>
If you decide to compile the Java portion of the connector, you will need
a suitable J2SDK environment (including JAR and JAVAC) and a binary
distribution of Tomcat 4.x.
</P>
<P>
The API documentation gets automatically generated from the Java and C source
files. To build those you will require JAVADOC (from your J2SDK environment)
for the Java portion and PERL 5.0 or later for the C portion.
</P>
<A name="download"><H2>Obtaining the sources</H2></A>
<P>
You can obtain the sources of the WebApp module from a source distribution
which can be obtained from our main distribution site
<A href="http://jakarta.apache.org/builds/jakarta-tomcat-4.0/"><http://jakarta.apache.org/builds/jakarta-tomcat-4.0/></A>
or from our CVS server.
</P>
<P>
To obtain a copy of the sources from CVS, you will have to download two of
our CVS repositories: the <EM>Apache Portable Runtime</EM> <CODE>apr</CODE>
repository and the <EM>WebApp Module</EM>
<CODE>jakarta-tomcat-connectors/webapp</CODE> repository. Using CSH, for
example, you will have to do the following:
</P>
<PRE>
# CVSROOT=:pserver:anoncvs@cvs.apache.org:/home/cvspublic
# export CVSROOT
# cvs login
Password: anoncvs
# cvs checkout apr
[...]
# cvs checkout jakarta-tomcat-connectors/webapp
[...]
# mv apr jakarta-tomcat-connectors/webapp
# mv jakarta-tomcat-connectors/webapp webapp
# rmdir jakarta-tomcat-connectors
# cd webapp
# cvs update -Pd
[...]
#</PRE>
<P>
At this point you will have to generate the <CODE>configure</CODE> for both
the WebApp module and APR:
</P>
<PRE>
# cd webapp
# sh ./support/buildconf.sh
[...]
# sh ./apr/buildconf
[...]
#</PRE>
<P>
Analyze any error messages that might be generated during this phase, APR
has some tight requirements in terms of which version of GNU libtool you
need to have.
</P>
<P>
At this point in the <CODE>webapp</CODE> directory you will have a source
tree comparable to the distributed sources from a tar/zip archive.
</P>
<HR>
<P class="copyright">
Copyright © The <A href="http://www.apache.org/">Apache Software
Foundation</A> 1999-2001. All Rights Reserved.<BR>
Written by <A href="mailto:pier.fumagalli@sun.com">Pier Fumagalli</A>,
<A href="http://java.sun.com/">Sun Microsystems INC.</A><BR>
CVS Revision $Id: build-u.html,v 1.1 2001/10/15 22:16:33 pier Exp $
</P>
</BODY>
</HTML>