Apache Tomcat 11

ほとんどのコマンドは、以下のクエリパラメーターの1つ以上を受け入れます。

• path - 扱っているウェブアプリケーションのコンテキストパス（先頭のスラッシュを含む）。ROOTウェブアプリケーションを選択するには、「/」を指定します。
  注：Managerアプリケーション自体に対して管理コマンドを実行することはできません。
  注：pathパラメーターが明示的に指定されていない場合、パスとバージョンは、configパラメーターから標準のContext命名ルールを使用して導出されます。configパラメーターが存在しない場合は、warパラメーターから導出されます。
• version - 並列デプロイメント機能で使用されるこのウェブアプリケーションのバージョン。パスが必要な場所で並列デプロイメントを使用する場合、パスに加えてバージョンを指定する必要があり、一意である必要があるのはパスだけでなくパスとバージョンの組み合わせです。
  注：pathが明示的に指定されていない場合、versionパラメーターは無視されます。
• war - ウェブアプリケーションアーカイブ (WAR) ファイルのURL、またはウェブアプリケーションを含むディレクトリのパス名、またはContext設定".xml"ファイル。以下のいずれかの形式でURLを使用できます。
  • file:/absolute/path/to/a/directory - ウェブアプリケーションの展開されたバージョンを含むディレクトリの絶対パス。このディレクトリは、指定したコンテキストパスに何の変更もなくアタッチされます。
  • file:/absolute/path/to/a/webapp.war - ウェブアプリケーションアーカイブ (WAR) ファイルの絶対パス。これは/deployコマンドに対してのみ有効であり、そのコマンドで許容される唯一の形式です。
  • file:/absolute/path/to/a/context.xml - Context設定要素を含むウェブアプリケーションContext設定".xml"ファイルの絶対パス。
  • directory - ホストのアプリケーションベースディレクトリ内のウェブアプリケーションコンテキストのディレクトリ名。
  • webapp.war - ホストのアプリケーションベースディレクトリ内にあるウェブアプリケーションのWARファイル名。

各コマンドはtext/plain形式（つまり、HTMLマークアップのないプレーンなASCII）で応答を返します。これにより、人間もプログラムも簡単に読み取ることができます。応答の最初の行は、要求されたコマンドが成功したかどうかを示すOKまたはFAILのいずれかで始まります。失敗した場合、最初の行の残りの部分には、発生した問題の説明が含まれます。一部のコマンドには、以下に説明するように追加の情報行が含まれます。

国際化に関する注意 - Managerアプリケーションはメッセージ文字列をリソースバンドルで検索するため、文字列がプラットフォーム向けに翻訳されている可能性があります。以下の例では、メッセージの英語版を示します。

https://:8080/manager/text/deploy?path=/foo

このHTTP PUTリクエストでリクエストデータとして指定されたウェブアプリケーションアーカイブ（WAR）ファイルをアップロードし、対応する仮想ホストのappBaseディレクトリにインストールして開始します。appBaseに追加されるWARファイルの名前は、指定されたパスから導出されます。アプリケーションは後で/undeployコマンドを使用してアンデプロイ（および対応するWARファイルの削除）できます。

このコマンドはHTTP PUTリクエストによって実行されます。

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

URLパラメーターには以下が含まれます。

• update: trueに設定すると、既存の更新はまずアンデプロイされます。デフォルト値はfalseです。
• tag: タグ名を指定すると、デプロイされたウェブアプリをタグまたはラベルと関連付けることができます。ウェブアプリケーションがアンデプロイされても、必要に応じて後でそのタグのみを使用して再デプロイできます。
• config : file:/absolute/path/to/a/context.xml形式のContext設定".xml"ファイルのURL。これは、Context設定要素を含むウェブアプリケーションContext設定".xml"ファイルの絶対パスでなければなりません。

注 - このコマンドは、/undeployコマンドの論理的な逆です。

インストールと起動が成功した場合、次のような応答を受け取ります。

OK - Deployed application at context path /foo

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

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

  現在実行中のすべてのウェブアプリケーションのコンテキストパスは一意である必要があります。したがって、このコンテキストパスを使用している既存のウェブアプリケーションをアンデプロイするか、新しいウェブアプリケーションに別のコンテキストパスを選択する必要があります。このエラーを回避するために、URLのパラメーターとしてupdateパラメーターをtrueの値で指定することができます。その場合、デプロイメントを実行する前に既存のアプリケーションに対してアンデプロイが実行されます。

• 例外が発生しました

  新しいウェブアプリケーションを起動しようとしているときに例外が発生しました。詳細についてはTomcatのログを確認してください。考えられる原因としては、/WEB-INF/web.xmlファイルの解析に関する問題、またはアプリケーションのイベントリスナーやフィルターの初期化時に不足しているクラスが見つかったことなどが挙げられます。

指定されたコンテキストpath（他のウェブアプリケーションで使用されていないもの）にアタッチされた新しいウェブアプリケーションをデプロイして起動します。このコマンドは、/undeployコマンドの論理的な逆です。

このコマンドはHTTP GETリクエストによって実行されます。デプロイコマンドには、いくつかの異なる使用方法があります。

https://:8080/manager/text/deploy?path=/footoo&tag=footag

https://:8080/manager/text/deploy?path=/footoo&war=file:/path/to/foo

https://:8080/manager/text/deploy?war=file:/path/to/bar.war

https://:8080/manager/text/deploy?war=foo

https://:8080/manager/text/deploy?war=bar.war

<Context path="/foobar" docBase="/path/to/application/foobar">
</Context>

https://:8080/manager/text/deploy?config=file:/path/context.xml

https://:8080/manager/text/deploy
 ?config=file:/path/context.xml&war=file:/path/bar.war

OK - Deployed application at context path /foo

https://:8080/manager/text/list

現在デプロイされているすべてのウェブアプリケーションのコンテキストパス、現在のステータス（runningまたはstopped）、およびアクティブなセッション数を一覧表示します。Tomcatの起動直後の典型的な応答は次のようになります。

OK - Listed applications for virtual host localhost
/webdav:running:0:webdav
/examples:running:0:examples
/manager:running:0:manager
/:running:0:ROOT
/test:running:0:test##2
/test:running:0:test##1

https://:8080/manager/text/reload?path=/examples

既存のアプリケーションに、自身をシャットダウンしてリロードするよう指示します。これは、ウェブアプリケーションコンテキストがリロード可能ではなく、/WEB-INF/classesディレクトリ内のクラスやプロパティファイルを更新した場合、または/WEB-INF/libディレクトリにjarファイルを追加または更新した場合に役立ちます。

このコマンドが成功した場合、次のような応答が表示されます。

OK - Reloaded application at context path /examples

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

• 例外が発生しました

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

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

  コンテキストパスはスラッシュ文字で始まる必要があります。ROOTウェブアプリケーションを参照するには「/」を使用します。

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

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

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

  pathパラメーターは必須です。

• パス/fooにデプロイされたWARではリロードはサポートされていません

  現在、WARファイルから直接ウェブアプリケーションがデプロイされた場合、アプリケーションのリロード（クラスまたはweb.xmlファイルの変更を反映するため）はサポートされていません。これは、ウェブアプリケーションが展開されたディレクトリからデプロイされた場合にのみ機能します。WARファイルを使用している場合、変更を反映させるには、アプリケーションをundeployしてからdeployするか、updateパラメーター付きでdeployし直す必要があります。

https://:8080/manager/text/serverinfo

Tomcatのバージョン、OS、JVMプロパティに関する情報を一覧表示します。

エラーが発生した場合、応答はFAILで始まり、エラーメッセージが含まれます。考えられる問題の原因には以下が含まれます。

• 例外が発生しました

  システムプロパティを列挙しようとして例外が発生しました。詳細についてはTomcatのログを確認してください。

https://:8080/manager/text/resources[?type=xxxxx]

コンテキスト設定ファイルのリソースリンクで使用できるグローバルJNDIリソースを一覧表示します。typeリクエストパラメーターを指定する場合、その値は関心のあるリソースタイプの完全修飾Javaクラス名である必要があります（たとえば、利用可能なすべてのJDBCデータソースの名前を取得するにはjavax.sql.DataSourceを指定します）。typeリクエストパラメーターを指定しない場合、すべてのタイプのリソースが返されます。

typeリクエストパラメーターが指定されているかどうかに応じて、通常の応答の最初の行は次のようになります。

OK - Listed global resources of all types

または

OK - Listed global resources of type xxxxx

各リソースにつき1行が続き、各行はコロン（":"）文字で区切られたフィールドで構成されます。以下に示すとおりです。

• グローバルリソース名 - このグローバルJNDIリソースの名前。<ResourceLink>要素のglobal属性で使用されます。
• グローバルリソースタイプ - このグローバルJNDIリソースの完全修飾Javaクラス名。

エラーが発生した場合、応答はFAILで始まり、エラーメッセージが含まれます。考えられる問題の原因には以下が含まれます。

• 例外が発生しました

  グローバルJNDIリソースを列挙しようとして例外が発生しました。詳細についてはTomcatのログを確認してください。

• グローバルJNDIリソースが利用できません

  実行中のTomcatサーバーは、グローバルJNDIリソースなしで設定されています。

https://:8080/manager/text/sessions?path=/examples

ウェブアプリケーションのデフォルトセッションタイムアウト、および実際のタイムアウト時間の1分間隔の範囲内にある現在アクティブなセッションの数を表示します。例えば、Tomcatを再起動し、/examplesウェブアプリのJSPサンプルの一つを実行した後、次のような結果が得られることがあります。

OK - Session information for application at context path /examples
Default maximum session inactive interval 30 minutes
<1 minutes: 1 sessions
1 - <2 minutes: 1 sessions

https://:8080/manager/text/expire?path=/examples&idle=num

セッション統計（上記の/sessionsコマンドと同様）を表示し、num分より長くアイドル状態のセッションを期限切れにします。すべてのセッションを期限切れにするには、&idle=0を使用します。

OK - Session information for application at context path /examples
Default maximum session inactive interval 30 minutes
1 - <2 minutes: 1 sessions
3 - <4 minutes: 1 sessions
>0 minutes: 2 sessions were expired

実際には/sessionsと/expireは同じコマンドの同義語です。違いはidleパラメーターの有無です。

https://:8080/manager/text/start?path=/examples

停止したアプリケーションに再起動を指示し、再び利用可能にします。停止と開始は、例えば、アプリケーションが必要とするデータベースが一時的に利用できなくなった場合に役立ちます。ユーザーが継続的にデータベース例外に遭遇するのを許容するよりも、このデータベースに依存するウェブアプリケーションを停止する方が通常は良いでしょう。

このコマンドが成功した場合、次のような応答が表示されます。

OK - Started application at context path /examples

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

• 例外が発生しました

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

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

  コンテキストパスはスラッシュ文字で始まる必要があります。ROOTウェブアプリケーションを参照するには「/」を使用します。

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

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

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

  pathパラメーターは必須です。

https://:8080/manager/text/stop?path=/examples

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

このコマンドが成功した場合、次のような応答が表示されます。

OK - Stopped application at context path /examples

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

• 例外が発生しました

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

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

  コンテキストパスはスラッシュ文字で始まる必要があります。ROOTウェブアプリケーションを参照するには「/」を使用します。

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

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

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

https://:8080/manager/text/undeploy?path=/examples

警告 - このコマンドは、この仮想ホストのappBaseディレクトリ（通常は「webapps」）内に存在するウェブアプリケーションのアーティファクトをすべて削除します。これにより、存在する場合はアプリケーションの.WARファイル、展開形式でのデプロイまたは.WAR展開によって生成されたアプリケーションディレクトリ、および$CATALINA_BASE/conf/[enginename]/[hostname]/ディレクトリからのXML Context定義が削除されます。単にアプリケーションをサービスから外したい場合は、代わりに/stopコマンドを使用してください。

既存のアプリケーションに、正常にシャットダウンし、Tomcatから削除するよう指示します（これにより、このコンテキストパスは後で再利用できるようになります）。さらに、この仮想ホストのappBaseディレクトリ（通常は「webapps」）に存在する場合、ドキュメントルートディレクトリも削除されます。このコマンドは、/deployコマンドの論理的な逆です。

このコマンドが成功した場合、次のような応答が表示されます。

OK - Undeployed application at context path /examples

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

• 例外が発生しました

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

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

  コンテキストパスはスラッシュ文字で始まる必要があります。ROOTウェブアプリケーションを参照するには「/」を使用します。

• 名前/fooのコンテキストは存在しません

  指定した名前のデプロイ済みアプリケーションはありません。

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

https://:8080/manager/text/findleaks[?statusLine=[true|false]]

メモリリーク検出診断は、完全なガベージコレクションをトリガーします。本番システムでは、細心の注意を払って使用してください。

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

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

このコマンドが成功した場合、次のような応答が表示されます。

/leaking-webapp

応答にステータス行を含めたい場合は、リクエストにstatusLineクエリパラメーターをtrueの値で含めてください。

停止、リロード、またはアンデプロイされたウェブアプリケーションの各コンテキストパスのうち、以前の実行からのクラスがまだメモリにロードされており、メモリリークを引き起こしているものは、新しい行に一覧表示されます。アプリケーションが複数回リロードされている場合、複数回一覧表示されることがあります。

コマンドが成功しない場合、応答はFAILで始まり、エラーメッセージが含まれます。

https://:8080/manager/text/sslConnectorCiphers

SSLコネクター/暗号診断は、各コネクターに現在設定されているSSL/TLS暗号を一覧表示します。

応答は次のようになります。

OK - Connector / SSL Cipher information
Connector[HTTP/1.1-8080]
  SSL is not enabled for this connector
Connector[HTTP/1.1-8443]
  TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA
  TLS_DHE_RSA_WITH_AES_128_CBC_SHA
  TLS_ECDH_RSA_WITH_AES_128_CBC_SHA
  TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA
  ...

https://:8080/manager/text/sslConnectorCerts

SSLコネクター/証明書診断は、各仮想ホストに現在設定されている証明書チェーンを一覧表示します。

応答は次のようになります。

OK - Connector / Certificate Chain information
Connector[HTTP/1.1-8080]
SSL is not enabled for this connector
Connector[HTTP/1.1-8443]-_default_-RSA
[
[
  Version: V3
  Subject: CN=localhost, OU=Apache Tomcat PMC, O=The Apache Software Foundation, L=Wakefield, ST=MA, C=US
  Signature Algorithm: SHA256withRSA, OID = 1.2.840.113549.1.1.11
  ...

https://:8080/manager/text/sslConnectorTrustedCerts

SSLコネクター/証明書診断は、各仮想ホストに現在設定されている信頼済み証明書を一覧表示します。

応答は次のようになります。

OK - Connector / Trusted Certificate information
Connector[HTTP/1.1-8080]
SSL is not enabled for this connector
Connector[HTTP/1.1-8443]-_default_
[
[
  Version: V3
  Subject: CN=Apache Tomcat Test CA, OU=Apache Tomcat PMC, O=The Apache Software Foundation, L=Wakefield, ST=MA, C=US
  ...

https://:8080/manager/text/sslReload?tlsHostName=name

TLS設定ファイル（証明書および鍵ファイル。これはserver.xmlの再解析をトリガーしません）をリロードします。すべてのホストのファイルをリロードするには、tlsHostNameパラメーターを指定しないでください。

OK - Reloaded TLS configuration for [_default_]

https://:8080/manager/text/threaddump

JVMスレッドダンプを書き込みます。

応答は次のようになります。

OK - JVM thread dump
2014-12-08 07:24:40.080
Full thread dump Java HotSpot(TM) Client VM (25.25-b02 mixed mode):

"http-nio-8080-exec-2" Id=26 cpu=46800300 ns usr=46800300 ns blocked 0 for -1 ms waited 0 for -1 ms
   java.lang.Thread.State: RUNNABLE
        locks java.util.concurrent.ThreadPoolExecutor$Worker@1738ad4
        at sun.management.ThreadImpl.dumpThreads0(Native Method)
        at sun.management.ThreadImpl.dumpAllThreads(ThreadImpl.java:446)
        at org.apache.tomcat.util.Diagnostics.getThreadDump(Diagnostics.java:440)
        at org.apache.tomcat.util.Diagnostics.getThreadDump(Diagnostics.java:409)
        at org.apache.catalina.manager.ManagerServlet.threadDump(ManagerServlet.java:557)
        at org.apache.catalina.manager.ManagerServlet.doGet(ManagerServlet.java:371)
        at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:618)
        at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:725)
...

https://:8080/manager/text/vminfo

Java仮想マシンに関する診断情報を書き込みます。

応答は次のようになります。

OK - VM info
2014-12-08 07:27:32.578
Runtime information:
  vmName: Java HotSpot(TM) Client VM
  vmVersion: 25.25-b02
  vmVendor: Oracle Corporation
  specName: Java Virtual Machine Specification
  specVersion: 1.8
  specVendor: Oracle Corporation
  managementSpecVersion: 1.2
  name: ...
  startTime: 1418012458849
  uptime: 393855
  isBootClassPathSupported: true

OS information:
...

https://:8080/manager/text/save

パラメーターを指定せずにこのコマンドを実行すると、サーバーの現在の設定がserver.xmlに保存されます。既存のファイルは、必要に応じてバックアップとして名前が変更されます。

デプロイされたウェブアプリケーションのパスと一致するpathパラメーターを指定すると、そのウェブアプリケーションの設定は、現在のホストのxmlBaseにある適切に命名されたcontext.xmlファイルに保存されます。

このコマンドを使用するには、StoreConfig MBeanが存在する必要があります。通常、これはStoreConfigLifecycleListenerを使用して設定されます。

コマンドが成功しない場合、応答はFAILで始まり、エラーメッセージが含まれます。

これは次の形式を取ります。

http://webserver/manager/jmxproxy/?qry=STUFF

ここでSTUFFは、実行したいJMXクエリです。例えば、実行したいクエリは次のとおりです。

• qry=*%3Atype%3DRequestProcessor%2C* --> type=RequestProcessor。これは、リクエストを処理できるすべてのワーカーを特定し、その状態を報告します。
• qry=*%3Aj2eeType=Servlet%2c* --> j2eeType=Servlet。これはロードされたすべてのサーブレットを返します。
• qry=Catalina%3Atype%3DEnvironment%2Cresourcetype%3DGlobal%2Cname%3DsimpleValue --> Catalina:type=Environment,resourcetype=Global,name=simpleValue。これは、指定された名前で特定のMBeanを検索します。

その機能を本当に理解するには、これで実験する必要があります。qryパラメーターを指定しない場合、すべてのMBeanが表示されます。実行できるすべてのクエリをより深く理解するために、Tomcatのソースコードを見てJMX仕様を理解することを強くお勧めします。

JMXProxyServletは、特定のMBeanの属性の値をフェッチするために使用できる「get」コマンドもサポートしています。getコマンドの一般的な形式は次のとおりです。

http://webserver/manager/jmxproxy/?get=BEANNAME&att=MYATTRIBUTE&key=MYKEY

以下のパラメーターを指定する必要があります。

1. get: 完全なBean名
2. att: フェッチしたい属性
3. key: （オプション）CompositeData MBean属性へのキー

すべてがうまくいけば、OKと表示され、そうでない場合はエラーメッセージが表示されます。例えば、現在のヒープメモリデータをフェッチしたいとします。

http://webserver/manager/jmxproxy/?get=java.lang:type=Memory&att=HeapMemoryUsage

または、「used」キーのみが必要な場合

http://webserver/manager/jmxproxy/
 ?get=java.lang:type=Memory&att=HeapMemoryUsage&key=used

MBeanをクエリできるようになったので、Tomcatの内部をいじる時です！設定コマンドの一般的な形式は次のとおりです。

http://webserver/manager/jmxproxy/?set=BEANNAME&att=MYATTRIBUTE&val=NEWVALUE

そのため、3つのリクエストパラメーターを指定する必要があります。

1. set: 完全なBean名
2. att: 変更したい属性
3. val: 新しい値

すべてがうまくいけば、OKと表示され、そうでない場合はエラーメッセージが表示されます。例えば、ErrorReportValveのデバッグをその場でオンにしたいとします。以下を実行すると、デバッグが10に設定されます。

https://:8080/manager/jmxproxy/
 ?set=Catalina%3Atype%3DValve%2Cname%3DErrorReportValve%2Chost%3Dlocalhost
 &att=debug&val=10

そして私の結果は（環境によって異なります）

Result: ok

不正な値を渡した場合に表示されるのはこちらです。私が使用したURLはこれです。デバッグを「cow」に設定しようとします。

https://:8080/manager/jmxproxy/
 ?set=Catalina%3Atype%3DValve%2Cname%3DErrorReportValve%2Chost%3Dlocalhost
 &att=debug&val=cow

それを試すと、私の結果はこうなります

Error: java.lang.NumberFormatException: For input string: "cow"

invokeコマンドは、MBean上のメソッドを呼び出すことを可能にします。コマンドの一般的な形式は次のとおりです。

http://webserver/manager/jmxproxy/
 ?invoke=BEANNAME&op=METHODNAME&ps=COMMASEPARATEDPARAMETERS

例えば、ServiceのfindConnectors()メソッドを呼び出すには、以下を使用します。

https://:8080/manager/jmxproxy/
 ?invoke=Catalina%3Atype%3DService&op=findConnectors&ps=

Antバージョン1.6.2以降では、Catalinaタスクは出力をプロパティまたは外部ファイルにキャプチャするオプションを提供します。これらは、<redirector>タイプの属性の以下のサブセットを直接サポートします。

いくつかの追加属性も指定できます。

また、埋め込みの<redirector>要素もサポートしており、input、inputstring、inputencodingを除くすべての属性を指定できます。これらは受け入れられますが、このコンテキストでは意味がないため使用されません。<redirector>要素の属性の詳細については、Antマニュアルを参照してください。

以下に、この出力リダイレクトサポートの利用方法を示すビルドファイルの抜粋例を示します。

    <target name="manager.deploy"
        depends="context.status"
        if="context.notInstalled">
        <deploy url="${mgr.url}"
            username="${mgr.username}"
            password="${mgr.password}"
            path="${mgr.context.path}"
            config="${mgr.context.descriptor}"/>
    </target>

    <target name="manager.deploy.war"
        depends="context.status"
        if="context.deployable">
        <deploy url="${mgr.url}"
            username="${mgr.username}"
            password="${mgr.password}"
            update="${mgr.update}"
            path="${mgr.context.path}"
            war="${mgr.war.file}"/>
    </target>

    <target name="context.status">
        <property name="running" value="${mgr.context.path}:running"/>
        <property name="stopped" value="${mgr.context.path}:stopped"/>

        <list url="${mgr.url}"
            outputproperty="ctx.status"
            username="${mgr.username}"
            password="${mgr.password}">
        </list>

        <condition property="context.running">
            <contains string="${ctx.status}" substring="${running}"/>
        </condition>
        <condition property="context.stopped">
            <contains string="${ctx.status}" substring="${stopped}"/>
        </condition>
        <condition property="context.notInstalled">
            <and>
                <isfalse value="${context.running}"/>
                <isfalse value="${context.stopped}"/>
            </and>
        </condition>
        <condition property="context.deployable">
            <or>
                <istrue value="${context.notInstalled}"/>
                <and>
                    <istrue value="${context.running}"/>
                    <istrue value="${mgr.update}"/>
                </and>
                <and>
                    <istrue value="${context.stopped}"/>
                    <istrue value="${mgr.update}"/>
                </and>
            </or>
        </condition>
        <condition property="context.undeployable">
            <or>
                <istrue value="${context.running}"/>
                <istrue value="${context.stopped}"/>
            </or>
        </condition>
    </target>

警告：多くの意味をなさず、常に悪い考えですが、Catalinaタスクを複数回呼び出すと、不適切に設定されたAntタスクの依存関係チェーンにより、意図せずとも同じAnt実行中にタスクが複数回呼び出される可能性があります。そのタスクから出力をキャプチャする際には、予期せぬ事態を招く可能性があるため、注意が必要です。

• プロパティにキャプチャする場合、そこには最初の呼び出しからの出力のみが見つかります。なぜならAntのプロパティは不変であり、一度設定されると変更できないからです。
• ファイルにキャプチャする場合、各実行で上書きされ、最後の呼び出しの出力のみが見つかります。ただし、append="true"属性を使用している場合は、各タスク呼び出しの出力がファイルに追加されて表示されます。