Start Using Terracotta

Windows

Download and execute the Windows installer.

All other Platforms

Download the generic package and unpack into a directory of your choosing.

[!scrshot-download.png|orgsite:width=250px!]

The Welcome Application provides you with all the information you need to get started with Terracotta.

The Welcome Application allows you to:

• Launch the Samples Application

• Launch the Admin Console

• Provides documentation for the Eclipse Plug-In

• Provides Tutorial and Quick Start Guide information

Each of the Terracotta Modules:

• POJO

• Sessions

• Spring

can be reached from the Welcome Application. The tab at the top of the application controls which Module the Welcome Application will display.

Try changing the tab, to get information about the other Terracotta Modules!

Windows

Launch the Welcome Application from the Windows Start Menu.

All Other Platforms

From the directory where you unpacked the Terracotta installation, execute the welcome.sh script:

$ ./welcome.sh

(Note: in versions prior to 2.5 welcome.sh is located in bin)

From the Welcome Application, pick the "Sample Applications" link. This will launch the Sample Applications Launcher.

The Sample Applications Launcher:

• Automatically Launches a Terracotta Server

• Gives you instant access to sample applications (such as JTable, Shared Editor, etc.)

You can now try out some of Terracotta's Demonstration Applications. Try JTable, or Shared Editor, and see Terracotta DSO Clustering in action!

To launch sample apps:

• Click the link for the app - such as Shared Editor

• Click the link again to bring up two instances of the application

• Change some data in the application - for example draw some circles and squares in the Shared Editor

• Close one or both of the Shared Editors

• Re-launch one or both of the Shared Editors. Notice that the state is saved!

The Admin Console is a powerful tool. When you are working with your own application, it will help you to ensure that you have configured everything correctly to run with Terracotta. At runtime, it allows you to see everything that is happening in the cluster.

The Admin Console lets you view:

• Object Graph - view the entire picture of objects that are being shared in the JVM. In realtime, drill down to see the exact values of the data.

• Clients - see which clients are connected in the cluster

• Transaction Rate - see graphs of the transaction rate over time

• and more...