Introduction

はじめに

Tomcat ships with a web application (by default installed at context path /manager) that facilitates installing, starting, stopping, removing, listing information, and reloading (that is, forcing a reload of all class files without removing the application from service) of other web applications that are running in the same virtual host as the Manager application itself. This application is suited to scripted operation, because it can be executed from any client program that can issue HTTP requests. As such, it is complementary to other administrative applications that have a more human-oriented user interface.

Tomcat出荷しますそれがインストールして、始めて、止めて、情報をリストして、削除して、仮想同じものにおいて実行しているWebアプリケーションがマネージャー・アプリケーションとして主催する他の、再ロードする（すなわち、全ての再ロードを強制することは、サービスからアプリケーションを削除することなくファイルを分類します）のを容易にするWebアプリケーション（デフォルトで、コンテキスト・パス/managerでインストールされまして）で。 HTTP要求を出すことができるどんなクライアント・プログラムからでも、それが実行されることができるので、このアプリケーションは、スクリプトを書かれた操作に適しています。 このように、よりhuman-orientedされたユーザー・インタフェースを持つ他の管理上のアプリケーションに、それは相補的です。

WARNING - As of the Tomcat 4.0 milestone 2 release, there is a bug in the operation of the "deploy" command that prevents deploying, undeploying, and then redeploying an application from the same URL for a web application archive (WAR) file. To work around this, either redeploy the application from a different WAR file URL, or deploy from an unpacked directory (on the same server that Tomcat is running on).

WARNING - Tomcat 4.0 マイルストーン2リリース現在、バグが、undeployingして、展開するのを妨げる「展開」命令の操作においてす、それから、Webアプリケーションのために同じURLからアプリケーションを移動させることは（WAR）ファイルをアーカイブします。 対処するにこれが異なるWARファイルURLからのアプリケーションを移動させるか取り出されたディレクトリ（Tomcatが進行している同じサーバーで）から展開すること。

Available Commands

利用できるコマンド

The Manager application servlet responds to action requests that are encoded as the extra path information, and request parameters, of HTTP requests made to the manager application. The following command descriptions assume that you have installed the Manager application on context path /manager on your local host installation of Tomcat.

Managerアプリケーションservletは、Managerアプリケーションに対するHTTP要求の、 特別なパス情報と要求パラメータとしてコード化される動き要求に応じます。 記述があなたがTomcatのインストールしたローカルホスト上でManagerアプリケーションをコンテキスト・パス/manager上にインストールしたと仮定します。

• http://localhost:8080/manager/install?path=/xxx&war=yyy - Install the web application whose WAR file (or directory containing the unpacked application) is present at URL yyy, and attach it to context path /xxx. See below for valid syntax options for the web applcation archive URl. If the URL of an actual WAR file is specified, the WAR will be automatically expanded into a directory underneath the application base for this virtual host.
• http://localhost:8080/manager/install?path=/xxx&war=yyy - WARファイル（または取り出されたアプリケーションを含んでいるディレクトリ）がURL yyyで存在するWebアプリケーションをインストールしてください、そして、それをコンテキスト・パス/xxxに付けてください。 Web applcationアーカイブURlのための有効な構文オプションのための下記参照。 実際のWARファイルのURLが指定されるならば、WARはこの仮想ホストのためにアプリケーション・ベースの下にディレクトリに自動的に展開されることになります。
• http://localhost:8080/manager/list - List the context paths of all currently installed web applications for this virtual host. Each context will be listed with the following format path:status:sessions. Where path is the context path. Status is either running or stopped. Sessions is the number of active Sessions.
• http://localhost:8080/manager/list - この仮想ホストのために全ての現在インストールされたWebアプリケーションのコンテキストパスをリストしてください。 各コンテキストは、path:status:sessions形式に従ってリストされることになります。 ここでパスは、コンテキスト・パスです。 statusは、runningまたはstoppedです。 sessionsは、たくさんの活発なセッションです。
• http://localhost:8080/manager/reload?path=/xxx - Cause the web application installed at context path /xxx to reload all its associated Java classes, even if automatic reloading is disabled.
• http://localhost:8080/manager/reload?path=/xxx - コンテキスト・パス/xxxでインストールされるWebアプリケーションが全てのその関連されたJavaクラスを再ロードする、たとえ自動再ロードが無効でであるとしても。
• http://localhost:8080/manager/remove?path=/xxx - Cause the web application installed at context path /xxx to be gracefully shutdown and delete the web application directory and files.
• http://localhost:8080/manager/remove?path=/xxx - コンテキスト・パス/xxxでインストールされるWebアプリケーションが 美しくシャットダウンであって、Webアプリケーション・ディレクトリとファイルを削除する。
• http://localhost:8080/manager/sessions?path=/xxx - List session information about the web application attached to context path /xxx for this virtual host.
• http://localhost:8080/manager/sessions?path=/xxx - Webアプリケーションに関するリスト・セッション情報は、この仮想ホストのためにコンテキスト・パス/xxxに付属しました。
• http://localhost:8080/manager/start?path=/xxx - Start the web application attached to context path /xxx for this virtual host.
• http://localhost:8080/manager/start?path=/xxx - この仮想ホストのためにコンテキスト・パス/xxxに付けられるWebアプリケーションを開始する。
• http://localhost:8080/manager/stop?path=/xxx - Stop the web application attached to context path /xxx for this virtual host.
• http://localhost:8080/manager/stop?path=/xxx - この仮想ホストのためにコンテキスト・パス/xxxに付けられる Webアプリケーションを停止する。

Use path=/ for the ROOT context.

ROOTコンテントのためには、path=/ を使用します。

The syntax of the URL for a web application archive must conform to one of the following patterns to be successfully deployed:

WebアプリケーションアーカイブのためのURL文法は、配置が成功した 以下のパターンのうちの1つに従わなければなりません:

• file:/absolute/path/to/a/directory - You can specify the absolute path of a directory that contains the unpacked version of a web application. This directory will be attached to the context path you specify without any changes.
• file:/absolute/path/to/a/directory - あなたは、Webアプリケーションの取り出されたバージョンを含むディレクトリの絶対パスを指定することができます。 このディレクトリは、あなたがどんな変更点なしででも指定するコンテキスト・パスに付けられることになります。
• jar:file:/absolute/path/to/a/warfile.war!/ - You can specify a URL to a local web application archive file. The syntax must conform to the rules specified by the JarURLConnection class for a reference to an entire JAR file.
• jar:file:/absolute/path/to/a/warfile.war!/ - あなたは、ローカルWebアプリケーション・アーカイブ・ファイルに、URLを指定することができます。 構文は、全てのJARファイルの参照のために、JarURLConnectionクラスによって指定される規則に従わなければなりません。
• jar:http://hostname:port/path/to/a/warfile.war!/ - You can specify a URL to a remote (HTTP-accessible) web application archive file. The syntax must conform to the rules specified by the JarURLConnection class for a reference to an entire JAR file.
• jar:http://hostname:port/path/to/a/warfile.war!/ - あなたは、リモート（HTTP-accessibleな）Webアプリケーション・アーカイブ・ファイルに、URLを指定することができます。 構文は、全てのJARファイルの参照のために、JarURLConnectionクラスによって指定される規則に従わなければなりません。

For ease of script processing, the response generated by the Manager application servlet is rendered with content type text/plain. The first line of the response starts with "OK - " or "FAIL - " depending on whether the requested operation was successful or not, followed by a descriptive summary of the operation that took place, or the error that prevented the requested operation from taking place.

スクリプト処理の容易さのために、マネージャー・アプリケーションservletによって発生する応答は、内容タイプtext/plainでされます。 応答の最初の行は始めます「OK　- 」、あるいは、「FAIL - 」、要請された操作が成功していたかどうかについて、次第であることは起こった操作または要請された操作が起こるのを妨げたエラーの記述的な要約によって、追従しました。

Security Considerations

セキュリティ考慮

Obviously, the Manager application can have significant impacts on a running instance of Tomcat. Therefore, it should not be (and is not) enabled by default. The following security considerations apply to this application.

明らかに、Managerアプリケーションは、Tomcatの実行しているインスタンスに対する重要な衝撃を持つことができます。 したがって、それがあるはずではありません（そして、ある）デフォルトで可能にします。 以下のセキュリティ考慮は、このアプリケーションにあてはまります。

• By default, the manager application is restricted by a security constraint that looks for users with an assigned role of manager. There are no such users in the default $CATALINA_HOME/conf/tomcat-users.xml file, so by default no one can execute any of the commands supported by the Manager application.
• デフォルトで、managerの割り当てられた役割で、ユーザーを捜すセキュリティ制約によって、マネージャー・アプリケーションは、制限されます。 そのようなユーザーがデフォルトの$CATALINA_HOME/conf/tomcat-users.xmlファイルの中にいませんので、デフォルトで、誰もマネージャー・アプリケーションで支えられる命令の何も実行することができません。
• The Manager application servlet will refuse to initialize itself if it is invoked by the invoker servlet (via a context relative path like /servlet/org.apache.catalina.servlets.ManagerServlet). You MUST install a <servlet-mapping> element in a web application deployment descriptor (or use the default web application shipped with Tomcat) to use this functionality.
• それがinvoker servlet（/servlet/org.apache.catalina.servlets.ManagerServletのようなコンテキスト関連しているパスを通して）によって呼び出されるならば、マネージャー・アプリケーションservletはそれ自体を初期化することを拒否することになります。 あなた、MUSTは、Webアプリケーション配備記述で< servlet-mapping> 要素をインストールします（あるいは、デフォルトのWebアプリケーションを使います出荷しましたTomcatで）この機能を使います。
• You SHOULD ensure that the Manager application is always protected by a security constraint so that user login is required. To facilitate scripting, the default login configuration for the Manager application uses HTTP BASIC authentication, because client programs can easily determine the content of the Authorization header they should send, once the assigned username and password are known.
• あなたは、ユーザー・ログインが必要であるように、Managerアプリケーションが常にセキュリティ制約によって保護されていることを確実にすべきです。 スクリプトを書くことを容易にするため、デフォルトでは、ManagerアプリケーションがHTTP基本認証を使用してログインする設定なので、クライアント・プログラムが簡単に彼らが送るはずであるAuthorizationヘッダの内容を決定することができるので、かつて、割り当てられたユーザー名とパスワードは知られています。