tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <>
Subject [Tomcat Wiki] Update of "FAQ/Clustering" by TimFunk
Date Wed, 05 Dec 2007 20:20:49 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tomcat Wiki" for change notification.

The following page has been changed by TimFunk:

The comment on the change is:
Missing from the port

New page:
== Preface ==
This page discusses cluster- and clustering-related questions. Please make sure to read the
Clustering HowTo page in the main Tomcat documentation bundle as well.

== Questions ==
'''Can I configure a cluster at the Engine level?'''

Yes, beginning with Tomcat 5.5.10 you can configure clusters at both the Engine and Host levels.
This helps support clustering for web hosting companies.

'''Show me a simple cluster configuration example.'''

For Tomcat 5.5.10 and later:
<Cluster className="org.apache.catalina.cluster.tcp.SimpleTcpCluster" defaultMode="true"

'''How do I turn on transport logging?'''

* Use "org.apache.catalina.cluster" as logger category and switch to info, debug or trace
as log level.
* Configure the clusterLog attribute (logging category) to get and send and receive message

'''How do I use JMX to monitor the cluster?'''

With Java 5 you can use the jconsole application to look inside the runnnig cluster: please
see the JMX configuration section in the Clustering HowTo document.
In fastasyncmode replication mode you can got more information with sender attributes doProcessingStats="true"
and queueDoStats="true". Finally, with the new JMX remote ant task you can access the state
and call operations.

'''Can I pause the message sending?'''

Yes, the async senders buffer the messages, but make sure the membership ping is active. With
fastasyncqueue mode you can limit the max queue size.

'''Can I add more senders (pooled mode)?'''

Yes, with sender attribute maxPoolSocketLimit="40" you can have more than the default 25 sockets
to transfer more parallel messages.

'''What happens when I pull the network cable?'''

The other members will remove the instance from the cluster, but when you insert the cable
again, the Tomcat instance might have completely flipped out. This is because the OS might
start using 100% of the CPU when a multicast message is sent. There has not yet been a good
solution for this, I will let you know when I have come up with one. (pero: I test this and
I works correct with java 5 and exists when you use the cluster with JDK 1.4.x)

'''At my windows laptop without network my cluster doesn't work?'''

The Membership attribute mcastBindAddress="" must be set!

'''The cluster dosen't work under linux with two nodes at two boxes?'''

Check the the following:
* Is your network interface enabled for multicast? ifconfig eth0 MULTICAST
* Exists a multicast route to your network interface? route add -host dev eth0
* Is your firewall active? Then check that multicast port is on your UDP open list and the
receiver TCP port is also for both machines open!

'''I get "localhost" rather than "eth0" or another interface when using tcpListenAddress="auto".'''

Change /etc/hosts so that the localhost domain resolves to the actual IP address of the NIC,
eth0. Please see Bugzilla for more. 

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message