$Id: BUILDING.txt,v 1.1.1.1 2003/04/09 15:16:03 ytp Exp $


               Building The Tomcat 4.0 Servlet/JSP Container
               =============================================

               Tomcat 4.0のServlet/JSPコンテナをビルドする
               ===========================================

This subproject contains the source code Tomcat 4.0, 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.2 (or
later) downloaded and installed (version 1.3.1 recommended), and do the
following:

このサブプロジェクトは、ソース・コード Tomcat 4.0 (Java Softwareからの
Servlet 2.3とJSP 1.2の仕様を実装するサーバー)を含みます。
ソース配布からコンテナのバイナリの配布バージョンをビルドするには、
あなたはバージョン1.2 (またはそれ以降) のJava開発キット (JDK) をダウンロードして、
インストールし(推薦されるバージョンは1.3.1です)、以下を実行します。


(0) Download and Install a Java Development Kit

(0) Java開発キットをダウンロードして、インストールしてください

* Download a Java Development Kit (JDK) release (version 1.2 or later) from:

    http://java.sun.com/j2se/

* Install the JDK according to the instructions included with the release.

* そのリリースに添付されている説明に従って、JDKをインストールしてください。

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

* Java開発キット（JDK）リリース（バージョン1.2以降）をダウンロードします：

   http://java.sun.com/j2se/

* あなたがJDKリリースをインストールしたディレクトリのパス名を環境変数
  JAVA_HOMEに設定してください。


(1) Download and Install the Ant Binary Distribution

(1) Ant バイナリ配布をダウンロードして、インストールしてください

NOTE: Previous versions of Tomcat 4.0 relied on Ant 1.3 for the build
process. The 1.4 release is now required.

注: Tomcat 4.0の前のバージョンは、ビルド処理はAnt 1.3に依存していました。
    1.4リリースは、現在要求されています。

* Download a binary distribution of Ant 1.4 from:

* Ant 1.4のバイナリの配布をダウンロードします：

    http://jakarta.apache.org/builds/jakarta-ant/release/v1.4/bin/

  On a Windows platform, you will need:
  Windowsプラットホームで、必要なもの:
    jakarta-ant-1.4-bin.zip
    jakarta-ant-1.4-optional.jar

  On a Unix platform, you will need:
  Unixプラットホームで、必要なもの:
    jakarta-ant-1.4-bin.tar.gz
    jakarta-ant-1.4-optional.jar

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

* Antリリースがそれ自身のディレクトリ（conventionallyな名をつけられた「jakarta-ant-1.4」）に属するように、便利な位置にバイナリの配布を取り出してください。
この文書の残りの目的のために、記号的な名前入りの「${ant.home}」が、リリース・ディレクトリの完全なパス名を呼ぶために使われます。

* Copy the file "jakarta-ant-1.4-optional.jar", downloaded above, into
  the directory "${ant.home}/lib".  This makes available several Ant
  extension commands that are commonly required when building Jakarta
  based projects.

* ファイル「jakarta-ant 1.4-optional.jar」（管理的な「${ant.home}/lib」に上でダウンロードされる）をコピーしてください。
これは、構築しているJakartaがプロジェクトの基礎を形成したとき、一般に必要であるいくつかのAnt拡張コマンドを利用できるようにします。

* 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}/bin」をPATH環境変数に追加してください。
これは、「ant」コマンド・ライン・スクリプトを実行できるようにし、
実際に実行するために使われることになります。


(2) Download and Install the JAXP/1.1 Reference Implementation

(2) JAXP/1.1のリファレンス実装をダウンロードして、インストールしてください

* Download a binary distribution of JAXP 1.1 (Final Version) from:

* JAXP 1.1（Final Version）のバイナリ配布をダウンロードします：

    http://java.sun.com/xml/download.html

* Unpack the binary distribution into a convenient location so that the
  JAXP/1.1 release resides in its own directory (conventionally named
  "jaxp-1.1".  For the purposes of the remainder of this document, the
  symbolic name "${jaxp.home}" is used to refer to the full pathname of
  the release directory.

* JAXP/1.1のリリースがそれ自身のディレクトリに属するように、
便利な位置にバイナリの配布を取り出します（挙げられた「jaxp-1.1」をconventionallyしてください。)
この文書の残りの目的のために、シンボル名「${jaxp.home}」が、
リリース・ディレクトリの完全なパス名を呼ぶために使われます。

* Make the "xalan.jar" file of this distribution available to Ant (so that
  it can be used with the <style> tag) by copying it to "${ant.home}/lib".

* それを「${ant.home}/lib」へコピーすることによって、Ant
(それが<style>タグで使用できるように）が利用できる
この配布の「xalan.jar」ファイルを作ってください。

(3) Download and Install Subproject Source Code

(3) サブプロジェクト・ソース・コードをダウンロードして、インストールしてください

* Use Anonymous CVS (as described on the Jakarta web site at
  <http://jakarta.apache.org/site/cvsindex.html>, or
  download a source distribution from:

* Anonymous のCVSを使います（Jakartaウェブサイトで説明されている
<http://jakarta.apache.org/site/cvsindex.html>)
またはダウンロード・ソース配布から：

    http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/src/

  On a Windows platform, you will need:
    jakarta-tomcat-4.0-src-YYYYMMDD.zip

  On a Unix platform, you will need:
    jakarta-tomcat-4.0-src-YYYYMMDD.zip

  (NOTE:  Alternatively, you can grab the source distribution from a
  formal release, if you wish, by following links on the Jakarta web site).

（注：
この代わりに、あなたがJakartaウェブサイトのリンクに追従することによって望むならば、
あなたは形式的なリリースからソース配布をつかむことができます）。

* Unpack the source distribution into a convenient location so that the
  distribution resides in its own directory (conventionally named
  "jakarta-tomcat-4.0").  For the purposes of the remainder of this document,
  the symbolic name "${tomcat.source}" is used to refer to the full
  pathname of the release directory.

* 配布がそれ自身のディレクトリ（conventionallyな名をつけられた「jakarta-tomcat-4.0」）に属するように、便利な位置にソース配布を取り出してください。
この文書の残りの目的のために、記号的な名前入りの「${tomcat.source}」が、リリース・ディレクトリの完全なパス名を呼ぶために使われます。

(4) Download and Install the Regular Expressions Binary Distribution

(4) 正規表現のバイナリ配布をダウンロードして、インストールしてください

NOTE:  Alternatively, you can download the sources of the
"jakarta-regexp" subproject, and build a binary distribution yourself.

NOTE: 代わりに、あなたは「jakarta-regexp」サブプロジェクトのソースを
ダウンロードして、自分でバイナリの配布をビルドすることができます。

* Download a binary distribution from:

* バイナリ配布をダウンロードします：

    http://jakarta.apache.org/builds/jakarta-regexp/release/v1.2/

  On a Windows platform, you will need:
    jakarta-regexp-1.2.zip

  On a Unix platform, you will need:
    jakarta-regexp-1.2.tar.gz

* Unpack the binary distribution into a convenient location so that the
  distribution resides in its own directory (conventionally named
  "jakarta-regexp-x.y").

* 配布がそれ自身のディレクトリ（conventionallyな名をつけられた「jakarta-regexp x.y」）に属するように、便利な位置にバイナリの配布を取り出してください。

(5) Download and Install the Servlet API Binary Distribution
(5) Servlet API バイナリ配布をダウンロードして、インストールしてください

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.

NOTE: 代わりに、あなたは「jakarta-servletapi-4」サブプロジェクトの
ソースをダウンロードして、ビルドすることができます。
あなた自身バイナリの配布または使用Tomcat 4.0のバイナリの配布で
利用できるバイナリの配布。

* Download a binary distribution from:
* バイナリ配布をダウンロードします：

    http://jakarta.apache.org/builds/jakarta-servletapi-4/nightly/

  On a Windows platform, you will need:
    jakarta-servletapi-4-YYYYMMDD.zip

  On a Unix platform, you will need:
    jakarta-servletapi-4-YYYYMMDD.zip

* Unpack the binary distribution into a convenient location so that the
  distribution resides in its own directory.

* 配布がそれ自身のディレクトリに属するように、便利な位置にバイナリの配布を取り出してください。

(6) Download and Install JDBC Optional Package API

(6) オプションのJDBCパッケージAPIをダウンロードして、インストールしてください

* Download the JDBC Optional Pacakge API package (version 2.0) from:

* JDBCオプションのPacakge APIパッケージ（バージョン2.0）をダウンロードします：

    http://java.sun.com/products/jdbc/download.html

* Unpack the package into a convenient location so that it resides
  in its own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にパッケージを取り出してください。


(7) Download and Install the JMX 1.0 Reference Implementation

(7) JMX 1.0のリファレンス実装をダウンロードして、インストールしてください

* Download the JMX Instrumentation and Agent Reference Implementation
  (version 1.0 or later) from

* JMX計測とエージェント・リファレンス実装（バージョン1.0以降）をダウンロードしてください

    http://java.sun.com/products/JavaManagement/download.html

* Unpack the reference implementation into a convenient location so that
  it resides in its own subdirectory.
* それがそれ自身のサブディレクトリに属するように、便利な位置にリファレンス実装を取り出してください。


(8) Download and Install the JNDI 1.2.1 Reference Implementation
(8) JNDI 1.2.1リファレンス実装をダウンロードして、インストールしてください

* Download the Java Naming and Directory Interface (JNDI) package,
  (version 1.2.1 or later) from

* Java Naming and Directory インタフェース（JNDI）パッケージをダウンロードします、（バージョン1.2.1以降）から

    http://java.sun.com/products/jndi/

* Unpack the reference implementation into a convenient location so that
  it resides in its own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にリファレンス実装を取り出してください。

* You will also need the "LDAP Provider" (ldap.jar), available on the
  same download page.  Be sure that you unpack "ldap.jar" into the "lib"
  subdirectory of the JNDI directory, parallel to "jndi.jar".

* あなたは、また、「LDAPプロバイダー」（ldap.jar）
（同じダウンロード・ページで利用可能な）を必要とすることになります。
「jndi.jar」と平行して、あなたがJNDIディレクトリの「lib」サブディレクトリに、
「ldap.jar」を取り出すと確認してください。


(9) Download and Install the Java Activation Framework 1.0.1

(9) Java起動フレームワーク1.0.1をダウンロードして、インストールしてください

* Download the Java Activation Framework package (version 1.0.1 or later) from

* Java起動フレームワーク・パッケージ（バージョン1.0.1以降）をダウンロードしてください

    http://java.sun.com/products/javabeans/glasgow/jaf.html

* Unpack the package into a convenient location so that it
  resised in its own subdirectory.

* それがそれ自身のサブディレクトリにおいてresisedするように、便利な位置にパッケージを取り出してください。

(10) Download and Install JavaMail 1.2

(10) JavaMail 1.2をダウンロードして、インストールしてください

* Download the JavaMail package (version 1.2 or later) from

* JavaMailパッケージ（バージョン1.2以降）をダウンロードしてください

    http://java.sun.com/products/javamail/index.html

* Unpack the package into a convenient location so that
  it resides in its own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にパッケージを取り出してください。


(11) Download and Install the JSSE 1.0.2 Reference Implementation

(11) JSSE 1.0.2リファレンス実装をダウンロードして、インストールしてください

* Download the Java Secure Sockets Extension (JSSE) package,
  (version 1.0.2 or later) from

* Java Secure Sockets Extension（JSSE）パッケージをダウンロードします、（バージョン1.0.2以降）から

    http://java.sun.com/products/jsse/

* Unpack the reference implementation into a convenient location so that
  it resides in its own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にリファレンス実装を取り出してください。


(12) Download and Install the Java Transaction APIs

(12) Java Transaction APIをダウンロードして、インストールしてください

* Download the Java Transaction API (JTA) package (version 1.0.1) from:
* Java Transaction API（JTA）パッケージ（バージョン1.0.1）をダウンロードします：

    http://java.sun.com/products/jta/

* Unpack the package into a convenient location so that it resides in its
  own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にパッケージを取り出してください。


(13) Download and Install the Tyrex Data Source Package

(13) Tyrexデータ・ソース・パッケージをダウンロードして、インストールしてください

NOTE:  This step is only required if you wish to build the Tyrex connection
pool implementation for JNDI-accessed data sources.

NOTE: あなたがTyrexコネクションを構築することはJNDI-アクセスされたデータ・ソースのために、実装を共同出資することを願うならば、このステップは必要なだけです。

* Download the Tyrex JAR or release (version 0.9.7) from:

* Tyrex jarまたはリリース（バージョン0.9.7）をダウンロードします：

    http://tyrex.exolab.org/download.html

* Unpack the package into a convenient location so that it resides in its
  own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にパッケージを取り出してください。

(14) Download and Install the JUnit Testing Package (OPTIONAL)

(14) JUnit Testing パッケージ（オプション）をダウンロードして、インストールしてください

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.

NOTE: あなたがビルドして、Tomcat 4.0の起点の一部であるテストが基礎を
形成する単位を実行したいならば、このステップは必要なだけです。

* Download the JUnit unit test package (version 3.7 or later) from:

* JUnit ユニット・テスト・パッケージ（バージョン3.7以降）をダウンロードします：

    http://www.junit.org/

* Unpack the package into a convenient location so that it resides in its
  own subdirectory.

* それがそれ自身のサブディレクトリに属するように、便利な位置にパッケージを取り出してください。

(15) Customize Build Properties For This Subproject

(15) このサブプロジェクトのためのビルド設定をカスタマイズします

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
named "build.properties" in the source distribution directory (for property
definitions local to this subproject) and/or your user home directory (for
property definitions shared across subprojects).  You can use the included
"build.properties.sample" file as a starting point for this.

大部分のJakartaサブプロジェクトは、Antプロパティをカスタマイズことができます。
（デフォルトで、値は「build.xml」でファイルを定義しました。
これは、ソース配布ディレクトリ（このサブプロジェクトにローカルなプロパティ定義のために）やあなたのユーザー・ホーム・ディレクトリ（サブプロジェクトを横断して共有されるプロパティ定義のために）での「build.properties」という名前をつけられるテキスト・ファイルを作成することによってされます。
あなたは、これのために出発点として含まれた「build.properties.sample」ファイルを使用することができます。

Tomcat has many external dependencies that are satisfied by configuring
appropriate values in your <code>build.properties</code> file.  The easiest
way to satisfy these dependencies is to copy the "build.properties.sample"
file (in the top-level Tomcat source directory) to "build.properties", and
then edit it to suit your environment.  On Unix, this would be done as:

Tomcatは、あなたの<code>build.properties</code>ファイルにおいて、
適当な値を構成することによって満たされる多くの外部の依存を持ちます。
これらの依存を満たす最も簡単な方法は、「build.properties.sample」ファイル
（最高のレベルTomcatソース・ディレクトリでは）を「build.properties」へコピーして、
それからあなたの環境に合うためにそれを編集することです。
Unixの上で、これはされます：

  cd ${tomcat.source}
  cp build.properties.sample build.properties
  emacs build.properties

NOTE:  Be *sure* that you do not check "build.properties" in to the CVS
repository.  This file is local to your own development environment, and
each developer will have their own version.

NOTE: あなたがCVSリポジトリにおいて「build.properties」をチェックに
しない事を *確認* してください。
このファイルはあなた自身の開発環境にローカルです、
そして、各々の開発者は彼ら自身のバージョンを持つことになります。

(16) Build A Binary Distribution

(16) バイナリの配布を構築してください

Open a command line shell, and issue the following commands:
コマンド・ライン・シェルを開けてください、そして、以下のコマンドを実行してください。

  cd ${tomcat.source}
  ant -projecthelp

If everything is installed correctly, you should see a list of the Ant
"targets" that represent different commands you might wish to build.  By
convention, the "dist" target creates a complete binary distribution.  To
execute it, type the following commands:

すべてが正しくインストールされるならば、あなたはあなたが構築した
いかもしれないという異なる命令を表すAnt「target」のリストを見るはずです。
取り決めによって、「dist」ターゲットは、完全なバイナリの配布をつくります。
それ（以下が指揮するタイプ）を実行します：

  cd ${tomcat.source}
  ant dist

This will create a complete binary distribution of the subproject (equivalent
in structure to the corresponding binary distribution downloadable from the
Jakarta web site), in the "${tomcat.source}/dist" directory.  It will have
the contents described in the corresponding "README.txt" file.

「${tomcat.source}/dist」ディレクトリでは、これはサブプロジェクト
（Jakartaウェブサイトからdownloadableな対応するバイナリの配布への建造物において等しい）
の完全なバイナリの配布をつくることになります。
それは、持つことになります満足させます対応する「README.txt」ファイルの中の記述します。

See the document RUNNING.txt for instructions on how to start up and shut down
the servlet/JSP container.

servlet/JSPコンテナの開始/停止の方法については、
RUNNING.txtドキュメントを参照してください。