forked from apache/tomcat
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathBUILDING.txt
147 lines (99 loc) · 5.06 KB
/
BUILDING.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
================================================================================
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
================================================================================
$Id$
====================================================
Building The Apache Tomcat @VERSION_MAJOR_MINOR@ Servlet/JSP Container
====================================================
This subproject contains the source code for Tomcat @VERSION_MAJOR_MINOR@, a container that
implements the Servlet 3.0 and JSP 2.1 specifications from the Java
Community Process <http://www.jcp.org/>. In order to build a binary
distribution version of the container from a source distribution,
do the following:
(0) Download and Install a Java Development Kit
* If the JDK is already installed, skip to (1).
* Download a Java Development Kit (JDK) release (version 1.6.x or later) from:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
* 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) Install Apache Ant 1.8.x on your computer
* If Apache Ant 1.8.x is already installed on your computer, skip to (2).
* Download a binary distribution of Ant 1.8.x from:
http://ant.apache.org/bindownload.cgi
* Unpack the binary distribution into a convenient location so that the
Ant release resides in its own directory (conventionally named
"apache-ant-[version]"). For the purposes of the remainder of this document,
the symbolic name "${ant.home}" is used to refer to the full pathname of
the release directory.
* Create an ANT_HOME environment variable to point the directory
${ant.home}.
* Modify the PATH environment variable to include the directory
${ant.home}/bin in its list. This makes the "ant" command line script
available, which will be used to actually perform the build.
(2) Building Tomcat @VERSION_MAJOR_MINOR@
(2.1) Checkout or obtain the source code for Tomcat @VERSION_MAJOR_MINOR@
* Tomcat SVN repository URL:
http://svn.apache.org/repos/asf/tomcat/tc@[email protected]/
* Download a source package from:
http://tomcat.apache.org/download-@[email protected]
* Checkout the source using SVN, selecting the desired version or
branch (current development source is at
http://svn.apache.org/repos/asf/tomcat/tc@[email protected]/trunk/), or
unpack the source package. The location where the source has been
placed will be referred as ${tomcat.source}.
(2.2) Building
* Go to that directory, and do:
cd ${tomcat.source}
ant
* NOTE: Users accessing the Internet through a proxy must use a properties
file to indicate to Ant the proxy configuration. Read below.
* WARNING: Running this command will download binaries to the /usr/share/java
directory. On a typical Linux or MacOX system an ordinary user
will not have access to write to this directory, and, even if you do,
it may not be appropriate for you to write there.
On Windows this usually corresponds to the "C:\usr\share\java"
directory, unless Cygwin is used. Read the next section to learn how
to customize the directory used to download the binaries.
* The build can be controlled by creating a ${tomcat.source}/build.properties
file, and adding the following content to it:
# ----- Proxy setup -----
# Uncomment if using a proxy server
#proxy.host=proxy.domain
#proxy.port=8080
#proxy.use=on
# ----- Default Base Path for Dependent Packages -----
# Replace this path with the directory path where dependencies binaries
# should be downloaded
base.path=/home/me/some-place-to-download-to
(3) Updating sources
It is recommended that you regularly update the downloaded Tomcat @VERSION_MAJOR_MINOR@ sources
using your SVN client.
(4) Rebuilds
For a quick rebuild of only modified code you can use:
cd ${tomcat.source}
ant
(5) Building the servlet and jsp API documentation
The documentation can be easly built:
cd ${tomcat.source}
ant javadoc
(6) Building the extras (commons-logging, webservices etc.).
cd ${tomcat.source}
ant extras
(7) Building the embedded packages.
cd ${tomcat.source}
ant embed
(8) Building a full release (as provided via the ASF download pages):
cd ${tomcat.source}
ant release