Tomcat5 サーブレット/JSP コンテナ

MBean記述子の設定

印刷用
バージョン

はじめに

Tomcat 5は、管理性(manageability)を実現する技術としてJMX MBeansを使用しています。

Catalinaが使用するJMX MBeansに関する記述は、 org.apache.catalina.mbeans.mbeans-descriptor.xml ファイルにあります。

「ManagedBean が見つかりません」という例外を防ぐために、カスタムコンポーネント向けのMBeanに関する記述を追加する必要があります。

自作のmbean-descriptor ファイルを読み込ませる

自作のmbean-descriptor ファイルを読み込ませることによってカスタムコンポーネント(例えば Valve/Realm)を設定出来ます。 server.xml ファイル内の ServerLifecycleListener の定義にあるデフォルト設定に対して、クラスローダが使うようなセミコロン( ; )で区切られたファイルパス(スラッシュ区切り)の一覧を指すように "descriptors"属性を追加します。
<Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"
          debug="0"
          descriptors="/com/myfirm/mypackage/mbean-descriptor.xml"/>

MBean 記述を Catalina の mbean-descriptors.xml に追加する

カスタムコンポーネントの MBean に関する記述は、 org.apache.catalina.mbeans.mbeans-descriptor.xml ファイルに追加してもかまいません。

  <mbean         name="LDAPRealm"
            className="org.apache.catalina.mbeans.ClassNameMBean"
          description="自作のLDAPレルム"
               domain="Catalina"
                group="Realm"
                 type="com.myfirm.mypackage.LDAPRealm">

    <attribute   name="className"
          description="管理されるオブジェクトの完全修飾クラス名"
                 type="java.lang.String"
            writeable="false"/>

    <attribute   name="debug"
          description="このコンポーネントのデバッグレベル"
                 type="int"/>
    .
    .
    .

  </mbean>

[訳注: この文書は田中ラ・マンチャ良浩が翻訳し、高橋達男が校正しました。日本語訳に対するコメントがあれば、report@jajakarta.orgに送って下さい。]