Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction and Roadmap

• Document Scope and Audience
• Guide to this Document
• Related Documentation
• Samples and Tutorials
  • Avitek Medical Records Application (MedRec) and Tutorials
• New and Changed Features in This Release

2 Introducing Transactions

• Overview of Transactions in WebLogic Server Applications
  • ACID Properties of Transactions
  • Supported Programming Model
  • Supported API Models
  • Distributed Transactions and the Two-Phase Commit Protocol
  • Support for Business Transactions
• When to Use Transactions
• What Happens During a Transaction
  • Transactions in WebLogic Server EJB Applications
    • Container-managed Transactions
    • Bean-managed Transactions
  • Transactions in WebLogic Server RMI Applications
• Transactions Sample Code
  • Transactions Sample EJB Code
    • Importing Packages
    • Using JNDI to Return an Object Reference
    • Starting a Transaction
    • Completing a Transaction
  • Transactions Sample RMI Code
    • Importing Packages
    • Using JNDI to Return an Object Reference to the UserTransaction Object
    • Starting a Transaction
    • Completing a Transaction

3 Configuring Transactions

• Overview of Transaction Configuration
• Configuring JTA
  • Unregister Resource Grace Period
  • Additional Attributes for Managing Transactions
  • XA Transaction Cluster Affinity
• Using Transaction Log Files to Recover Transactions
  • Using the Default Persistent Store
    • Setting the Path for the Default Persistent Store
    • Setting the Default Persistent Store Synchronous Write Policy
  • Using a JDBC TLOG Store
  • Last Logging Resource
  • XA Transactions without Transaction TLog Write
    • What is a Determiner Resource?
      • Best Practices When Using Determiner Resources
    • Configuring XA Transactions without TLogs
      • How to Configure a Determiner
      • How to Remove a Determiner
      • Limitations and Considerations When Configuring Transactions without TLogs
• Read-Only, One-Phase Commit Optimizations
  • Configuring Read-only, One-phase Commit Optimization and Two-phase Commit Disablement
  • Monitoring Read-only, One-phase Transaction Statistics

4 Managing Transactions

• Monitoring Transactions
• Handling Heuristic Completions
• Moving a Server
• Abandoning Transactions
  • Tuning Transaction Processing
• Manually Resolving Current (Inflight) Transactions
  • Manual Commit and Rollback Options
• Transaction Recovery After a Server Fails
  • Transaction Recovery Service Actions After a Crash
    • Clustering Failover When Using Apache With the WebLogic Proxy Plug-in
  • Recovering Transactions For a Failed Non-Clustered Server
  • Recovering Transactions For a Failed Clustered Server
    • Server Migration
    • Automatic Transaction Recovery Service Migration
    • Manual Transaction Recovery Service Migration
      • What Occurs During Transaction Recovery Service Migration
    • Managed Server Independence
    • Limitations of Migrating the Transaction Recovery Service
    • Preparing to Migrate the Transaction Recovery Service
    • Constraining Servers to Which the Transaction Recovery Service Can Migrate
    • Viewing Current Owner of the Transaction Recovery Service
    • Manually Migrating the Transaction Recovery Service to the Original Server
  • How to Remove Transaction Records
    • How to Remove the TLog in the LLR Database
    • How to Remove the TLog Files from the Default Store
    • How to Remove the TLog from a JDBC TLog Store

5 Using Transaction Guard

• Overview of Transaction Guard
• Enabling Transaction Guard
  • Enabling Transaction Guard for WebLogic Data Sources
  • Enabling Transaction Guard for Database Service
• Data Source Statistics for Transaction Guard

6 Transaction Service

• About the Transaction Service
• Capabilities and Limitations
  • Lightweight Clients with Delegated Commit
  • Client-initiated Transactions
  • Transaction Integrity
  • Transaction Termination
  • Flat Transactions
  • Relationship of the Transaction Service to Transaction Processing
  • Multithreaded Transaction Client Support
  • Transaction Id
  • Transaction Name and Properties
  • Transaction Status
  • Transaction Statistics
  • General Constraints
• Transaction Scope
• Transaction Service in EJB Applications
• Transaction Service in RMI Applications
• Transaction Service Interoperating with OTS
  • Server-Server 2PC
  • Client Demarcated Transactions

7 Transaction Recovery Spanning Multiple Sites or Data Centers

• Understanding XA Transaction Recovery in Disaster Recovery
• Active-Active XA Transaction Recovery
  • Requirements for XA Transactions in an Active-Active Recovery Solution
  • Limitations and Considerations for Cross-Site XA Transaction Recovery
  • Example Active-Active Domain Configuration for XA Transaction Recovery
  • Configuring MBean Attributes for Cross-Site XA Transaction Recovery
• Active-Passive XA Transaction Recovery
  • Example Active-Passive Domain Configuration for XA Transaction Recovery
• Active-Active Stretch Cluster XA Transaction Recovery
  • Example Active-Active Stretch Cluster for XA Transaction Recovery
• Additional Information on Maximum Availability Architecture

8 Configuring Secure Inter-Domain and Intra-Domain Transaction Communication

• What is Secure Inter-Domain and Intra-Domain Transaction Communication?
• Requirements for Transaction Communication
  • How to Determine the Communication to Use for Inter-Domain Transactions
• Configuring Secure Channel Communication
  • Security Interoperability Mode
    • Configuring Security Interoperability Mode
    • Establish Domain Trust
  • Cross Domain Security
    • Important Considerations When Configuring Cross Domain Security
    • Cross Domain Security is Not Transitive
    • Adding Domains to the Exclude List Based on Transaction Participation
  • Configuring a Combination of Cross Domain Security and Security Interoperability Mode

9 Java Transaction API and Oracle WebLogic Extensions

• JTA API Overview
• Oracle WebLogic Extensions to JTA

10 Logging Last Resource Transaction Optimization

• About the LLR Optimization Transaction Optimization
• Logging Last Resource Processing Details
• LLR Database Table Details
  • LLR Table Transaction Log Records
• Failure and Recovery Processing for LLR
  • Coordinating Server Crash
  • JDBC Connection Failure
  • LLR Transaction Recover During Server Startup
  • Failover Considerations for LLR
• Optimizing Performance with LLR
  • Optimizing Transaction Coordinator Location
  • Varied Performance for Read-Only Operations Through an LLR Data Source
  • Dedicating LLR Tables by Data Source
    • Limitations
• First Resource Commit Ordering

11 Transactions in EJB Applications

• Before You Begin
• General Guidelines
• Transaction Attributes
  • About Transaction Attributes for EJBs
  • Transaction Attributes for Container-Managed Transactions
  • Transaction Attributes for Bean-Managed Transactions
• Participating in a Transaction
• Transaction Semantics
  • Transaction Semantics for Container-Managed Transactions
    • Transaction Semantics for Stateful Session Beans
    • Transaction Semantics for Stateless Session Beans
    • Transaction Semantics for Entity Beans
  • Transaction Semantics for Bean-Managed Transactions
    • Transaction Semantics for Stateful Session Beans
    • Transaction Semantics for Stateless Session Beans
• Session Synchronization
• Synchronization During Transactions
• Setting Transaction Timeouts
• Handling Exceptions in EJB Transactions

12 Transactions in RMI Applications

• Before You Begin
• General Guidelines

13 Using JDBC XA Drivers with WebLogic Server

• Using Oracle Thin/XA Driver
  • Set the Environment for the Oracle Thin/XA Driver
    • Configure WebLogic Server
    • Enable XA on the Database Server
  • Oracle Thin/XA Driver Configuration Properties
• Using Other XA Drivers
  • Using WebLogic-branded Data Direct Drivers
  • Additional Considerations

14 Coordinating XAResources with the WebLogic Server Transaction Manager

• Overview of Coordinating Distributed Transactions with Foreign XAResources
• Registering an XAResource to Participate in Transactions
• Enlisting and Delisting an XAResource in a Transaction
  • Standard Enlistment
  • Dynamic Enlistment
  • Static Enlistment
• Commit processing
• Recovery
• Resource Health Monitoring
• Java EE Connector Architecture Resource Adapter
• Implementation Tips
  • Sharing the WebLogic Server Transaction Log
  • Transaction global properties
  • TxHelper.createXid
• Changes in the Resource Registration Name
• FAQs
• Additional Documentation about JTA

15 Participating in Transactions Managed by a Third-Party Transaction Manager

• Overview of Participating in Foreign-Managed Transactions
• Importing Transactions with the Client Interposed Transaction Manager
  • Get the Client Interposed Transaction Manager
  • Get the XAResource from the Interposed Transaction Manager
  • Cluster-wide Recovery
  • Limitations of the Client Interposed Transaction Manager
• Importing Transactions with the Server Interposed Transaction Manager
  • Get the Server Interposed Transaction Manager
  • Limitations of the Server Interposed Transaction Manager
• Transaction Processing for Imported Transactions
  • Transaction Processing Limitations for Imported Transactions
• Commit Processing for Imported Transactions
• Recovery for Imported Transactions
• Transactions that Span Transaction Manager Systems

16 Troubleshooting Transactions

• Overview
• Troubleshooting Tools
  • Exceptions
  • Transaction Identifier
  • Transaction Name and Properties
  • Transaction Status
  • Transaction Statistics
  • Transaction Monitoring
  • Debugging JTA Resources
    • Enabling Debugging
    • Enable Debugging Using the Command Line
    • Enable Debugging Using the WebLogic Server Administration Console
    • Enable Debugging Using the WebLogic Scripting Tool
    • Changes to the config.xml File
    • JTA Debugging Scopes