Configuring and Managing WebLogic Store-and-Forward
|
 |
 |
|
 |
 |
Introduction and Roadmap
This section describes the contents and organization of this guide—Configuring and Managing WebLogic Store-and-Forward.
- Document Scope and Audience
- Guide to This Document
- Related Documentation
- Samples and Tutorials for the System Administrator
- New and Changed SAF Features In This Release
Document Scope and Audience
This document is a resource for system administrators responsible for configuring, managing, and monitoring the WebLogic Store-and-Forward service for use with WebLogic JMS and Web Services Reliable Messaging (WSRM).
The topics in this document are relevant to production phase administration, monitoring, or performance tuning topics. This document does not address the pre-production development or testing phases of a software project. For links to WebLogic Server documentation and resources for these topics, see Related Documentation.
It is assumed that the reader is familiar with WebLogic Server system administration. This document emphasizes the value-added features provided by WebLogic SAF and key information about how to use WebLogic Server features and facilities to maintain WebLogic Server in a production environment.
Guide to This Document
- This chapter, Introduction and Roadmap, introduces the organization of this guide.
- Understanding the Store-and-Forward Service, explains the Store-and-Forward service concepts and features, and describe how they work with WebLogic Server.
- Configuring SAF for JMS Messages, describes how to configure the Store-and-Forward resources for JMS messages.
- Monitoring and Managing SAF Agents, describes how to describes how to monitor and manage the run-time statistics for your Store-and-Forward service.
- Troubleshooting WebLogic SAF, explains how to configure and manage SAF message life cycle logs for stored and forwarded JMS messages, describes SAF debugging tools, and provides a list of frequently asked questions concerning SAF configuration issues.
Related Documentation
This document contains SAF-specific configuration and maintenance information.
For comprehensive guidelines for developing, deploying, and monitoring WebLogic Server applications, see the following documents:
- Configuring and Managing WebLogic JMS contains instructions for configuring and managing JMS resources, such as JMS servers, JMS modules, and the Path Service.
- Using Web Service Reliable Messaging in Programming WebLogic Web Services contains instruction for using SAF with Web Services Reliable Messaging (WSRM).
- Using the WebLogic Persistent Store in Configuring WebLogic Server Environments provides information about the benefits and usage of the system-wide Persistent Store.
Samples and Tutorials for the System Administrator
In addition to this document, BEA Systems provides a variety of code samples and tutorials that show WebLogic Server configuration and API use, and provide practical instructions on how to perform key development tasks. BEA recommends that you run some or all of the samples before configuring your own system.
Examples Available for Download
Additional API examples for download at http://codesamples.projects.dev2dev.bea.com. These examples are distributed as ZIP files that you can unzip into an existing WebLogic Server samples directory structure.
You build and run the downloadable examples in the same manner as you would an installed WebLogic Server example. See the download pages of individual examples for more information at https://codesample.projects.dev2dev.bea.com.
New and Changed SAF Features In This Release
The Store-and-Forward service was introduced in WebLogic Server 9.0. If you are not familiar with the new features provided in version 9.0 of WebLogic Server, see the What's New in WebLogic Server 9.0 section of the WebLogic Server Release Notes.
WebLogic Server 9.1 introduces the following changes in the configuration and dynamic administration of WebLogic SAF.
Message Life Cycle Logging for JMS SAF Destinations
The SAF service now includes message life cycle logging for remote JMS destinations referenced by imported SAF destinations. The SAF Message Logging feature provides an administrator with better transparency about the existence of JMS messages from a SAF agent's viewpoint, in particular basic life cycle events, such as stored messages and forwarded messages to remote destinations. Logging can occur on a continuous basis and over a long period of time. It can be also be used in real-time mode while the SAF agent is running, or in an off-line fashion when a SAF agent is not deployed.
For more information, see SAF Message Life Cycle Logging for JMS Messages.
Window Interval for SAF Agents
SAF sending agents now have a Window Interval parameter for JMS SAF messages, which is the maximum amount of time, in milliseconds, that a SAF sending agent will wait before forwarding JMS messages in a single batch.
Window intervals take effect and improve performance only in cases where the forwarder is already able to forward messages as fast as they arrive. In this case, instead of immediately forwarding newly arrived messages, the forwarder pauses in an attempt to accumulate more messages and forward them as a batch. The resulting larger batch sizes may improve forwarding throughput and reduce overall system disk and CPU usage, but may also increase message latency.
For more information about general SAF agent parameters, see "Store-and-Forward Agents: Configuration: General" in the Administration Console Online Help.
