Documentation Home
> Sun Java System Message Queue 3.7 UR1 Administration Guide
Sun Java System Message Queue 3.7 UR1 Administration Guide
Book Information
Index
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Preface
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
Setup Operations
Maintenance Operations
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
To Add a Broker to the Administration Console
Connecting to a Broker
To Connect to a Broker
Viewing Connection Services
To View Available Connection Services
Working With Physical Destinations
Creating a Physical Destination
To Add a Physical Destination to a Broker
Viewing Physical Destination Properties
To View or Modify the Properties of a Physical Destination
Purging Messages From a Physical Destination
To Purge Messages From a Physical Destination
Deleting a Physical Destination
To Delete a Physical Destination
Working With Object Stores
Adding an Object Store
To Add an Object Store to the Administration Console
Connecting to an Object Store
To Connect to an Object Store
Working With Administered Objects
Adding a Connection Factory
To Add a Connection Factory to an Object Store
Adding a Destination
To Add a Destination to an Object Store
Viewing Administered Object Properties
To View or Modify the Properties of an Administered Object
Deleting an Administered Object
To Delete an Administered Object
Running the Sample Application
To Run the Sample Application
Part II Administrative 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
Automatic Startup on Solaris and Linux
Automatic Startup on Windows
Reconfiguring the Broker Service
To Reconfigure a Broker Running as a Windows Service
Using an Alternative Java Runtime
Displaying Broker Service Startup Options
Troubleshooting Service Startup Problems
To See Logged Service Error Events
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
Port Mapper
Thread Pool Management
Routing Services
Persistence Services
File-Based Persistence
JDBC-Based Persistence
Security Services
Authentication
Authorization
Encryption
Monitoring Services
Metrics Generator
Logger
Metrics Message Producer (Enterprise Edition)
Setting Broker Properties
Configuration Files
Editing the Instance Configuration File
Setting Configuration Options from the Command Line
Configuring a Persistent Data Store
Configuring a File-Based Store
Configuring a JDBC-Based Store
To Configure a JDBC-Based Data Store
Securing Persistent Data
Securing a File-Based Store
Securing a JDBC-Based Store
Chapter 5 Managing a Broker
Prerequisites
Using the imqcmd Utility
Displaying Help
Displaying the Product Version
Specifying the User Name and Password
Specifying the User Name
Specifying the 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
Monitoring a Physical Destination’s Disk Utilization
Reclaiming Unused Physical Destination Disk Space
To Reclaim Unused Physical Destination Disk Space
Using the Dead Message Queue
Configuring Use of the Dead Message Queue
Managing the Dead Message Queue
Dead Message Queue Properties
Message Contents
Enabling Dead Message Logging
Chapter 7 Managing Security
User Authentication
Using a Flat-File User Repository
Creating a User Repository
User Manager Utility
Subcommands
Command Options
Groups
User States
Format of User Names and Passwords
Populating and Managing a User Repository
Changing the Default Administrator Password
Using an LDAP Server for a User Repository
Editing the Instance Configuration File
To Edit the Configuration File to Use an LDAP Server
Setting Up Access Control for Administrators
To Set Up an Administrative User
User Authorization: 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
Message Encryption
Using Self-Signed Certificates
To Set Up an SSL-Based Connection Service Using Self-Signed Certificates
Generating a Self-Signed Certificate
To Regenerate a Key Pair
Enabling an SSL-Based Connection Service
To Enable an SSL-Based Service in the Broker
Starting the Broker
Configuring and Running an SSL-Based Client
Application Clients
Administrative Clients
Using Signed Certificates
To Use a Signed Certificate
Obtaining and Installing a Signed Certificate
To Obtain a Signed Certificate
To Install a Signed Certificate
Configuring the Message Queue Client Runtime to Require Signed Certificates
To Configure the Client Runtime to Require Signed Certificates
Password Files
Security Concerns
Password File Contents
Connecting Through a Firewall
To Enable Broker Connections Through a Firewall
Audit Logging
Chapter 8 Managing Administered Objects
Object Stores
LDAP Server Object Stores
File-System Object Stores
Administered Object Attributes
Connection Factory Attributes
Connection Handling
Broker Address List
Automatic Reconnection
Periodic Testing (Pinging) of Connections
Client Identification
Client Authentication
Client Identifier
Reliability And Flow Control
Queue Browser and Server Sessions
Standard Message Properties
Message Header Overrides
Destination Attributes
Using the Object Manager Utility
Adding Administered Objects
Adding a Connection Factory
Adding a Destination
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
To Add a New Broker to a Cluster Using a Cluster Configuration File
To Add a New Broker to a Cluster Without a Cluster Configuration File
Removing Brokers From a Cluster
Removing a Broker Using the Command Line
To Remove a Broker From a Cluster Using the Command Line
Removing a Broker Using a Cluster Configuration File
To Remove a Broker From a Cluster Using a Cluster Configuration File
Master Broker
Managing the Configuration Change Record
To Back Up the Configuration Change Record
To Restore the Configuration Change Record
When a Master Broker Is Unavailable
Chapter 10 Monitoring a Broker
Introduction to Monitoring Tools
Configuring and Using Broker Logging
Default Logging Configuration
Log Message Format
Changing the Logger Configuration
To Change the Logger Configuration for a Broker
Changing the Output Channel
Changing Log File Rollover Criteria
Sending Metrics Data to Log Files
To Use Log Files to Report Metrics Information
Logging Dead Messages
Displaying Metrics Interactively
imqcmd metrics
Using the metrics Subcommand to Display Metrics Data
To Use the metrics Subcommand
Metrics Outputs: imqcmd metrics
Brokerwide Metrics
Connection Service Metrics
Physical Destination Metrics
imqcmd query
Writing an Application to Monitor Brokers
Setting Up Message-Based Monitoring
To Set 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 Affecting Performance
Message Delivery Steps
Application Design Factors Affecting Performance
Delivery Mode (Persistent/Nonpersistent Messages)
Use of Transactions
Acknowledgment Mode
Durable and Nondurable Subscriptions
Use of Selectors (Message Filtering)
Message Size
Message Body Type
Message Service Factors Affecting Performance
Hardware
Operating System
Java Virtual Machine (JVM)
Connections
Broker Connection Limits
Transport Protocols
Message Service Architecture
Broker Limits and Behaviors
Data Store Performance
Client Runtime Configuration
Adjusting Configuration To Improve Performance
System Adjustments
Solaris Tuning: CPU Utilization, Paging/Swapping/Disk I/O
Java Virtual Machine Adjustments
Tuning Transport Protocols
nodelay
inbufsz/outbufsz
HTTP/HTTPS Tuning
Tuning the File-based Persistent Store
Broker Adjustments
Memory Management: Increasing Broker Stability Under Load
Using Physical Destination Limits
Using Systemwide Limits
Multiple Consumer Queue Performance
Client Runtime Message Flow Adjustments
Message Flow Metering
Message Flow Limits
Consumer Flow Limits
Connection Flow Limits
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
Broker Throughput Is Sporadic
Messages Are Not Reaching Consumers
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
Physical Destination Properties
Chapter 16 Administered Object Attribute Reference
Connection Factory Attributes
Connection Handling
Client Identification
Reliability and Flow Control
Queue Browser and Server Sessions
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
Classification Scheme
Interface Stability
Appendix C HTTP/HTTPS Support
HTTP/HTTPS Support Architecture
Enabling HTTP Support
To Enable HTTP Support
Step 1. Deploy the HTTP Tunnel Servlet
Deploying the HTTP Tunnel Servlet on Sun Java System Web Server
To Deploy the HTTP Tunnel Servlet as a .war File
Disabling a Server Access Log
To Disable the Server Access Log
Deploying the HTTP Tunnel Servlet on Sun Java System Application Server
Using the Deployment Tool
To Deploy the HTTP Tunnel Servlet in an Application Server Environment
Modifying the server.policy File
To Modify the Application Server’s server.policy File
Step 2. Configure the httpjms Connection Service
To Activate the httpjms Connection Service
Step 3. Configure an HTTP Connection
Configuring the Connection Factory
Using a Single Servlet to Access Multiple Brokers
Using an HTTP Proxy
Enabling HTTPS Support
To Enable 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
To Modify the HTTPS Tunnel Servlet .war File
Step 3. Deploying the HTTPS Tunnel Servlet
Deploying as a Web Archive File
Deploying the HTTPS Tunnel Servlet on Sun Java System Web Server
To Deploy the https Tunnel Servlet as a .war File
Disabling a Server Access Log
To Disable the Server Access Log
Deploying the HTTPS Tunnel Servlet on Sun Java System Application Server
Using the Deployment Tool
To Deploy the HTTPS Tunnel Servlet in an Application Server Environment
Modifying the server.policy file
To Modify the Application Server’s server.policy File
Step 4. Configuring the httpsjms Connection Service
To Activate the httpsjms Connection Service
Step 5. Configuring an HTTPS Connection
Configuring JSSE
To Configure JSSE
Importing a Root Certificate
Configuring the Connection Factory
Using a Single Servlet to Access Multiple Brokers
Using an HTTP Proxy
Troubleshooting
Server or Broker Failure
Client Failure to Connect Through the Tunnel Servlet
If a Client Cannot Connect
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
© 2010, Oracle Corporation and/or its affiliates