...
These instructions are out of date. They are for the prototype. There is currently a Terracotta plugin for Geronimo written by Jeff Genender, but the docs haven't been prepared for it. Those are coming soon. —Orion Letizi, March 12, 2008
...
Note that Open Terracotta is not an Apache project and is not currently available under the Apache license but rather under the Terracotta Public License. You should determine if the licensing is correct for your needs.
...
Install Terracotta Server Anchor installterracotta installterracotta
Terracotta needs to be installed on one machine that will serve as the Terracotta Server. The Terracotta server will be responsible for maintaining session state and assuring that it is accurately reflected in each of the Geronimo cluster members.
Download the Terracotta Sessions bundle and run the Installer. This example requires "Open Terracotta 2.2.1 Stable 2" or higher.
Install Geronimo ServerAnchor installgeronimo
The Geronimo Application Server needs to be installed on each machine that is to be clustered. The example in this article will install Geronimo on two separate machines (cluster members).
...
Note that the same version release of Geronimo must be installed on each machine to be clustered. Mixing versions of Geronimo is not currently supported by Terracotta.
...
Install Terracotta ClientAnchor installterracottaclient
The Terracotta client needs to be installed on each machine that contains a Geronimo cluster member. Currently, the same install bundle includes both the Terracotta server and client. So, it is possible to run the Terracotta Server and Terracotta Client on the same machine with a common installation .
...
Update Terracotta configuration file Anchor configtc configtc
The tc-config.xml file identifies which context-roots are to be clustered as well as the data types that are to be placed in the HttpSession.
...
Change the tc-config.xml file to look similar to the following example. Note that the tc-config.xml example below only shows the xml items that are to be updated. Other portions of that xml file should remain unchanged. Remember to change the IP address in the example below to the address of the Terracotta Server.
...
...
Start Terracotta Server Anchor starttc
Start the Terracotta server specifying the location of the tc-config.xml file that you just updated.
...
Start Terracotta Client and Geronimo ServerAnchor startgeronimo startgeronimo
Open Terracotta supports a variety of JVMs and each one requires a unique boot jar be present in the bootclasspath when launching the Geronimo server. The example below is using the Windows JVM that is present in the Terracotta Sessions Package. It is possible to use other JVMs, though a different boot jar will likely need to be created. Also some of the launch arguments in the script below were obtained by issuing the dso-env script in c:\Terracotta\terracotta-2.2.1\sessions\bin\ directory. You should issue this command on your system to find the arguments that are appropriate for your environment.
...
Here is an example startup on a Windows Machine:
...
...
Install Web Application on each Geronimo cluster member Anchor installapp installapp
Use the Geronimo admin console to install the appropriate example application to each of the Geronimo installations.
...
Setup Load Balancing and FailoverAnchor installwebserver
Now you are ready to setup the Load Balancer. We recommend using Apache HTTP server and mod_jk for this example.
...
Testing Load Balancing and FailoverAnchor test test
Once you get Apache HTPP Server and mod_jk setup correctly. You can test load balancing and failover by requesting the following URL with your favorite Web browser. Of course, replace YourHost with the actual host name or IP address.
...
When testing using a web browser, make sure that you erase cookies and cached pages between test cases. Browser caching can cause confusion when testing.
...
Use the Terracotta admin consoleAnchor tcadmin tcadmin
The Terracotta Admin console can also be used to verify that session data is being properly replicated in the Terracotta Server.
...