]> &project; Remy Maucherat Building Tomcat Tomcat のビルド 高橋達男 田中良浩

Building Tomcat from CVS is very easy, and is the first step to contributing to Tomcat. The following is a step by step TODO list.

CVS から Tomcat をビルドするのは非常に簡単で、Tomcat に貢献していただくための 最初のステップです。ステップごとの手順を以下に示します。

Ealier releases would also work, but are harder to work with due to the need to download additional dependencies. Tomcat also runs much faster on the latest 1.4 JDK.

JDK 1.4.x より前のリリースでも動作しますが、 依存ライブラリのダウンロードが追加で必要なので手間がかかります。 また、Tomcat の動作は最新の JDK 1.4 の方がずっと高速です。

The Sun JDK can be downloaded here.

Sun の JDK はここからダウンロード できます。

IMPORTANT: Set an environment variable JAVA_HOME to the pathname of the directory into which you installed the JDK release.

重要: 環境変数 JAVA_HOME の値に、 JDKをインストールしたディレクトリのパス名を設定して下さい。

Download a binary distribution of Ant 1.5.x from here.

Ant 1.5.x のバイナリ配布を ここから ダウンロードして下さい。

Unpack the binary distribution into a convenient location so that the Ant release resides in its own directory (conventionally named "jakarta-ant-1.5.1"). 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.

独自のディレクトリ (通常は "jakarta-ant-1.5.1" といった名前になります) に Ant が置かれるように、バイナリ配布を適当な場所に解凍して下さい。 "${ant.home}"という表記がこのドキュメントのこれ以降で出てきた場合、 Antをインストールしたディレクトリのフルパスを意味します。

Create an ANT_HOME environment variable to point the directory ${ant.home}, and modify the PATH environment variable to include directory "${ant.home}/bin" in its list. This makes the "ant" command line script available, which will be used to actually perform the build.

${ant.home} を指すように環境変数 ANT_HOME を作成し、 環境変数 PATH 内のリストに"${ant.home}/bin" を加えてください。 これにより、実際にビルドを実行する際に使用する "ant" コマンドラインスクリプトが使えるようになります。

Download the main build.xml script from here.

メインの build.xml スクリプトを ここ からダウンロードして下さい。

Create a new directory, and copy the newly download build.xml to it. This directory will be referred to as the ${tomcat.source} directory in the rest of this document.

新しいディレクトリを作成し、ダウンロードした build.xml をそこにコピーして下さい。 以降、このディレクトリを ${tomcat.source} ディレクトリとします。

Go to that directory, and do:
cd ${tomcat.source}
ant

このディレクトリに移動し、以下のコマンドを入力します。
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.

注意: プロキシ経由でインターネットにアクセスする場合、 プロキシの設定を Ant に指示するプロパティファイルを使わなければなりません。 詳しくは以下をお読みください。

WARNING: Running this command will checkout the Tomcat 5 sources from CVS, as well as download binaries to the /usr/share/java directory. Make sure this is appropriate to do so on your computer. On Windows, this usually corresponds to the C:\usr\share\java directory, unless Cygwin is used. Read below to customize the directory used to download the binaries.

警告: このコマンドを実行すると、Tomcat 5 のソースを CVS からチェックアウトするとともに、 /usr/share/java ディレクトリにバイナリをダウンロードします。 自分のコンピュータでそうすることが適切かどうかご確認下さい。 Cygwin を使っていない限り Windows では、このディレクトリは通常 C:\usr\share\java ディレクトリに該当します。 バイナリをダウンロードするのに使うディレクトリをカスタマイズする方法については以下をお読みください。

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=/usr/share/java

${tomcat.source}/build.properties ファイルを作成し、 以下の内容をファイルに追加することでビルドを制御できます。
# ----- プロキシセットアップ -----
# プロキシサーバを使う時はコメントを外して下さい。
#proxy.host=proxy.domain
#proxy.port=8080
#proxy.use=on

# ----- 依存パッケージのデフォルトのベースパス -----
# 依存するバイナリをダウンロードした場所に
# このパスを書き換えて下さい
base.path=/usr/share/java

It is recommended to regularly update the downloaded Tomcat 5 sources. To do this, execute the following commands:
cd ${tomcat.source}
ant checkout

一旦ダウンロードした Tomcat 5 のソースは定期的に更新することをお勧めします。 これを行うには、以下のコマンドを実行します。
cd ${tomcat.source}
ant checkout

For a quick rebuild of only modified code you can use:
cd ${tomcat.source}
ant build

修正されたコードのみをすばやく再ビルドするには以下のコマンドを使います。
cd ${tomcat.source}
ant build