]> &project; Glenn L. Nielsen Tomcat Web Application Manager How To Tomcat Webアプリケーションマネージャの手引き 高橋達男

In many production environments it is very useful to have the capability to manage your web applications without having to shut down and restart Tomcat. This document is for the HTML web interface to the web application manager.

Tomcat をシャットダウンして再起動せずに Webアプリケーションを管理できる機能は多くの本番環境で非常に便利です。 このドキュメントは manager Webアプリケーションの HTML による Webインタフェースに関する説明です。

The interface is divided into five sections:

  • Message - Displays success and failure messages.
  • Manager - General manager operations like list and help.
  • Applications - List of web applications and commands.
  • Deploy - Deploying web applications.
  • Server Information - Information about the Tomcat server.

インタフェースは5つのセクションに分かれます。

  • メッセージ - 処理成功/失敗のメッセージを表示します。
  • マネージャ - 一覧表示やヘルプなどマネージャの一般的な操作。
  • アプリケーション - Webアプリケーションとコマンドの一覧。
  • 配備 - Webアプリケーションを配備します。
  • サーバ情報 - Tomcatサーバに関する情報。

Displays information about the success or failure of the last web application manager command you performed. If it succeeded OK is displayed and may be followed by a success message. If it failed FAIL is displayed followed by an error message. Common failure messages are documented below for each command. The complete list of failure messages for each command can be found in the manager web application documentation.

直前に実行した Webアプリケーションマネージャのコマンドの成功/失敗に関する情報を表示します。 成功した場合、成功と表示され、 その後にメッセージが続くこともあります。 失敗した場合、失敗と表示され、 その後にエラーメッセージが続きます。 共通の失敗メッセージは各コマンドごとに以下で文書化しています。 各コマンドの失敗メッセージの全一覧はマネージャ Webアプリケーションのドキュメントにあります。

初期表示時は「OK」と表示されます。

The Manager section has three links:

  • List Applications - Redisplay a list of web applications.
  • HTML Manager Help - A link to this document.
  • Manager Help - A link to the comprehensive Manager App HOW TO.

「マネージャ」セクションにはリンクが3つあります。

  • アプリケーションの一覧 - Webアプリケーション一覧を再表示します。
  • HTML Manager Help - このドキュメントへのリンク。
  • Manager Help - マネージャアプリケーションの総合的な手引きへのリンク。

The Applications section lists information about all the installed web applications and provides links for managing them. For each web application the following is displayed:

  • Path - The web applicaton context path.
  • Display Name - The display name for the web application if it has one configured in its "web.xml" file.
  • Running - Whether the web application is running and available (true), or not running and unavailable (false).
  • Sessions - The number of active sessions for remote users of this web application. The number of sessions is a link which when submitted displays more details about session usage by the web application in the Message box.
  • Commands - Lists all commands which can be performed on the web application. Only those commands which can be performed will be listed as a link which can be submitted. No commands can be performed on the manager web application itself. The following commands can be performed:
    • Start - Start a web application which had been stopped.
    • Stop - Stop a web application which is currently running and make it unavailable.
    • Reload - Reload the web application so that new ".jar" files in /WEB-INF/lib/ or new classes in /WEB-INF/classes/ can be used.
    • Undeploy - Stop and then remove this web application from the server.

「アプリケーション」セクションにはインストール済みのすべての Webアプリケーションに関する情報が一覧になっており、 それを管理するリンクも提供されています。 各アプリケーションごとに以下の項目が表示されます。

  • パス - Webアプリケーションのコンテキストパス。
  • 表示名 - Webアプリケーションの表示名。 "web.xml" ファイルで設定されている場合に表示されます。
  • 実行中 - Webアプリケーションが実行中で使用可能 (true) か、それとも実行中でなく使用不可 (false) かを示します。
  • セッション - この Webアプリケーションのアクティブなリモートユーザーセッション数。 セッション数はリンクになっており、クリックすると「メッセージ」セクションに Webアプリケーションでのセッション使用状況に関する詳細が表示されます。
  • コマンド - Webアプリケーションに対して実行するコマンドがすべて表示されます。 実行可能なコマンドのみクリック可能なリンクとして表示されます。 マネージャ Webアプリケーションそのものに対してはコマンドは実行できません。 実行可能なコマンドは以下のとおりです。
    • 起動 - 停止している Webアプリケーションを起動します。
    • 停止 - 現在実行中のWebアプリケーションを停止し、 使用不可にします。
    • 再ロード - Webアプリケーションを再ロードし、 /WEB-INF/lib/ にある新しい ".jar" ファイルや /WEB-INF/classes/ にある新しいクラスを使えるようにします。
    • 配備解除 - この Webアプリケーションを停止し、 このサーバから削除します。

Signal a stopped application to restart, and make itself available again. Stopping and starting is useful, for example, if the database required by your application becomes temporarily unavailable. It is usually better to stop the web application that relies on this database rather than letting users continuously encounter database exceptions.

停止したアプリケーションに再起動を指示し、再び使用可能にします。 例えば、アプリケーションで必要なデータベースが一時的に使用不可になった場合、 停止・起動ができると便利です。たいていの場合、 このデータベースを使う Webアプリケーションを停止させた方が、 ユーザに対してデータベース例外を表示し続けるよりは良いでしょう。

If this command succeeds, you will see a Message like this:

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

OK - Started application at context path /examples 成功 - コンテキストパス /examples でアプリケーションを起動しました

Otherwise, the Message will start with FAIL and include an error message. Possible causes for problems include:

  • Encountered exception

    An exception was encountered trying to start the web application. Check the Tomcat 5 logs for the details.

  • Invalid context path was specified

    The context path must start with a slash character, unless you are referencing the ROOT web application -- in which case the context path must be a zero-length string.

  • No context exists for path /foo

    There is no deployed application on the context path that you specified.

  • No context path was specified
    The path parameter is required.

そうでなければ、メッセージは 失敗 で始まり、 エラーメッセージが表示されます。問題の原因としては以下のものが考えられます。

  • 例外が発生しました

    Webアプリケーションの起動時に例外が発生しました。 詳細については Tomcat 5 のログをチェックして下さい。

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

    コンテキストパスはスラッシュ ("/") で始まらなければなりません。 ROOT Webアプリケーションを参照している場合は例外です -- この場合は、コンテキストパスは長さ0の文字列になります。

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

    指定したコンテキストのアプリケーションは配備されていません。

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

"No context path was specified"というメッセージは5.0.16では存在しません。 "Context path is required"(コンテキストパスが必要です)のことでしょうか?

Signal an existing application to make itself unavailable, but leave it deployed. Any request that comes in while an application is stopped will see an HTTP error 404, and this application will show as "stopped" on a list applications command.

既存のアプリケーションを使用不可にするよう指示しますが、配備解除はしません。 アプリケーションが停止している時に送られたリクエストの結果はすべて HTTPエラー404 となり、アプリケーション一覧では「実行中」欄に false が表示されます。

実際にブラウザで表示した場合、0バイトのレスポンスが返っているらしく、 何も表示されません。どうやら、manager-howto.xml をそのままコピーしたようなので、 HTML画面での表示にあわせて記述を変えています。

If this command succeeds, you will see a Message like this:

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

OK - Stopped application at context path /examples 成功 - コンテキストパス /examples でアプリケーションを停止しました

Otherwise, the Message will start with FAIL and include an error message. Possible causes for problems include:

  • Encountered exception

    An exception was encountered trying to stop the web application. Check the Tomcat 5 logs for the details.

  • Invalid context path was specified

    The context path must start with a slash character, unless you are referencing the ROOT web application -- in which case the context path must be a zero-length string.

  • No context exists for path /foo

    There is no deployed application on the context path that you specified.

  • No context path was specified
    The path parameter is required.

そうでなければ、メッセージは 失敗 で始まり、 エラーメッセージが表示されます。問題の原因としては以下のものが考えられます。

  • 例外が発生しました

    Webアプリケーションの起動時に例外が発生しました。 詳細については Tomcat 5 のログをチェックして下さい。

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

    コンテキストパスはスラッシュ ("/") で始まらなければなりません。 ROOT Webアプリケーションを参照している場合は例外です -- この場合は、コンテキストパスは長さ0の文字列になります。

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

    指定したコンテキストのアプリケーションは配備されていません。

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

"No context path was specified"というメッセージは5.0.16では存在しません。 "Context path is required"(コンテキストパスが必要です)のことでしょうか?

Signal an existing application to shut itself down and reload. This can be useful when the web application context is not reloadable and you have updated classes or property files in the /WEB-INF/classes directory or when you have added or updated jar files in the /WEB-INF/lib directory.

既存のアプリケーションにシャットダウンと再ロードを指示します。 Webアプリケーションコンテキストが再ロード可能になっていなくて /WEB-INF/classes のクラスやプロパティファイルを更新した場合や、 /WEB-INF/lib ディレクトリの JARファイルを更新した場合に便利かもしれません。

NOTE: The /WEB-INF/web.xml web application configuration file is not checked on a reload; the previous web.xml configuration is used. If you have made changes to your web.xml file you must stop then start the web application.

注意: /WEB-INF/web.xml の Webアプリケーション設定ファイルは再ロード時にチェックされず、 以前の web.xml の設定が使われます。web.xml ファイルを変更した場合は、 Webアプリケーションを停止・起動しなければなりません

If this command succeeds, you will see a Message like this:

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

OK - Reloaded application at context path /examples OK - コンテキストパス /examples のアプリケーションを再ロードしました

Otherwise, the Message will start with FAIL and include an error message. Possible causes for problems include:

  • Encountered exception

    An exception was encountered trying to restart the web application. Check the Tomcat 5 logs for the details.

  • Invalid context path was specified

    The context path must start with a slash character, unless you are referencing the ROOT web application -- in which case the context path must be a zero-length string.

  • No context exists for path /foo

    There is no deployed application on the context path that you specified.

  • No context path was specified
    The path parameter is required.
  • Reload not supported on WAR deployed at path /foo
    Currently, application reloading (to pick up changes to the classes or web.xml file) is not supported when a web application is installed directly from a WAR file, which happens when the host is configured to not unpack WAR files. As it only works when the web application is installed from an unpacked directory, if you are using a WAR file, you should undeploy and then deploy the application again to pick up your changes.

そうでなければ、メッセージは 失敗 で始まり、 エラーメッセージが表示されます。問題の原因としては以下のものが考えられます。

  • 例外が発生しました

    Webアプリケーションの起動時に例外が発生しました。 詳細については Tomcat 5 のログをチェックして下さい。

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

    コンテキストパスはスラッシュ ("/") で始まらなければなりません。 ROOT Webアプリケーションを参照している場合は例外です -- この場合は、コンテキストパスは長さ0の文字列になります。

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

    指定したコンテキストのアプリケーションは配備されていません。

  • コンテキストパスが指定されていません
    path パラメータが必要です。
  • パス /foo に配備されたWARファイルでは再ロードがサポートされていません
    たまたまホストでWARファイルを解凍しないように設定されていて、 Webアプリケーションが WARファイルから直接インストールされた場合は、 現在のところ、アプリケーションの再ロード (クラスや web.xml ファイルの変更の反映) はサポートされません。 再ロードはアーカイブされていないディレクトリから Webアプリケーションがインストールされた場合のみ有効なので、 WARファイルを使う場合、アプリケーションに変更を反映させるには、 配備解除 した上で再度 配備 しなければなりません。

"No context path was specified"というメッセージは5.0.16では存在しません。 "Context path is required"(コンテキストパスが必要です)のことでしょうか?

WARNING - This command will delete the contents of the web application directory and/or ".war" file if it exists within the appBase directory (typically "webapps") for this virtual host . The web application temporary work directory is also deleted. If you simply want to take an application out of service, you should use the /stop command instead.

警告 - このコマンドによって、 この仮想ホストの appBase ディレクトリ (通常は"webapps") 内に存在する Webアプリケーションディレクトリの中身や".war"ファイル、 あるいはその両方が削除されます。 Webアプリケーションの一時的なワークディレクトリも削除されます。 アプリケーションのサービスを休止したいだけなら、 代わりに /stop コマンドを使うべきです。

Signal an existing application to gracefully shut itself down, and then remove it from Tomcat (which also makes this context path available for reuse later). This command is the logical opposite of the /deploy Ant command, and the related deploy features available in the HTML manager.

既存のアプリケーションを緩やかに (gracefully) シャットダウンし、 Tomcat から削除するよう指示します (またこれによって、このコンテキストパスは後で再利用可能となります)。 これは /deploy Ant コマンドやそれに関連する HTMLマネージャの配備機能と論理的に反対のコマンドです。

"gracefully"の訳はApache HTTPDの訳を参考にしました。

If this command succeeds, you will see a Message like this:

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

OK - Undeployed application at context path /examples OK - 成功 - コンテキストパス /examples のアプリケーションを配備解除しました

Otherwise, the Message will start with FAIL and include an error message. Possible causes for problems include:

  • Encountered exception

    An exception was encountered trying to undeploy the web application. Check the Tomcat logs for the details.

  • Invalid context path was specified

    The context path must start with a slash character, unless you are referencing the ROOT web application -- in which case the context path must be a zero-length string.

  • No context exists for path /foo

    There is no deployed application on the context path that you specified.

  • No context path was specified
    The path parameter is required.

そうでなければ、メッセージは 失敗 で始まり、 エラーメッセージが表示されます。問題の原因としては以下のものが考えられます。

  • 例外が発生しました

    Webアプリケーションの起動時に例外が発生しました。 詳細については Tomcat 5 のログをチェックして下さい。

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

    コンテキストパスはスラッシュ ("/") で始まらなければなりません。 ROOT Webアプリケーションを参照している場合は例外です -- この場合は、コンテキストパスは長さ0の文字列になります。

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

    指定したコンテキストのアプリケーションは配備されていません。

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

"No context path was specified"というメッセージは5.0.16では存在しません。 "Context path is required"(コンテキストパスが必要です)のことでしょうか?

Web applications can be deployed using files or directories located on the Tomcat server or you can upload a web application archive (WAR) file to the server.

Webアプリケーションは Tomcatサーバ上のファイルやディレクトリを使って配備できますが、 Webアプリケーションアーカイブ (WAR) ファイルをサーバにアップロードすることもできます。

To install an application, fill in the appropriate fields for the type of install you want to do and then submit it using the Install button.

アプリケーションをインストールするには、 行ないたいインストールの種類に応じて適切なフィールドに入力し、 配備 ボタンをクリックします。

Deploy and start a new web application, attached to the specified Context Path: (which must not be in use by any other web application). This command is the logical opposite of the Undeploy command.

指定したコンテキストパス (省略可): (必ずしもすべての Webアプリケーションで使われるわけではありません) に付随する、 新しい Webアプリケーションを配備・起動します。 配備解除 コマンドと論理的に反対のコマンドです。

There are a number of different ways the deploy command can be used.

配備コマンドの使い方は何通りもあります。

Deploy a Directory or WAR by URL

URL 指定でのディレクトリまたは WARファイルの配備

Install a web application directory or ".war" file located on the Tomcat server. If no Context Path is specified, the directory name or the war file name without the ".war" extension is used as the path. The WAR or Directory URL specifies a URL (including the file: scheme) for either a directory or a web application archive (WAR) file. The supported syntax for a URL referring to a WAR file is described on the Javadocs page for the java.net.JarURLConnection class. Use only URLs that refer to the entire WAR file.

Tomcatサーバ上の Webアプリケーションのディレクトリや ".war"ファイルをインストールします。 コンテキストパス が指定されていない場合は、 ディレクトリ名、またはWARファイル名から拡張子".war"を省いた名前がパスとして使われます。 WAR またはディレクトリのURL では、ディレクトリ、 Webアプリケーションアーカイブ (WAR) ファイルのいずれかの URL (file:URI スキームを含む) を指定します。 WARファイルを参照する URL でサポートされている構文は java.net.JarURLConnection クラスの Javadoc に記述されています。 WARファイルの完全名を参照する URL しか使えません。

In this example the web application located in the directory C:\path\to\foo on the Tomcat server (running on Windows) is deployed as the web application context named /footoo. Context Path: /footoo WAR or Directory URL: file:C:/path/to/foo

以下の例では (Windows 上で実行される) Tomcat サーバの C:\path\to\foo というディレクトリにある Webアプリケーションが /footoo というコンテキストの Webアプリケーションとして配備されます。 コンテキストパス (省略可): /footoo WARファイル又はディレクトリのURL: file:C:/path/to/foo

In this example the ".war" file /path/to/bar.war on the Tomcat server (running on Unix) is deployed as the web application context named /bar. Notice that there is no path parameter so the context path defaults to the name of the web application archive file without the ".war" extension. WAR or Directory URL: jar:file:/path/to/bar.war!/

以下の例では (Unix 上で実行される) Tomcat サーバの /path/to/bar.war という WARファイルが、/barというコンテキストの Webアプリケーションとして配備されます。コンテキストパス パラメータが指定されていないため、コンテキストパスはデフォルトである、 Webアプリケーションアーカイブファイル名から拡張子".war"を省いた名前になることに注意して下さい。 WARファイル又はディレクトリのURL: jar:file:/path/to/bar.war!/

Deploy a Directory or War from the Host appBase

ホストの appBase 指定でのディレクトリや WAR ファイルの配備

Install a web application directory or ".war" file located in your Host appBase directory. If no Context Path is specified the directory name or the war file name without the ".war" extension is used as the path.

ホストの appBaseディレクトリ配下の Webアプリケーションのディレクトリまたは ".war"ファイルをインストールします。 コンテキストパス が指定されていない場合は、 ディレクトリ名、またはWARファイル名から拡張子".war"を省いた名前がパスとして使われます。

In this example the web application located in a subdirectory named foo in the Host appBase directory of the Tomcat server is deployed as the web application context named /foo. Notice that there is no path parameter so the context path defaults to the name of the web application directory. WAR or Directory URL: foo

以下の例では Tomcatサーバのホストの appBaseディレクトリの下の foo ディレクトリにある Webアプリケーションが /foo という Webアプリケーションコンテキストで配備されます。 コンテキストパス パラメータが指定されていないので、 コンテキストパスはデフォルトの Webアプリケーションのディレクトリ名となっていることに注意して下さい。 WARファイル又はディレクトリのURL: foo

In this example the ".war" file bar.war located in your Host appBase directory on the Tomcat server is deployed as the web application context named /bartoo. Context Path: /bartoo WAR or Directory URL: bar.war

以下の例では Tomcatサーバのホストの appBaseディレクトリにある bar.war という".war"ファイルが /bartoo という Webアプリケーションコンテキストで配備されます。 コンテキストパス (省略可): /bartoo WARファイル又はディレクトリのURL: bar.war

Deploy using a Context configuration ".xml" file

コンテキスト設定".xml"ファイルを使った配備

If the Host deployXML flag is set to true, you can install a web application using a Context configuration ".xml" file and an optional ".war" file or web application directory. The Context Path is not used when installing a web application using a context ".xml" configuration file.

ホストの deployXML フラグが true の場合、コンテキスト設定 ".xml"ファイルと、オプションで ".war"ファイルまたは Webアプリケーションディレクトリを使って Webアプリケーションをインストールできます。 コンテキスト設定".xml"ファイルを使って Webアプリケーションをインストールする際には コンテキストパス は使われません。

A Context configuration ".xml" file can contain valid XML for a web application Context just as if it were configured in your Tomcat server.xml configuration file. Here is an example for Tomcat running on Windows: <Context path="/foobar" docBase="C:\path\to\application\foobar" debug="0"> <!-- Link to the user database we will get roles from --> <ResourceLink name="users" global="UserDatabase" type="org.apache.catalina.UserDatabase"/> </Context>

コンテキスト設定".xml"ファイルには、Tomcat の server.xml で設定するのと同じように 妥当な XML を記述できます。Windows 上で実行される Tomcat の例を示します。 <Context path="/foobar" docBase="C:\path\to\application\foobar" debug="0"> <!-- Link to the user database we will get roles from --> <ResourceLink name="users" global="UserDatabase" type="org.apache.catalina.UserDatabase"/> </Context>

Use of the WAR or Directory URL is optional. When used to select a web application ".war" file or directory it overrides any docBase configured in the context configuration ".xml" file.

WARファイル又はディレクトリのURL: はオプションです。 Webアプリケーションの ".war"ファイルまたはディレクトリを選択するのに使うと、 コンテキスト設定".xml"ファイルで設定された docBase はすべて上書きされます。

Here is an example of installing an application using a Context configuration ".xml" file for Tomcat running on Windows. XML Configuration file URL: file:C:/path/to/context.xml

Windows 上で実行される Tomcat 用のコンテキスト設定".xml" ファイルを使ってアプリケーションをインストールする例を示します。 XML設定ファイルのURL: file:C:/path/to/context.xml

Here is an example of installing an application using a Context configuration ".xml" file and a web application ".war" file located on the server (Tomcat running on Unix). XML Configuration file URL: file:/path/to/context.xml WAR or Directory URL: jar:file:/path/to/bar.war!/

(Unix 上で実行される Tomcat) サーバ上のコンテキスト設定 ".xml"ファイルと Webアプリケーション ".war"ファイルをインストールする例を示します。 XML設定ファイルのURL: file:/path/to/context.xml WARファイル又はディレクトリのURL: jar:file:/path/to/bar.war!/

Upload a WAR file from your local system and install it into the appBase for your Host. The name of the WAR file without the ".war" extension is used as the context path name.

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

Use the Browse button to select a WAR file to upload to the server from your local desktop system.

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

The .WAR file may include Tomcat specific deployment configuration, by including a Context configuration XML file in /META-INF/context.xml.

.WAR ファイルでは /META-INF/context.xml というコンテキスト設定 XMLファイルを含めることで、Tomcat 固有の配備設定を含めることができます。

Upload of a WAR file could fail for the following reasons:

WARファイルのアップロードが失敗する理由としては以下のものが考えられます。

  • File uploaded must be a .war

    The upload install will only accept files which have the filename extension of ".war".

  • War file already exists on server

    If a war file of the same name already exists in your Host's appBase the upload will fail. Either undeploy the existing war file from your Host's appBase or upload the new war file using a different name.

  • File upload failed, no file

    The file upload failed, no file was received by the server.

  • Install Upload Failed, Exception:

    The war file upload or install failed with a Java Exception. The exception message will be listed.
  • アップロードするファイルはWARファイルでなければいけません

    アップロードによるインストールの場合、拡張子が ".war" のファイルしか受け取れません。

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

    ホストの appBase に同じ名前の WAR ファイルが存在している場合、 アップロードは失敗します。既存の WARファイルをホストの appBase から配備解除するか、別の名前で WAR ファイルをアップロードして下さい。

  • ファイルのアップロードが失敗しました、ファイルが存在しません

    ファイルアップロードが失敗し、サーバがファイルを受け取っていません。

  • 配備のアップロードが失敗しました、例外:

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

If the Host is configured with unpackWARs=true and you install a war file, the war will be unpacked into a directory in your Host appBase directory.

unpackWARs=true という設定のホストで WARファイルをインストールすると、 WARファイルはホストの appBase ディレクトリに展開されます。

If the application war or directory is deployed in your Host appBase directory and either the Host is configured with autoDeploy=true or liveDeploy=true, the Context path must match the directory name or war file name without the ".war" extension.

アプリケーションの WARファイルやディレクトリがホストの appBase ディレクトリに配備され、ホストで autoDeploy=true、liveDeploy=true のいずれかに設定されている場合、コンテキストパスはディレクトリ名か、 WARファイル名から拡張子".war"を省いた名前に合致しなければなりません。

For security when untrusted users can manage web applications, the Host deployXML flag can be set to false. This prevents untrusted users from installing web applications using a configuration XML file and also prevents them from installing application directories or ".war" files located outside of their Host appBase.

セキュリティ上の理由から、信頼されないユーザが Webアプリケーションを管理できる場合は、ホストの deployXML フラグは false になっています。これにより、信頼されないユーザは、設定 XML ファイルを使って Webアプリケーションをインストールできないだけでなく、 ホストの appBase ディレクトリ配下にないアプリケーションディレクトリや ".war" ファイルのインストールができないようになっています。

If deployment and startup is successful, you will receive a Message like this:

配備・起動が成功すると、以下のようなメッセージが表示されます。

OK - Deployed application at context path /foo 成功 - コンテキストパス /foo にアプリケーションをインストールしました

Otherwise, the Message will start with FAIL and include an error message. Possible causes for problems include:

そうでなければ、メッセージは 失敗 で始まり、 エラーメッセージが表示されます。問題の原因としては以下のものが考えられます。

  • Application already exists at path /foo

    The context paths for all currently running web applications must be unique. Therefore, you must either undeploy the existing web application using this context path, or choose a different context path for the new one.

  • Document base does not exist or is not a readable directory

    The URL specified by the WAR or Directory URL: field must identify a directory on this server that contains the "unpacked" version of a web application, or the absolute URL of a web application archive (WAR) file that contains this application. Correct the value entered for the WAR or Directory URL: field.

  • Encountered exception

    An exception was encountered trying to start the new web application. Check the Tomcat 5 logs for the details, but likely explanations include problems parsing your /WEB-INF/web.xml file, or missing classes encountered when initializing application event listeners and filters.

  • Invalid application URL was specified

    The URL for the WAR or Directory URL: field that you specified was not valid. Such URLs must start with file:, and URLs for a WAR file must end in ".war".

  • Invalid context path was specified

    The context path must start with a slash character, unless you are referencing the ROOT web application -- in which case the context path must be a "/" string.

  • Context path must match the directory or WAR file name:
    If the application war or directory is deployed in your Host appBase directory and either the Host is configured with autoDeploy=true or liveDeploy=true, the Context path must match the directory name or war file name without the ".war" extension.
  • Only web applications in the Host web application directory can be deployed
    If the Host deployXML flag is set to false this error will happen if an attempt is made to install a web application directory or ".war" file outside of the Host appBase directory.
  • アプリケーションは、既にパス /foo に存在します

    現在動作している Webアプリケーションのコンテキストパスはすべて一意でなければなりません。 したがって、このコンテキストパスを使っている既存の Webアプリケーションを配備解除するか、 別のコンテキストパスにしなければなりません。

  • ドキュメントベースが存在しない、又は読めないディレクトリです

    WARファイル又はディレクトリのURL: フィールドで指定する URL は Webアプリケーションの「展開済み」バージョンを含んだこのサーバのディレクトリか、 このアプリケーションを含む Webアプリケーションアーカイブ (WAR) ファイルの絶対 URL でなければなりません。WARファイル又はディレクトリのURL: フィールドに正しい値を入れてください。

  • 例外が発生しました

    Webアプリケーション起動時に例外が発生しました。詳細については Tomcat 5 のログをチェックする必要がありますが、/WEB-INF/web.xml 解析エラーや、 アプリケーションイベントリスナやフィルタの初期化時にクラスが見つからなかった 可能性もあります。

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

    WARファイル又はディレクトリのURL: フィールドに指定した値が妥当でありません。 この URL は file: で始まらなければならず、 WARファイルの URL の場合、".war" で終わらなければなりません。

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

    コンテキストパスはスラッシュ ("/") で始まらなければなりません。 ROOT Webアプリケーションを参照している場合は例外です -- この場合は、コンテキストパスは長さ0の文字列になります。

  • コンテキストパスはディレクトリ又はWARファイル名に一致しなければいけません:
    ホストの appBase ディレクトリにアプリケーションの WARファイルやディレクトリが配備され、ホストで autoDeploy=true、 liveDeploy=true のどちらかの設定があった場合、 コンテキストパスはディレクトリ名か、 WARファイル名から拡張子".war"を省いた名前に合致しなければなりません。
  • ホストWebアプリケーションディレクトリ中のWebアプリケーションだけがインストールできます
    ホストの deployXML フラグが false になっていて、ホストの appBase ディレクトリ以外に Webアプリケーションディレクトリや ".war" ファイルをインストールしようとするとこのエラーが発生します。

This section displays information about Tomcat, the operating system of the server Tomcat is hosted on, and the Java Virtual Machine Tomcat is running in.

このセクションには Tomcat や、Tomcat がインストールされたサーバの OS、 それに Tomcat が実行されている Java仮想マシンに関する情報が表示されます。