Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Message Queue 3 2005Q1 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
Online Help
JavaDoc
Example Client Applications
The Java Message Service (JMS) Specification
Related Third-Party Web Site References
Sun Welcomes Your Comments

Part I Introduction to Message Queue Administration

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

Chapter 2   Administration Quick Start
Getting Ready
Starting the Administration Console
Getting Help
Starting a Broker
Adding a Broker
Connecting to the Broker
Viewing Connection Services
Adding Physical Destinations to a Broker
Administering Physical Destinations
Getting Information About Topics
Working with Object Stores
Adding an Object Store
Checking Object Store Properties
Connecting to an Object Store
Adding a Connection Factory Administered Object
Adding a Destination Object
Viewing Administered Object Properties
Updating Console Information
Running the Sample Application

Part II Administration Tasks

Chapter 3   Starting Brokers and Clients
Preparing System Resources
Synchronizing System Clocks
Setting the File Descriptor Limits (Solaris or Linux)
Starting Brokers Interactively
Starting Brokers Automatically
Automatic Startup on Solaris and Linux
Automatic Startup on Windows
Starting Message Queue Clients
Removing a Broker Instance

Chapter 4   Configuring a Broker
About Configurable Broker Components
Connection Services
Message Router
Persistence Manager
Security Manager
Monitoring Service
About Configuration Files
Instance Configuration File
Merging Property Values
Property Naming Syntax
Editing the Instance Configuration File
Entering Configuration Options on the Command Line
Setting Up a Persistent Store
Configuring a File System Store
Configuring a JDBC Store
Securing Persistent Data
Built-In (File-Based) Persistent Store
Plugged-In (JDBC) Persistent Store

Chapter 5   Managing a Broker
Prerequisites
Using the imqcmd Command Utility
Specifying the User Name and Password
Specifying the Broker Name and Port
Examples
Displaying Help
Displaying the Product Version
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 imqcmd 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 Passfile
Security Concerns
Passfile Contents
Creating an Audit Log

Chapter 8   Managing Administered Objects
About Object Stores
LDAP Server Object Store
File-System Object Store
About Administered Object Attributes
Connection Factory Attributes.
Client Identification
Destination Administered Object Attributes
Using the Object Manager Utility (imqobjmgr)
Required Information
Using Command Files
Adding and Deleting Administered Objects
Adding a Connection Factory
Adding a Topic or Queue
Deleting Administered Objects
Listing Administered Objects
Getting Information About a Single Object
Updating Administered Objects

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 Reference
Command Line Syntax
Rules for Entering Commands
Command Line Examples
Common Command Options
imqbrokerd
Syntax
Command Options
See Also
imqcmd
Syntax
Subcommands
Command Options
See Also
imqobjmgr
Syntax
Subcommands
Command Options
See Also
imqdbmgr
Syntax
Subcommands
Command Options
See Also
imqusermgr
Syntax
Subcommands
Command Options
See Also
imqsvcadmin
Syntax
Subcommands
Command Options
See Also
imqkeytool
Syntax
See Also

Chapter 14   Broker Properties Reference
Alphabetical List of Properties
Connection Service Properties
Message Router Properties
Persistence Manager Properties
File-Based Persistence
JDBC-Based Persistence
Security Manager Properties
Monitoring and Logging Properties
Cluster Configuration Properties

Chapter 15   Physical Destination Property Reference
Chapter 16   Administered Object Attribute Reference
Destination Properties
Connection Factory Attributes
Connection Handling
Client Identification
Message Header Overrides
Reliability and Flow Control
Queue Browser Behavior and Server Session
JMS-Defined Properties Support
SOAP Endpoint Attributes

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

Chapter 18   Metrics Reference
JVM Metrics
Broker-wide Metrics
Connection Service Metrics
Destination Metrics

Part IV Appendixes

Appendix A   Operating System-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. Deploying the HTTP Tunnel Servlet on a Web Server
Step 2. Configuring the httpjms Connection Service
Step 3. Configuring an HTTP Connection
Example 1: Deploying the HTTP Tunnel Servlet on Sun Java System Web Server
Example 2: Deploying the HTTP Tunnel Servlet on Sun Java System Application Server 7.0
Enabling HTTPS Support
Step 1. Generating a Self-signed Certificate for the HTTPS Tunnel Servlet
Step 2. Deploying the HTTPS Tunnel Servlet on a Web Server
Step 3. Configuring the httpsjms Connection Service
Step 4. Configuring an HTTPS Connection
Example 3: Deploying the HTTPS Tunnel Servlet on Sun Java System Web Server
Example 4: Deploying the HTTPS Tunnel Servlet on Sun Java System Application Server 7.0
Troubleshooting
Server or Broker Failure
Client Failure to Connect Through the Tunnel Servlet

Glossary

Index


Copyright      Index      Next     

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