From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
[[Category: Cluster]] [[Category: Concept]]
[[Category: Cluster]] [[Category: Concept]]

Latest revision as of 15:46, 2 December 2011

40px-Edit-clear.png This article requires cleanup and may refer to a legacy version of Resin.

Please visit for the most up-to-date documentation.

A single Resin cluster, showing its controlling triad

A Resin cluster is a collection of servers which do the same task. For example, all the load-balance servers form a cluster and all the application-servers in the app-tier form a cluster.


A cluster is configured in a <cluster> tag in the resin.conf.

  • A set of servers, each with its own cluster port for cluster communication
  • A set of virtual hosts, each containing several web-apps serving pages
  • Shared resources like databases


For example, if you have two servers and a single virtual host "", a minimal resin.xml might look like the following:


<resin xmlns=""
  <resin:import path="${__DIR__}/app-default.xml"/>
  <cluster id="app-tier">
     <server id="a" address="" port="6800"/>
     <server id="b" address="" port="6800"/>

    <host id="">

        <web-app-deploy path="webapps"/>
  • <resin:import> defines standard behavior like *.jsp, *.php, the WEB-INF, and normal file serving. If you delete the app-default.xml import, your server will not work normally.
  • <cluster> defines our servers and the virtual host
  • <server> defines our static servers, i.e. the servers we'll always have available. The first three form the server triad
  • <host> defines our single virtual host
  • <root-directory> defines the location of the virtual host
  • <web-app-deploy> specifies an auto-deploy directory for web-apps. Any *.war or directory created in webapps automaticaly creates a new application
Personal tools