In this tutorial I will share how to setup two tomcat nodes with FramWarDeployer, this will allow you to autodeploy all wars to all nodes automatically with session sharing cross cluster.
Tomcat Cluster configuration
Assuming that you have downloaded and installed both tomcats, you must update server.xml located in config folder of the tomcats.
Locate the Server -> Service -> Engine and set jvmRoute attribute to tomcat1 and tomcat2 like this:
|
1 |
<Engine name="Catalina" defaultHost="localhost" jvmRoute="tomcatX"> |
Locate Server -> Service -> Engine -> Host and add :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster" channelSendOptions="6"> <Manager className="org.apache.catalina.ha.session.DeltaManager" expireSessionsOnShutdown="false" notifyListenersOnReplication="true" /> <!-- <Manager className="org.apache.catalina.ha.session.BackupManager" expireSessionsOnShutdown="false" notifyListenersOnReplication="true" mapSendOptions="6" /> --> <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="auto" port="5000" selectorTimeout="100" 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" /> <Interceptor className="org.apache.catalina.tribes.group.interceptors.ThroughputInterceptor" /> </Channel> <Valve className="org.apache.catalina.ha.tcp.ReplicationValve" filter=".*\.gif|.*\.js|.*\.jpeg|.*\.jpg|.*\.png|.*\.htm|.*\.html|.*\.css|.*\.txt" /> <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer" tempDir="/Applications/apache-tomcat-deploy/tmp" deployDir="/Applications/apache-tomcat-7.0.61/webapps" watchDir="/Applications/apache-tomcat-deploy/wars" watchEnabled="true" /> <ClusterListener lassName="org.apache.catalina.ha.session.ClusterSessionListener" /> </Cluster> |
For the second tomcat you can if you choose so to use different receiver port.
Observe that there are two Manager tags, one is for BackupManager and other is for DeltaManager. Both are used for session replication.
- DeltaManager copies sessions to all other nodes
- BackupManager copies to only one node, with this difference there is a huge difference in performance when more then two nodes are included.
Check the load test results for both managers here.
FarmWarDeployer
To setup auto deployment cross cluster you need to add FarmWarDeployer , in each server.xml you should add the with corrections in deployDir and tempDir paths. With enabling watchEnabled to only one tomcat that you think of as manager.
|
1 2 3 4 5 |
<Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer" tempDir="/Applications/apache-tomcat-deploy/tmp" deployDir="/Applications/apache-tomcat-7.0.61/webapps" watchDir="/Applications/apache-tomcat-deploy/wars" watchEnabled="true" /> |
After you add/edit/remove war file in watchDir this war will be automatically deployed cross your cluster.
Load balancing with apache2
To allow load balancing with apache2 you should utilize this configuration:
|
1 2 3 4 5 6 |
<Proxy "balancer://mycluster1"> BalancerMember "http://localhost:8080/" BalancerMember "http://localhost:8081/" </Proxy> ProxyPass /tomcat balancer://mycluster1 ProxyPassReverse /tomcat balancer://mycluster1 |
Problem with it is that two consecutive requests from same user/client might not go to the same tomcat. This can be a problem depending of the manager you used to configure the cluster and of how many tomcats you have. If this is a problem you can simply setup load balancing with stickiness, you can read more on apache2 mod_proxy documentation page. Here is the example.
|
1 2 3 4 5 6 7 8 |
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED <Proxy "balancer://mycluster1"> BalancerMember "http://localhost:8080" route=1 BalancerMember "http://localhost:8081" route=2 ProxySet stickysession=ROUTEID </Proxy> ProxyPass "/tomcat" "balancer://mycluster1" ProxyPassReverse "/tomcat" "balancer://mycluster1" |
To force the server to listen to IP v4 instead of IPv6 set next line into bin/setenv.sh .
|
1 |
JAVA_OPTS="$JAVA_OPTS -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv4Addresses=true " |
I hope that this post was helpful to you.