Distributed Transaction Recovery

Some topics in the documentation pertain to features that are available only in domains that are configured to support clusters. Examples of domains that support clusters are domains that are created with the cluster profile or the enterprise profile. For information about profiles, see Usage Profiles in Sun GlassFish Enterprise Server v2.1.1 Administration Guide.

To enable cluster-wide automatic recovery, you must first facilitate storing of transaction logs in a shared file system. You can do this in one of these ways:

• Set the Enterprise Server's log-root attribute to a shared file system base directory and set the transaction service's tx-log-dir attribute to a relative path.

• Set tx-log-dir to an absolute path to a shared file system directory, in which case log-root is ignored for transaction logs.

• Set a system-property called TX-LOG-DIR in the domain.xml file to a shared file system directory.

  <server config-ref="server-config" name="server">
     <system-property name="TX-LOG-DIR" 
        value="/net/tulsa/nodeagents/na/instance1/logs" />
  </server>

Next, you must set the transaction service's delegated-recovery property to true (the default is false).

For information about setting tx-log-dir and delegated-recovery, see Configuring the Transaction Service. For information about setting log-root and other general logging settings, see Chapter 17, Configuring Logging, in Sun GlassFish Enterprise Server v2.1.1 Administration Guide. For information about system-property and the domain.xml file, see the Sun GlassFish Enterprise Server v2.1.1 Administration Reference.