Tomcat 7 のFarmWarDeployer

Tomcat 7 でクラスタを組む際、デフォルトのserver.xmlのClusterをコメントアウトして設定しようと思ったら妙なログが出た。微妙にハマった。

Feb 07, 2013 10:26:51 PM org.apache.catalina.ha.deploy.FarmWarDeployer start
SEVERE: FarmWarDeployer can only work as host cluster subelement!

あれ? と思って見ると、デフォルトの配布物のserver.xmlではClusterは の要素関係で、以下のように書かれてコメントアウトされている。

<!--
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
-->

これを、Clustering/Session Replication HOW-TOの以下のような感じで置き換えることが多いだろう。

<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"
                 channelSendOptions="8">

          <Manager className="org.apache.catalina.ha.session.DeltaManager"
                   expireSessionsOnShutdown="false"
                   notifyListenersOnReplication="true"/>

          <Channel className="org.apache.catalina.tribes.group.GroupChannel">
            <Membership className="org.apache.catalina.tribes.membership.McastService"
                        address="228.0.0.4"
                        port="45564"
                        frequency="500"
                        dropTime="3000"/>
            <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"
                      address="192.168.2.102"
                      port="4000"
                      autoBind="100"
                      selectorTimeout="5000"
                      maxThreads="6"/>

            <Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter">
              <Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender"/>
            </Sender>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor"/>
          </Channel>

          <Valve className="org.apache.catalina.ha.tcp.ReplicationValve"
                 filter=""/>
          <Valve className="org.apache.catalina.ha.session.JvmRouteBinderValve"/>

          <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer"
                    tempDir="/tmp/war-temp/"
                    deployDir="/tmp/war-deploy/"
                    watchDir="/tmp/war-listen/"
                    watchEnabled="false"/>

          <ClusterListener className="org.apache.catalina.ha.session.JvmRouteSessionIDBinderListener"/>
          <ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/>
</Cluster>

が、この際にFarmWarDeployerが下ではなく、下にあると怒られているわけだ。エラーメッセージの通りに、server.xml内でもうちょっと下、の配下に来るようにを丸ごと移動して書き直したら正常に稼働するようになった。

うーん、標準添付のサンプル通りにやろうとするとハマるとはなんという地雷。ちなみにTomcatクラスタリングとセッション共有は、以前に http://homepage1.nifty.com/y-osumi/works/code/tomcat_cluster/ というページに書いたのでそちら参照。