Release Notes

THIS IS ARCHIVE DOCUMENTATION FOR TERRACOTTA v. 3.0.

For the current release, see the current DSO documentation ยป

Release: 3.0.1
Publish Date: May, 2009

What's New in Terracotta 3.0

To see an overview and description of new features in Terracotta 3.0, see [What's New - Terracotta 3.0 »]

Upgrading to Terracotta 3.0

Existing Terracotta users who are upgrading to Terracotta 3.0 from an earlier version should be aware of the following:

  • Support has been added for new platforms, while some platforms are no longer supported. See Added Platform Support and Platforms No Longer Supported for more information.
  • HTTP sessions is now implemented by using a container-specific TIM. For more information, see [the integration guide for your web container].
  • The JMX Util TIM for cluster events has be deprecated in favor of a Java-based events API. See Terracotta Cluster Events for more information.
  • The Terracotta Administrator Console has been replaced by the Terracotta Developer Console. In the Terracotta kit, admin.sh and admin.bat have been replaced by dev-console.sh and dev-console.bat. Scripts that depend on admin.sh and admin.bat should be updated.
  • The Maven command maven tc:admin should be replaced by maven tc:dev-console.
  • To run the Terracotta Server Array, JAVA_HOME must be set.

Summary of Changes in 3.0.1

Bug Fixes

View Jira

Summary of Changes in 3.0.0

Bug Fixes

View Jira

New Features
  • CDV-1192 Terracotta Server Array Striping
  • CDV-1194 Terracotta Developer Console Updates
  • CDV-1195 Sessions Implementations move to the Terracotta Forge
  • CDV-272 Remove Classloader Issues Webapp to Webapp
Additional Improvements
  • New Java installer for all platforms
  • Roll back for dirty DB backups
  • Allow "manual" Session locking
  • Jetty is now bundled in kit and used for all Terracotta Demos.
  • Ability to gather statistics in the Passive Terracotta Server
  • Enhancements to tim-get for ease of use
Added Platform Support
  • RHEL5
  • WebLogic10 MP1 and MP3
Platforms No Longer Supported

The following Platforms are no longer supported in Terracotta 3.0 and greater

  • WebLogic 8.x
  • JDK 1.4.x
  • WebsphereCE 1.2/Geronimo 1.1.1
  • Hibernate 3.1.2 support
  • EhCache 1.2.4
  • JBoss 3.2.8

Terracotta Server Known Issues

  • CDV-1103 Issues with Terracotta nature when sharing projects in Eclipse
    • Workaround: Remove and then re-add the Terracotta Nature to work around the problem
  • CDV-912 On Mac OS there may be issues where the Terracotta Sample Server remains running after the machine goes into a dormant state or if the window is closed using <cmd>Q or the menu bar.
    • Workaround: Use the file menu or the close box to exist the Sample Launcher.
  • CDV-749 Long file names are truncated when tar used on Solaris.
    • Workaround: On Solaris the gtar command should be used.
  • CDV-538 Redeployed web applications will almost certainly run into ClassCastExceptions for shared application-level objects.
  • This release supports the use of the THashMap and THashSet classes from the trove library http://trove4j.sourceforge.net. Version 1.1b5 is officially supported in this release. THashMap and THashSet support the use of user-customized hashing strategies through the TObjectHashingStrategy interface. When distributing THashMap/THashSet instances, only the default hashing strategy is supported. Any custom hash strategy will not be honored across the cluster.
  • OOME in Permspace
    SEVERE: Error deploying web application directory search
    org.apache.commons.logging.LogConfigurationException:
    java.lang.OutOfMemoryError: PermGen space (Caused by java.lang.OutOfMemoryError: PermGen space) at
    org.apache.commons.logging.impl.LogFactoryImpl.newInstance(LogFactoryImpl.java:538) at ...
    

    Increase the permspace by passing the correct jvm arguments.

  • Changes to the default batch size made to improve memory performance may in some cases affect a class of performance tests. Please contact support@terracottatech.com if this occurs.

Forge Known Issues

  • FORGE-260 Cannot fault CGLIB instances.
    • Workaround: tim-cglib should only be used with hibernate.
  • FORGE-270 Setting timeToIdleSeconds wth timeToLiveSeconds in ehcache.xml causes excess TPS.
    • Workaround: Do not use these settings in conjunction with one another.
  • FORGE-214 Maven-surefire-plugin issue on windows. Issue filed against the surefire plugin SUREFIRE-461.
    • Workaround: The workaround is to instruct Maven to skip the test phase of the build when installing the TIM. This is done by passing the following on the command-line: -Dmaven.test.skip=true

Labels

 
(None)