 ===============================
|       SampleCluster3	        |
 ===============================

Date: 14/10/08
Version: v1.0

Application Overview:
----------------------

This application aims to demonstrate the JOnAS's clustering features in a 'pedagogic' way:

- load balancing at Apache level
	. mod_jk
- failover at the web level (Tomcat)
	. HTTP session replication
- load balancing at EJB3 level
	. CMI

- failover at EJB level
	. Stateful EJB3 replication

For a complete description of the application and the cluster configuration
-----------------------------------------------------------------------------

See http://jonas.ow2.org, documentation


Compiling this application:
----------------------------

A. for one JOnAS  instance:
  Use the Ant build tool:
    ant install

  The application file sample-cluster2.ear is copied to your $JONAS_BASE/apps folder

B. for more JOnAS instances:

  Use the Ant build tool:
    ant ear


Running the application:
-------------------------

A. for one JOnAS instance:

 1) start JOnAS:
     jonas start -n node0

 2) deploy the application:
     jonas admin -a sample-cluster3.ear

 3) test the application
     use your webbrowser
      url : http://<hostWebApplicationAddr>/sampleCluster3

 4) stop JOnAS:
     jonas stop -n node0

B. for more JOnAS instances:

   Remark: X is the number of the node in the cluster

 1) start each JOnAS instance:
       jonas start -n nodeX -Ddomain.name=sampleCluster2Domain

 2) deploy the wevApp and the EJBs on the JOnAS instances
            jonas admin -a sample-cluster2.ear -n nodeX

 3) test the application
       use your webbrowser
        url: http://<hostWebApplicationAddr>/sampleCluster3

 4) stop each JOnAS instance:
       jonas stop -n nodeX

---------------------------
Good luck!!
=================================================================================
