Documentation Home
> Sun Java System Message Queue 4.2 Administration Guide
Sun Java System Message Queue 4.2 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
Built-in Administration Tools
Command Line Utilities
Administration Console
JMX-Based Administration
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 Broker Startup on the Solaris Platforms
Automatic Broker Startup on the Solaris 9 Platform
Automatic Broker Startup on the Solaris 10 Platform
To Implement Automatic Broker Startup on Solaris 10 OS
To Disable Automatic Broker Startup on Solaris 10 OS
Automatic Broker Startup on the Linux Platform
Automatic Broker 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
Disabling a Broker From Running as a Windows Service
Troubleshooting Service Startup Problems
To See Logged Service Error Events
Deleting a Broker Instance
Starting Clients
Chapter 4 Configuring a Broker
Broker Services
Setting Broker Configuration Properties
Modifying Configuration Files
Setting Configuration Properties from the Command Line
Chapter 5 Managing a Broker
Command Utility Preliminaries
Using the Command Utility
Specifying the User Name and Password
Specifying the Broker Name and Port
Displaying the Product Version
Displaying Help
Examples
Managing Brokers
Shutting Down and Restarting a Broker
Quiescing a Broker
Pausing and Resuming a Broker
Updating Broker Properties
Viewing Broker Information
Chapter 6 Configuring and Managing Connection Services
Configuring Connection Services
Port Mapper
Thread Pool Management
Managing Connection Services
Pausing and Resuming a Connection Service
Updating Connection Service Properties
Viewing Connection Service Information
Managing Connections
Chapter 7 Managing Message Delivery
Configuring and Managing Physical Destinations
Command Utility Subcommands for Physical Destination Management
Creating and Destroying Physical Destinations
Naming Destinations
Supported Queue Destination Names
Supported Topic Destination Names
Setting Property Values
Destroying Destinations
Pausing and Resuming a Physical Destination
Purging a Physical Destination
Updating Physical Destination Properties
Viewing Physical Destination Information
Managing Physical Destination Disk Utilization
Using the Dead Message Queue
Managing the Dead Message Queue
Enabling Dead Message Logging
Managing Broker System-Wide Memory
Managing Durable Subscriptions
Managing Transactions
Chapter 8 Configuring Persistence Services
Introduction to Persistence Services
File-Based Persistence
File-Based Persistence Properties
Configuring a File-Based Data Store
Securing a File-Based Data Store
JDBC-Based Persistence
JDBC-Based Persistence Properties
Configuring a JDBC-Based Data Store
To Set Up a JDBC-Based Data Store
To Display Information About a JDBC-Based Data Store
Securing a JDBC-Based Data Store
Data Store Formats
Chapter 9 Configuring and Managing Security Services
Introduction to Security Services
Authentication
Authorization
Encryption
User Authentication
Using a Flat-File User Repository
User Groups and Status
Using the User Manager Utility
User Manager Preliminaries
Subcommands and General Options
Displaying the Product Version
Displaying Help
Adding a User to the Repository
Deleting a User From the Repository
Changing a User’s Password
Activating or Deactivating a User
Viewing User Information
Using an LDAP User Repository
To Set Up an Administrative User
Using JAAS-Based Authentication
Elements of JAAS
JAAS and Message Queue
Setting up JAAS-Compliant Authentication
User Authorization
Access Control File Syntax
Application of Authorization Rules
Authorization Rules for Connection Services
Authorization Rules for Physical Destinations
Message Encryption
Using Self-Signed Certificates
Setting Up an SSL-Based Connection Service Using Self-Signed Certificates
To Generate a Self-Signed Certificate
To Regenerate a Key Pair
To Enable an SSL-Based Connection Service in the Broker
To Start the Broker
Configuring and Running an SSL-Based Client Using Self-Signed Certificates
Application Clients
Administrative Clients
Using Signed Certificates
Obtaining and Installing a Signed Certificate
To Obtain a Signed Certificate
To Install a Signed Certificate
Configuring the Client 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
Chapter 10 Configuring and Managing Broker Clusters
Configuring Broker Clusters
The Cluster Configuration File
Cluster Configuration Properties
Cluster Connection Service Properties
Conventional Cluster Properties
High-Availability Cluster Properties
High-Availability Clusters: General Configuration Properties
High-Availability Clusters: JDBC Configuration Properties
High-Availability Clusters: Failure Detection Properties
Displaying a Cluster Configuration
Managing Broker Clusters
Managing Conventional Clusters
Connecting Brokers into a Conventional Cluster
To Connect Brokers from the Command Line
To Connect Brokers Using a Cluster Configuration File
To Establish Secure Connections Between Brokers
Adding Brokers to a Conventional Cluster
To Add a New Broker to a Conventional Cluster Using a Cluster Configuration File
To Add a New Broker to a Conventional Cluster Without a Cluster Configuration File
Removing Brokers From a Conventional Cluster
To Remove a Broker From a Conventional Cluster Using a Cluster Configuration File
To Remove a Broker From a Conventional Cluster Using the Command Line
Managing a Conventional Cluster's Configuration Change Record
To Back Up the Configuration Change Record
To Restore the Configuration Change Record
Managing High-Availability Clusters
Connecting Brokers into a High-Availability Cluster
To Connect Brokers Using a Cluster Configuration File
To Connect Brokers Using Instance Configuration Files
Adding and Removing Brokers in a High-Availability Cluster
To Add a New Broker to a High-availability Cluster
To Remove a Broker from a high-availability Cluster
Preventing or Forcing Broker Failover
Converting a Standalone Data Store to a Shared Data Store
Backing up a Shared Data Store
Chapter 11 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 12 Monitoring Broker Operations
Monitoring Services
Introduction to Monitoring Tools
Configuring and Using Broker Logging
Logger Properties
Log Message Format
Default Logging Configuration
Changing the Logging 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
Using the Command Utility to Display Metrics Interactively
imqcmd metrics
To Use the metrics Subcommand
Metrics Outputs: imqcmd metrics
Brokerwide Metrics
Connection Service Metrics
Physical Destination Metrics
imqcmd query
Using the JMX Administration API
Using the Java ES Monitoring Console
Using the Message-Based Monitoring API
Setting Up Message-Based Monitoring
To Set Up Message-based Monitoring
Security and Access Considerations
Metrics Outputs: Metrics Messages
Chapter 13 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 Memory Management Adjustments
Using Physical Destination Limits
Using System-Wide Limits
Client Runtime Message Flow Adjustments
Message Flow Metering
Message Flow Limits
Consumer Flow Limits
Connection Flow Limits
Adjusting Multiple-Consumer Queue Delivery
Chapter 14 Troubleshooting
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
To Inspect the Dead Message Queue
Part III Reference
Chapter 15 Command Line Reference
Command Line Syntax
Broker Utility
Command Utility
General Command Utility Options
Broker Management
Connection Service Management
Connection Management
Physical Destination Management
Durable Subscription Management
Transaction Management
JMX Management
Object Manager Utility
Database Manager Utility
User Manager Utility
Service Administrator Utility
Key Tool Utility
Chapter 16 Broker Properties Reference
Connection Properties
Routing and Delivery Properties
Persistence Properties
File-Based Persistence Properties
JDBC-Based Persistence Properties
Security Properties
Monitoring Properties
Cluster Configuration Properties
JMX Properties
Alphabetical List of Broker Properties
Chapter 17 Physical Destination Property Reference
Physical Destination Properties
Chapter 18 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
Chapter 19 JMS Resource Adapter Property Reference
ResourceAdapter JavaBean
ManagedConnectionFactory JavaBean
ActivationSpec JavaBean
Chapter 20 Metrics Information Reference
JVM Metrics
Brokerwide Metrics
Connection Service Metrics
Physical Destination Metrics
Chapter 21 JES Monitoring Framework Reference
Common Attributes
Message Queue Product Information
Broker Information
Port Mapper Information
Connection Service Information
Destination Information
Persistent Store Information
User Repository Information
Part IV Appendixes
Appendix A Platform-Specific Locations of Message Queue Data
Solaris OS
Linux
Windows
Appendix B Stability of Message Queue Interfaces
Classification Scheme
Interface Stability
Appendix C HTTP/HTTPS Support
HTTP/HTTPS Support Architecture
Enabling HTTP/HTTPS Support
Step 1 (HTTPS Only): Generating a Self-Signed Certificate for the Tunnel Servlet
Step 2 (HTTPS Only): Specifying the Key Store Location and Password
To Specify the Location and Password of the Certificate Key Store
Step 3 (HTTPS Only): Validating and Installing the Server’s Self-Signed Certificate
To Validate and Install the Server’s Self-Signed Certificate
Step 4 (HTTP and HTTPS): Deploying the Tunnel Servlet
To Deploy the HTTP or HTTPS Tunnel Servlet
Modifying the Application Server’s Security Policy File
Step 5 (HTTP and HTTPS): Configuring the Connection Service
To Activate the httpjms or httpsjms Connection Service
Step 6 (HTTP and HTTPS): Configuring a Connection
Installing a Root Certificate (HTTPS Only)
Installing a Root Certificate in the Trust Store
Configuring the Connection Factory (HTTP and HTTPS)
Using a Single Servlet to Access Multiple Brokers (HTTP and HTTPS)
Using an HTTP Proxy
Troubleshooting
Server or Broker Failure
Client Failure to Connect Through the Tunnel Servlet
If a Client Cannot Connect
Appendix D JMX Support
JMX Connection Infrastructure
MBean Access Mechanism
The JMX Service URL
The Admin Connection Factory
JMX Configuration
RMI Registry Configuration
Static JMX Service URL: Using an RMI Registry
Dynamic JMX Service URL: Not Using an RMI Registry
SSL-Based JMX Connections
Broker Side SSL Configuration
To Activate the SSL-Based JMX connector
JMX Client Side SSL Configuration
JMX Connections Through a Firewall
Appendix E 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