Apache Tomcat 11

デフォルトでは、CATALINA_HOME と CATALINA_BASE は同じディレクトリを指します。1 台のマシンで複数の Tomcat インスタンスを実行する必要がある場合は、CATALINA_BASE を手動で設定します。これにより、次の利点が得られます。

• 新しいバージョンの Tomcat へのアップグレードの管理が容易になります。単一の CATALINA_HOME の場所を持つすべてのインスタンスは、1 セットの .jar ファイルとバイナリファイルを共有するため、ファイルを新しいバージョンに簡単にアップグレードし、同じ CATALIA_HOME ディレクトリを使用するすべての Tomcat インスタンスに変更を伝播できます。
• 同じ静的な .jar ファイルの重複を回避します。
• オペレーティングシステムに応じて、setenv シェルまたはバッチスクリプトファイルなど、特定の構成を共有できる可能性があります。

CATALINA_BASE の使用を開始する前に、まず、CATALINA_BASE で使用されるディレクトリツリーを検討して作成します。推奨されるすべてのディレクトリを作成しない場合、Tomcat はディレクトリを自動的に作成することに注意してください。必要なディレクトリを作成できない場合 (たとえば、権限の問題が原因)、Tomcat は起動に失敗するか、正しく機能しない可能性があります。

次のディレクトリのリストを検討してください。

• setenv.sh、setenv.bat、および tomcat-juli.jar ファイルを含む bin ディレクトリ。

  推奨: いいえ。

  ルックアップの順序: CATALINA_BASE が最初にチェックされます。フォールバックは CATALINA_HOME に提供されます。

• クラスパスに追加される追加のリソースを含む lib ディレクトリ。

  推奨: はい。アプリケーションが外部ライブラリに依存している場合。

  ルックアップの順序: CATALINA_BASE が最初にチェックされます。 CATALINA_HOME が 2 番目にロードされます。

• インスタンス固有のログファイル用の logs ディレクトリ。

  推奨: はい。

• 自動的にロードされる Web アプリケーション用の webapps ディレクトリ。

  推奨: はい。アプリケーションをデプロイする場合。

  ルックアップの順序: CATALINA_BASE のみ。

• デプロイされた Web アプリケーションの一時的な作業ディレクトリを含む work ディレクトリ。

  推奨: はい。

• 一時ファイルのために JVM によって使用される temp ディレクトリ。

  推奨: はい。

tomcat-juli.jar ファイルを変更しないことをお勧めします。ただし、独自のロギング実装が必要な場合は、特定の Tomcat インスタンスの CATALINA_BASE の場所にある tomcat-juli.jar ファイルを置き換えることができます。

CATALINA_HOME/conf ディレクトリからすべての構成ファイルを CATALINA_BASE/conf/ ディレクトリにコピーすることもお勧めします。構成ファイルが CATALINA_BASE にない場合、CATALINA_HOME へのフォールバックはありません。その結果、エラーが発生する可能性があります。

少なくとも、CATALINA_BASE には以下が含まれている必要があります。

• conf/server.xml
• conf/web.xml

それには conf ディレクトリが含まれます。そうでない場合、Tomcat は起動に失敗するか、正しく機能しません。

詳細な構成情報については、 RUNNING.txt ファイルを参照してください。

CATALINA_BASE プロパティは環境変数です。Tomcat 起動スクリプトを実行する前に設定できます。たとえば

• Unix の場合: CATALINA_BASE=/tmp/tomcat_base1 bin/catalina.sh start
• Windows の場合: CATALINA_BASE=C:\tomcat_base1 bin/catalina.bat start