Apache Tomcat 10

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

• Tomcatの新しいバージョンへのアップグレードの管理が容易になります。単一のCATALINA_HOMEの場所を持つすべてのインスタンスが、1つの.jarファイルとバイナリファイルのセットを共有するため、ファイルを新しいバージョンに簡単にアップグレードし、同じCATALIA_HOMEディレクトリを使用するすべてのTomcatインスタンスに変更を反映させることができます。
• 同じ静的な.jarファイルの重複を回避します。
• 特定のsettings, 例えば setenv shell スクリプトや bat スクリプトファイル (お使いのオペレーティングシステムに依存) を共有できます。

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