$Id: RUNNING.txt,v 1.2 2001/08/27 20:22:37 craigmcc Exp $


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

               Tomcat 4.0 Servlet/JSP コンテナを実行する
               ============================================

This subproject contains Tomcat 4.0, a server that implements the Servlet 2.3
and JSP 1.2 Specifications from Java Software.  In order to install and run
this container, you must do the following:
このサブプロジェクトには、Java Softwareから出されたサーブレット2.3とJSP1.2の
仕様を実装したサーバTomcat 4.0が入っています。

(0) Download and Install a Java Development Kit
(0) Java開発キットのダウンロードとインストール


* Download a Java Development Kit (JDK) release (version 1.2 or later) from:
* Java開発キット(JDK)リリース(バージョン1.2以降)を以下からダウンロードして下さい:

    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.
* インストールしたJDKリリースのディレクトリへのパス名を
  環境変数JAVA_HOMEに設定して下さい。


(1) Download and Install the Tomcat 4.0 Binary Distribution
(1) Tomcat 4.0 バイナリ配布のダウンロードとインストール


NOTE:  As an alternative to downloading a binary distribution, you can create
your own from the Tomcat source repository, as described in "BUILDING.txt".
If you do this, the value to use for "${catalina.home}" will be the "dist"
subdirectory of your source distribution.
注: "BUILDING.txt"に書かれている通り、バイナリ配布をダウンロードする代わりに
    Tomcatソースリポジトリからあなた自身のバイナリを生成することも可能です。
    生成する際には、"${catalina.home}"の値に対してソース配布の中の
    "dist"サブディレクトリを使用して下さい。


* Download a binary distribution of Tomcat from:
* Tomcatバイナリ配布を以下からダウンロードして下さい:

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

  On a Windows platform, you will need:
  Windows環境では:
    jakarta-tomcat-4.0-YYYYMMDD.zip

  On a Unix platform, you will need:
  Unix環境では:
    jakarta-tomcat-4.0-YYYYMMDD.zip

* Unpack the binary 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 "${catalina.home}" is used to refer to the full
  pathname of the release directory.
* バイナリ配布を適当な場所に展開(解凍)すると配布内容がそのディレクトリ自身に
  配置されます(通常"jakarta-tomcat-4.0"という名前です)。
  忘れていけないのは、"${catalina.home}"がリリースディレクトリへの絶対パス名への参照として
  使われることです。
  ★訳者注:remainderはreminderの誤りではないかと思います。確信なし。

(2) Start Up Tomcat 4.0
(2) Tomcat 4.0の起動

There are two techniques by which Tomcat 4.0 can be started:
Tomcat 4.0 を起動させるには2通りの方法があります:

* Via an environment variable:
  - Set an environment variable CATALINA_HOME to the path of the directory
    into which you have installed Tomcat 4.0.
  - Execute the shell command:
* 環境変数による方法
  - Tomcat 4.0をインストールしたディレクトリをCATALINA_HOME環境変数に設定します。
  - 次のコマンドを実行します。

      %CATALINA_HOME%\bin\startup             (Windows)

      $CATALINA_HOME/bin/startup.sh           (Unix)

* By modifying your current working directory:
  - Execute the following shell commands:
* 作業ディレクトリを変更する方法:
  - 次のコマンドを実行します。

      cd %CATALINA_HOME%\bin                  (Windows)
      startup                                 (Windows)

      cd $CATALINA_HOME/bin                   (Unix)
      ./startup.sh                            (Unix)

After startup, the default web applications included with Tomcat 4.0 will be
available by browsing:
起動後、Tomcat 4.0に同梱されているWEBアプリケーションが以下のURLで
ブラウズ可能になります。

    http://localhost:8080/

Further information about configuring and running Tomcat 4.0 can be found in
the documentation included here, as well as on the Tomcat web site:
TomcatのWEBサイト(以下のURL)と同様のTomcat 4.0の設定と起動に関するより詳しい情報も
見ることができます。

    http://jakarta.apache.org/tomcat/


(3) Shut Down Tomcat 4.0
(3) Tomcat 4.0の終了

There are two techniques by which Tomcat 4.0 can be stopped:
Tomcat 4.0 を終了させるには2通りのやり方があります:

* Via an environment variable:
  - Set an environment variable CATALINA_HOME to the path of the directory
    into which you have installed Tomcat 4.0.
  - Execute the shell command:
* 環境変数による方法
  - Tomcat 4.0をインストールしたディレクトリをCATALINA_HOME環境変数に設定します。
  - 次のコマンドを実行します。

      %CATALINA_HOME%\bin\shutdown            (Windows)

      $CATALINA_HOME/bin/shutdown.sh          (Unix)

* By modifying your current working directory:
  - Execute the following shell commands:
* 作業ディレクトリを変更する方法:
  - 次のコマンドを実行します。

      cd %CATALINA_HOME%\bin                  (Windows)
      shutdown                                (Windows)

      cd $CATALINA_HOME/bin                   (Unix)
      ./shutdown.sh                           (Unix)


(4) Advanced Configuration - Multiple Tomcat 4 Instances
(4) 高度な設定 - Tomcat 4の複数起動(Multiple Instances)

In many circumstances, it is desireable to have a single copy of a Tomcat 4
binary distribution shared among multiple users on the same server.  To make
this possible, you must configure a CATALINA_BASE environment variable (in
addition to CATALINA_HOME as described above) that points to a directory
that is unique to your instance.
様々な事情により、あるサーバ上の一つのTomcat 4バイナリ配布モジュールを複数のユーザで
共有する必要が出てきます。これを可能にするには、(上記で説明したCATALINA_HOMEに加えて)
CATALINA_BASE環境変数がユーザ固有のインスタンスがあるディレクトリを指すように設定します。

When you do this, Tomcat 4 will calculate all relative references for files in
the following directories based on the value for CATALINA_BASE instead of
CATALINA_HOME:
この設定を行なうと、CATALINA_HOMEの代わりにCATALINA_BASEの値を基準とした
以下のディレクトリへの相対参照がTomcat 4により生成されます。

* conf - Server configuration files (including server.xml)
* conf - サーバー設定ファイル(server.xmlを含む)

* logs - Log and output files
* logs - ログと出力ファイル

* webapps - Automatically loaded web applications
* webapps - 自動ロードされるWEBアプリケーション

* work - Temporary working directories for web applications
* work - WEBアプリケーションが使用する作業用ディレクトリ

If you do not set CATALINA_BASE to an explicit value, it will be initialized
to the same value as is set for CATALINA_HOME (which means that the same
directory is used for all relative path resoluations).
CATALINA_BASE環境変数を設定しなかった場合は、CATALINA_HOMEと同じ値で初期化されます。
(つまり、相対パスを決める時に全て同じディレクトリが使われます)
★訳者注: resulationsはresolutionsの誤りだと思います。

(5) Troubleshooting:
(5) トラブルシューティング(問題解決)

There are only really 3 things that can go wrong during the stand-alone
Tomcat 4.0 install:
スタンドアロン利用のTomcat 4.0のインストール時に発生する可能性のある問題は3つだけです:

1) The most common hiccup is when another web server (or any process for that
   matter) has laid claim to port 8080.  This is the default HTTP port that
   Tomcat attempts to bind to at startup.  To change this, open the file:
   一番可能性のあるのは他のWEBサーバ(あるいは他のプロセス)が8080ポートに対する
   要求を上げる時です。8080はTomcatが起動時に割り当てを試みるデフォルトポートです。
   これを変更するためには次のファイルを開いて下さい:

       $CATALINA_HOME/conf/server.xml

   ...and search for '8080'.  Change it to a port that isn't in use, and is
   greater than 1024, as ports less than or equal to 1024 require superuser
   access to bind to.
   そして'8080'を検索して下さい。それを1024より大きい未使用ポートに変更します。
   1024以下のポートを使用するためにはスーパーユーザアクセス権が必要だからです。

   Restart Tomcat and you're in business.  Be sure that you replace the "8080"
   in the URL you're using to access Tomcat.  For example, if you change the
   port to 1977, you would request the URL http://localhost:1977/.
   Tomcatを再起動すれば使用可能になります。Tomcatにアクセスする時のURLの
   "8080"を置き換えることを忘れないで下さい。例えば、ポートを1997に変更したならば
   http://localhost:1977/というURLにリクエストをすることになります。

2) An "out of environment space" error when running the batch files in
   Win9X/ME-based operating systems.
   "環境変数のためのメモリ領域が足りません"というエラーが、Win9X/ME系のOSで
   バッチファイルを実行した場合に発生します。

   Right-click on the STARTUP.BAT and SHUTDOWN.BAT files.  Click on
   "Properties" then on the "Memory" tab.  For the "Initial environment" field,
   enter in something like 4096.
   STARTUP.BATとSHUTDOWN.BATファイルを右クリックしてください。
   [プロパティ]をクリックし、[メモリ]タブを開きます。
   [環境変数の初期サイズ]フィールドに4096などの値を入力して下さい。

   After you click apply, Windows will create shortcuts in the directory with
   which you can use to start and stop the container.
   [適用]をクリックするとコンテナの開始/終了が可能なショートカットがディレクトリに
   作成されます。

3) The 'localhost' machine isn't found.  This could happen if you're behing a
   proxy.  If that's the case, make sure the proxy configuration for your
   browser knows that you shouldn't be going through the proxy to access the
   "localhost" machine.
   'localhost'マシンが見つからない。これはプロキシの背後にある場合に起こります。
   その場合は、"localhost"マシンに対してはプロキシを経由しないようにブラウザの
   プロキシ設定が行なってあるかを確認して下さい。
   ★訳者注:behingはbehindの誤りだと思います。

   In Netscape, this is under Edit/preferences -> Advanced/proxies, and in
   Internet Explorer, Tools -> Internet Options -> Connections -> LAN Settings.
   Netscapeでは、[編集][設定]→[詳細][プロキシ]
   Internet Explorerでは、[ツール][インターネットオプション]→[接続]→[LANの設定]
   で設定します。