Apache Tomcat 10

停止したアプリケーションに再起動して再び利用可能になるように信号を送ります。停止と起動は、たとえば、アプリケーションに必要なデータベースが一時的に使用できなくなった場合に役立ちます。ユーザーが継続的にデータベース例外に遭遇するのを防ぐため、通常はこのデータベースに依存するWebアプリケーションを停止する方が良いでしょう。

このコマンドが成功すると、次のようなメッセージが表示されます

OK - Started application at context path /examples

そうでない場合、メッセージはFAILで始まり、エラーメッセージが含まれます。問題の考えられる原因は次のとおりです

• 例外が発生しました

  Webアプリケーションの起動中に例外が発生しました。詳細については、Tomcatログを確認してください。

• 無効なコンテキストパスが指定されました

  コンテキストパスは、ROOT Webアプリケーションを参照していない限り、スラッシュ文字で始まる必要があります。ROOT Webアプリケーションを参照している場合は、コンテキストパスは長さゼロの文字列である必要があります。

• パス/fooのコンテキストが存在しません

  指定したコンテキストパスにデプロイされたアプリケーションがありません。

• コンテキストパスが指定されていません

  pathパラメータが必要です。

既存のアプリケーションに利用不可にするように信号を送信しますが、デプロイされたままにします。アプリケーションの停止中に受信したリクエストは、HTTPエラー404が表示され、このアプリケーションはアプリケーションリストコマンドで「停止」として表示されます。

このコマンドが成功すると、次のようなメッセージが表示されます

OK - Stopped application at context path /examples

そうでない場合、メッセージはFAILで始まり、エラーメッセージが含まれます。問題の考えられる原因は次のとおりです

• 例外が発生しました

  Webアプリケーションの停止中に例外が発生しました。詳細については、Tomcatログを確認してください。

• 無効なコンテキストパスが指定されました

  コンテキストパスは、ROOT Webアプリケーションを参照していない限り、スラッシュ文字で始まる必要があります。ROOT Webアプリケーションを参照している場合は、コンテキストパスは長さゼロの文字列である必要があります。

• パス/fooのコンテキストが存在しません

  指定したコンテキストパスにデプロイされたアプリケーションがありません。

• コンテキストパスが指定されていません

  pathパラメータが必要です。

既存のアプリケーションにシャットダウンして再読み込みするように信号を送信します。これは、Webアプリケーションコンテキストが再読み込み不可で、/WEB-INF/classesディレクトリ内のクラスまたはプロパティファイルを更新した場合、または/WEB-INF/libディレクトリ内のjarファイルを追加または更新した場合に役立ちます。

注：/WEB-INF/web.xml Webアプリケーション構成ファイルは、再読み込み時にはチェックされません。以前のweb.xml構成が使用されます。 web.xmlファイルに変更を加えた場合は、Webアプリケーションを停止してから起動する必要があります。

このコマンドが成功すると、次のようなメッセージが表示されます

OK - Reloaded application at context path /examples

そうでない場合、メッセージはFAILで始まり、エラーメッセージが含まれます。問題の考えられる原因は次のとおりです

• 例外が発生しました

  Webアプリケーションの再起動中に例外が発生しました。詳細については、Tomcatログを確認してください。

• 無効なコンテキストパスが指定されました

  コンテキストパスは、ROOT Webアプリケーションを参照していない限り、スラッシュ文字で始まる必要があります。ROOT Webアプリケーションを参照している場合は、コンテキストパスは長さゼロの文字列である必要があります。

• パス/fooのコンテキストが存在しません

  指定したコンテキストパスにデプロイされたアプリケーションがありません。

• コンテキストパスが指定されていません

  pathパラメータが必要です。

• パス/fooにデプロイされたWARでは再読み込みがサポートされていません

  現在、ホストがWARファイルを解凍しないように構成されている場合に発生する、WARファイルから直接Webアプリケーションをインストールする場合、アプリケーションの再読み込み（クラスまたはweb.xmlファイルへの変更を反映するため）はサポートされていません。解凍されたディレクトリからWebアプリケーションをインストールした場合にのみ機能するため、WARファイルを使用している場合は、変更を反映するためにアプリケーションをアンデプロイしてから再びデプロイする必要があります。

警告 - このコマンドは、この仮想ホストのappBaseディレクトリ（通常は「webapps」）内にWebアプリケーションディレクトリまたは「.war」ファイルが存在する場合、その内容を削除します。Webアプリケーションの一時作業ディレクトリも削除されます。アプリケーションをサービスから外すだけの場合は、代わりに/stopコマンドを使用する必要があります。

既存のアプリケーションに正常にシャットダウンするように信号を送信し、Tomcatから削除します（これにより、このコンテキストパスを後で再利用できるようになります）。このコマンドは、/deploy Antコマンド、およびHTMLマネージャーで使用可能な関連するデプロイ機能の論理的な反対です。

このコマンドが成功すると、次のようなメッセージが表示されます

OK - Undeployed application at context path /examples

そうでない場合、メッセージはFAILで始まり、エラーメッセージが含まれます。問題の考えられる原因は次のとおりです

• 例外が発生しました

  Webアプリケーションのアンデプロイ中に例外が発生しました。詳細については、Tomcatログを確認してください。

• 無効なコンテキストパスが指定されました

  コンテキストパスは、ROOT Webアプリケーションを参照していない限り、スラッシュ文字で始まる必要があります。ROOT Webアプリケーションを参照している場合は、コンテキストパスは長さゼロの文字列である必要があります。

• パス/fooのコンテキストが存在しません

  指定したコンテキストパスにデプロイされたアプリケーションがありません。

• コンテキストパスが指定されていません pathパラメータが必要です。

指定された*コンテキストパス：*（他のWebアプリケーションで使用されていない必要があります）に添付された新しいWebアプリケーションをデプロイして起動します。このコマンドは、*アンデプロイ*コマンドの論理的な反対です。

deployコマンドを使用するには、さまざまな方法があります。

Context Path: /footoo
WAR or Directory URL: file:C:/path/to/foo

WAR or Directory URL: jar:file:/path/to/bar.war!/

WAR or Directory URL: foo

Context Path: /bartoo
WAR or Directory URL: bar.war

<Context path="/foobar" docBase="C:\path\to\application\foobar">
</Context>

XML Configuration file URL: file:C:/path/to/context.xml

XML Configuration file URL: file:/path/to/context.xml
WAR or Directory URL: jar:file:/path/to/bar.war!/

ローカルシステムからWARファイルをアップロードし、HostのappBaseにインストールします。 ".war" 拡張子を除いたWARファイルの名前がコンテキストパス名として使用されます。

*参照*ボタンを使用して、ローカルデスクトップシステムからサーバーにアップロードするWARファイルを選択します。

.WARファイルには、/META-INF/context.xmlにContext設定XMLファイルを含めることで、Tomcat固有のデプロイ設定を含めることができます。

WARファイルのアップロードは、次の理由で失敗する可能性があります。

• アップロードされたファイルは.warである必要があります

  アップロードインストールでは、ファイル名拡張子が ".war" のファイルのみを受け入れます。

• Warファイルはサーバーに既に存在します

  同じ名前のWARファイルがHostのappBaseに既に存在する場合、アップロードは失敗します。 HostのappBaseから既存のWARファイルをアンデプロイするか、別の名前を使用して新しいWARファイルをアップロードします。

• ファイルのアップロードに失敗しました。ファイルがありません

  ファイルのアップロードに失敗しました。サーバーでファイルが受信されませんでした。

• インストールのアップロードに失敗しました。例外

  WARファイルのアップロードまたはインストールがJava例外で失敗しました。 例外メッセージが表示されます。

HostがunpackWARs = trueに設定されていて、WARファイルをインストールすると、WARはHost appBaseディレクトリのディレクトリに解凍されます。

アプリケーションのWARまたはディレクトリがHost appBaseディレクトリにデプロイされ、HostがautoDeploy = trueに設定されている場合、コンテキストパスは ".war" 拡張子を除いたディレクトリ名またはWARファイル名と一致する必要があります。

信頼できないユーザーがWebアプリケーションを管理できる場合のセキュリティのために、Host deployXMLフラグをfalseに設定できます。 これにより、信頼できないユーザーが設定XMLファイルを使用してWebアプリケーションをインストールしたり、Host appBaseの外部にあるアプリケーションディレクトリまたは ".war" ファイルをインストールしたりすることができなくなります。

デプロイと起動が成功すると、次のようなメッセージが表示されます。

OK - Deployed application at context path /foo

そうでない場合、メッセージはFAILで始まり、エラーメッセージが含まれます。問題の考えられる原因は次のとおりです

• アプリケーションはパス/ fooに既に存在します

  現在実行中のすべてのWebアプリケーションのコンテキストパスは一意である必要があります。 したがって、このコンテキストパスを使用して既存のWebアプリケーションをアンデプロイするか、新しいWebアプリケーションに別のコンテキストパスを選択する必要があります。

• ドキュメントベースが存在しないか、読み取り可能なディレクトリではありません

  *WARまたはディレクトリURL：*フィールドで指定されたURLは、Webアプリケーションの「解凍された」バージョンを含むこのサーバー上のディレクトリ、またはこのアプリケーションを含むWebアプリケーションアーカイブ（WAR）ファイルの絶対URLを識別する必要があります。 *WARまたはディレクトリURL：*フィールドに入力された値を修正してください。

• 例外が発生しました

  新しいWebアプリケーションの起動中に例外が発生しました。 詳細についてはTomcatログを確認してください。考えられる説明としては、/WEB-INF/web.xmlファイルの解析の問題、またはアプリケーションイベントリスナーとフィルターの初期化時に見つからないクラスなどがあります。

• 無効なアプリケーションURLが指定されました

  指定した*WARまたはディレクトリURL：*フィールドのURLが無効でした。 このようなURLはfile：で始まる必要があり、WARファイルのURLは ".war" で終わる必要があります。

• 無効なコンテキストパスが指定されました

  コンテキストパスは、ROOT Webアプリケーションを参照していない限り、スラッシュ文字で始まる必要があります。ROOT Webアプリケーションを参照している場合は、コンテキストパスは "/" 文字列である必要があります。

• コンテキストパスはディレクトリまたはWARファイル名と一致する必要があります

  アプリケーションのWARまたはディレクトリがHost appBaseディレクトリにデプロイされ、HostがautoDeploy = trueに設定されている場合、コンテキストパスは ".war" 拡張子を除いたディレクトリ名またはWARファイル名と一致する必要があります。

• Host WebアプリケーションディレクトリにあるWebアプリケーションのみをデプロイできます

  Host deployXMLフラグがfalseに設定されている場合、Host appBaseディレクトリの外部にあるWebアプリケーションディレクトリまたは ".war" ファイルをインストールしようとすると、このエラーが発生します。

リークの検出診断は、完全なガベージコレクションをトリガーします。 本番システムでは、細心の注意を払って使用する必要があります。

リークの検出診断は、停止、リロード、またはアンデプロイされたときにメモリリークを引き起こしたWebアプリケーションを特定しようとします。 結果は常にプロファイラで確認する必要があります。 診断では、StandardHost実装によって提供される追加機能が使用されます。 StandardHostを拡張しないカスタムホストが使用されている場合は機能しません。

この診断では、停止、リロード、またはアンデプロイされたWebアプリケーションのコンテキストパスが一覧表示されますが、以前の実行からのクラスがメモリにまだ残っているため、メモリリークが発生しています。 アプリケーションが数回リロードされている場合、数回リストされる可能性があります.

Javaコードから完全なガベージコレクションを明示的にトリガーすることは、信頼できないとされています。 さらに、使用されるJVMによっては、`-XX:+DisableExplicitGC`のように、明示的なGCトリガーを無効にするオプションがあります。 診断が正常に完全なGCを実行していることを確認する場合は、GCロギング、JConsoleなどのツールを使用して確認する必要があります。