Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Message Queue 3 2005Q4 Administration Guide 

Contents


List of Figures

List of Tables

List of Procedures

Preface
Who Should Use This Book
Before You Read This Book
How This Book Is Organized
Conventions Used In This Book
Text Conventions
Directory Variable Conventions
Related Documentation
Message Queue Documentation Set
Java Message Service Specification
Online Help
JavaDoc
Example Client Applications
Related Third-Party Web Sites
Sun Welcomes Your Comments

Part I Introduction to Message Queue Administration

Chapter 1   Administrative Tasks and Tools
Administrative Tasks
Administration in a Development Environment
Administration in a Production Environment
Administration Tools
Command Line Utilities
Administration Console

Chapter 2   Quick-Start Tutorial
Starting the Administration Console
Administration Console Online Help
Working With Brokers
Starting a Broker
Adding a Broker to the Administration Console
Connecting to a Broker
Viewing Connection Services
Working With Physical Destinations
Creating a Physical Destination
Viewing Physical Destination Properties
Purging Messages From a Physical Destination
Deleting a Physical Destination
Working With Object Stores
Adding an Object Store
Connecting to an Object Store
Working With Administered Objects
Adding a Connection Factory
Adding a Destination
Viewing Administered Object Properties
Deleting an Administered Object
Running the Sample Application

Part II Administration Tasks

Chapter 3   Starting Brokers and Clients
Preparing System Resources
Synchronizing System Clocks
Setting the File Descriptor Limit
Starting Brokers
Starting Brokers Interactively
Starting Brokers Automatically
Removing Brokers
Removing a Broker on Solaris or Linux
Removing a Windows Broker Service
Starting Clients

Chapter 4   Configuring a Broker
Broker Services
Connection Services
Routing Services
Persistence Services
Security Services
Monitoring Services
Setting Broker Properties
Configuration Files
Configuring a Persistent Data Store
Configuring a File-Based Store
Configuring a JDBC-Based Store
Securing Persistent Data

Chapter 5   Managing a Broker
Prerequisites
Using the imqcmd Utility
Displaying Help
Displaying the Product Version
Specifying the User Name and Password
Specifying the Broker Name and Port
Examples
Displaying Broker Information
Updating Broker Properties
Pausing and Resuming a Broker
Pausing a Broker
Resuming a Broker
Shutting Down and Restarting a Broker
Displaying Broker Metrics
Managing Connection Services
Listing Connection Services
Displaying Connection Service Information
Updating Connection Service Properties
Displaying Connection Service Metrics
Pausing and Resuming a Connection Service
Getting Information About Connections
Managing Durable Subscriptions
Managing Transactions

Chapter 6   Managing Physical Destinations
Using the Command Utility
Subcommands
Creating a Physical Destination
Listing Physical Destinations
Displaying Information about Physical Destinations
Updating Physical Destination Properties
Pausing and Resuming Physical Destinations
Purging Physical Destinations
Destroying Physical Destinations
Compacting Physical Destinations
Configuring Use of the Dead Message Queue
Configuring Use of the Dead Message Queue
Configuring and Managing the Dead Message Queue
Enabling Dead Message Logging

Chapter 7   Managing Security
Authenticating Users
Using a Flat-File User Repository
Using an LDAP Server for a User Repository
Authorizing Users: The Access Control Properties File
Creating an Access Control Properties File
Syntax of Access Rules
How Permissions are Computed
Access Control for Connection Services
Access Control for Physical Destinations
Access Control for Auto-Created Physical Destinations
Working With an SSL-Based Service
Secure Connection Services for TCP/IP
Configuring the Use of Self-Signed Certificates
Configuring the Use of Signed Certificates
Using a Password File
Security Concerns
Password File Contents
Creating an Audit Log

Chapter 8   Managing Administered Objects
Object Stores
LDAP Server Object Stores
File-System Object Stores
Administered Object Attributes
Connection Factory Attributes
Destination Attributes
Using the Object Manager Utility
Adding Administered Objects
Deleting Administered Objects
Listing Administered Objects
Viewing Administered Object Information
Modifying Administered Object Attributes
Using Command Files

Chapter 9   Working With Broker Clusters
Cluster Configuration Properties
Setting Cluster Properties for Individual Brokers
Using a Cluster Configuration File
Managing Clusters
Connecting Brokers
Adding Brokers to a Cluster
Removing Brokers From a Cluster
Master Broker
Managing the Configuration Change Record
When a Master Broker Is Unavailable

Chapter 10   Monitoring a Message Server
Introduction to Monitoring Tools
Configuring and Using Broker Logging
Default Logging Configuration
Log Message Format
Changing the Logger Configuration
Interactively Displaying Metrics
imqcmd metrics
Using the metrics Subcommand to Display Metrics Data
Metrics Outputs: imqcmd metrics
imqcmd query
Writing an Application to Monitor Brokers
Setting Up Message-Based Monitoring
Security and Access Considerations
Metrics Outputs: Metrics Messages

Chapter 11   Analyzing and Tuning a Message Service
About Performance
The Performance Tuning Process
Aspects of Performance
Benchmarks
Baseline Use Patterns
Factors That Affect Performance
Application Design Factors that Affect Performance
Message Service Factors that Affect Performance
Adjusting Configuration To Improve Performance
System Adjustments
Broker Adjustments
Client Runtime Message Flow Adjustments

Chapter 12   Troubleshooting Problems
A Client Cannot Establish a Connection
Connection Throughput Is Too Slow
A Client Cannot Create a Message Producer
Message Production Is Delayed or Slowed
Messages Are Backlogged
Message Server Throughput Is Sporadic
Messages Are Not Reaching Consumers
The Dead Message Queue Contains Messages

Part III Reference

Chapter 13   Command Line Reference
Command Line Syntax
Broker Utility
Command Utility
Broker Management
Connection Service Management
Connection Management
Physical Destination Management
Durable Subscription Management
Transaction Management
General Command Utility Options
Object Manager Utility
Database Manager Utility
User Manager Utility
Service Administrator Utility
Key Tool Utility

Chapter 14   Broker Properties Reference
Connection Properties
Routing Properties
Persistence Properties
File-Based Persistence
JDBC-Based Persistence
Security Properties
Monitoring Properties
Cluster Configuration Properties
Alphabetical List of Broker Properties

Chapter 15   Physical Destination Property Reference
Chapter 16   Administered Object Attribute Reference
Connection Factory Attributes
Connection Handling
Client Identification
Reliability and Flow Control
Queue Browser and Server Sessions
Setting Standard Message Properties
Message Header Overrides
Destination Attributes
SOAP Endpoint Attributes

Chapter 17   JMS Resource Adapter Property Reference
ResourceAdapter JavaBean
ManagedConnectionFactory JavaBean
ActivationSpec JavaBean

Chapter 18   Metrics Reference
JVM Metrics
Brokerwide Metrics
Connection Service Metrics
Destination Metrics

Part IV Appendixes

Appendix A   Platform-Specific Locations of Message Queue Data
Solaris
Linux
Windows

Appendix B   Stability of Message Queue Interfaces
Appendix C   HTTP/HTTPS Support
HTTP/HTTPS Support Architecture
Enabling HTTP Support
Step 1. Deploy the HTTP Tunnel Servlet
Step 2. Configure the httpjms Connection Service
Step 3. Configure an HTTP Connection
Enabling HTTPS Support
Step 1. Generating a Self-signed Certificate for the HTTPS Tunnel Servlet
Step 2. Modifying the HTTP Tunnel Servlet .war File’s Descriptor File
Step 3. Deploying the HTTPS Tunnel Servlet
Step 4. Configuring the httpsjms Connection Service
Step 5. Configuring an HTTPS Connection
Troubleshooting
Server or Broker Failure
Client Failure to Connect Through the Tunnel Servlet

Appendix D   Frequently Used Command Utility Commands
Syntax
Broker and Cluster Management
Broker Configuration Properties (-o option)
Service and Connection Management
Durable Subscriber Management
Transaction Management
Destination Management
Destination Configuration Properties (-o option)
Metrics

Glossary

Index


Copyright      Index      Next     

Part No: 819-2571-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.