Sun ONE Message Queue, Version 3.0.1 Administrator's Guide |
ContentsAudience for This Guide
Organization of This Guide
Conventions
Text Conventions
Other Documentation Resources
Directory Variable Conventions
The MQ Documentation Set
Online Help
JavaDoc
Example Client Applications
The Java Message Service (JMS) Specification
Chapter 1 OverviewWhat Is Sun ONE Message Queue?
Product Editions
Platform Edition
Enterprise Messaging Systems
Enterprise Edition
Requirements of Enterprise Messaging Systems
The JMS Specification
Centralized vs. Peer to Peer Messaging
Messaging System Concepts
Message
Message Service Architecture
Message Delivery Models
JMS Message Structure
JMS/J2EE Programming: Message-driven Beans
JMS Programming Model
Administered Objects
Message-driven Beans
JMS Messaging Issues
Application Server Support
JMS Provider Independence
Programming Domains
Client Identifiers
Reliable Messaging
Acknowledgements/Transactions
Performance Trade-offs
Persistent Storage
Message Selection
Message Order and Priority
Chapter 2 The MQ Messaging SystemMQ Message Server
Broker
MQ Client Runtime
Connection Services
Physical Destinations
Message Router
Persistence Manager
Security Manager
Logger
Queue Destinations
Multi-Broker Clusters (Enterprise Edition)
Topic Destinations
Auto-Created (vs. Admin-Created) Destinations
Temporary Destinations
Multi-Broker Architecture
Using Clusters in Development Environments
Cluster Configuration Properties
Message Production
MQ Administered Objects
Message Consumption
Connection Factory Administered Objects
Destination Administered Objects
Overriding Attribute Values at Client Startup
Chapter 3 MQ AdministrationMQ Administration Tasks
Development Environments
MQ Administration Tools
Production Environments
Setup Operations
Maintenance Operations
The Administration Console
Summary of Command Line Utilities
Command Line Syntax
Common Command Line Options
Chapter 4 Administration Console TutorialGetting Ready
Starting the Administration Console
Getting Help
Working With Brokers
Starting a Broker
Working with Object Stores
Adding a Broker
Changing the Administrator Password
Connecting to the Broker
Viewing Connection Services
Adding Physical Destinations to a Broker
Working With Physical Destinations
Getting Information About Topic Destinations
Adding an Object Store
Updating Console Information
Checking Object Store Properties
Connecting to an Object Store
Adding a Connection Factory Administered Object
Adding a Destination Administered Object
Administered Object Properties
Running the Sample Application
Chapter 5 Starting and Configuring a BrokerConfiguration Files
Merging Property Values
Starting a Broker
Property Naming Syntax
Editing the Instance Configuration File
Working With Clusters (Enterprise Edition)
Cluster Configuration Properties
Logging
Connecting Brokers
Method 1: No Cluster Configuration File
Adding Brokers to Clusters
Method 2: Using a Cluster Configuration File
Restarting a Broker in a Cluster
Removing a Broker from a Cluster
Backing up the Master Broker's Configuration Change Record
Restoring the Master Broker's Configuration Change Record
Default Logging Configuration
Log Message Format
Changing the Logger Configuration
Changing the Output Channel
Changing Rollover Criteria
Logging Broker Performance Metrics
Chapter 6 Broker and Application ManagementCommand Utility
Syntax of Command
Controlling the Broker's State
imqcmd Subcommands
Summary of imqcmd Options
Prerequisites to Using imqcmd
Examples
Querying and Updating Broker Properties
Querying a Broker
Managing Connection Services
Updating a Broker
Listing Connection Services
Managing Destinations
Querying and Updating Service Properties
Pausing and Resuming a Service
Creating Destinations
Managing Durable Subscriptions
Getting Information About Destinations
Updating Destinations
Purging Destinations
Destroying Destinations
Managing Transactions
Chapter 7 Managing Administered ObjectsAbout Object Stores
Administered Objects
Object Manager Utility (imqobjmgr)
Syntax of Command
Adding and Deleting Administered Objects
imqobjmgr Subcommands
Summary of imqobjmgr Command Options
Required Information
Administered Object Attributes
Connection Factory Administered Objects
Object Store Attributes
Destination Administered Objects
Initial Context and Location Information
Using Input Files
Security Information (LDAP Only)
Adding a Connection Factory
Getting Information
Adding a Topic or Queue
Deleting Administered Objects
Listing Administered Objects
Updating Administered Objects
Information About a Single Object
Chapter 8 Security ManagementAuthenticating Users
Using a Flat-File User Repository
Authorizing Users: the Access Control Properties File
User Manager Utility (imqusermgr)
Using an LDAP Server for a User Repository
Groups
States
Format of User Names and Passwords
Populating and Managing the User Repository
Changing the Default Administrator Password
Access Rules Syntax
Encryption: Working With an SSL Service (Enterprise Edition)
Permission Computation
Connection Access Control
Destination Access Control
Destination Auto-Create Access Control
Setting Up an SSL Service Over TCP/IP
Using a Passfile
Step 1. Generating a Self-Signed Certificate
Setting Up an SSL Service Over HTTP
Step 2. Enabling the SSL-based Service in the Broker
Step 3. Starting the Broker
Step 4. Configuring and Running SSL-based Clients
Appendix A Setting Up Plugged-in PersistenceIntroduction
Plugging In a JDBC-accessible Data Store
JDBC-related Broker Configuration Properties
Database Manager Utility (imqdbmgr)
Syntax of Command
imqdbmgr Subcommands
Summary of imqdbmgr Command Options
Appendix B HTTP/HTTPS Support (Enterprise Edition)HTTP/HTTPS Support Architecture
Implementing HTTP Support
Step 1. Deploying the HTTP Tunnel Servlet on a Web Server
Implementing HTTPS Support
Deploying as a Jar File
Step 2. Configuring the httpjms Connection Service
Deploying as a Web Archive File
Step 3. Configuring an HTTP Connection
Setting Connection Factory Attributes
Example: Deploying the HTTP Tunnel Servlet
Using a Single Servlet to Access Multiple Brokers
Using an HTTP Proxy
Deploying as a Jar File
Deploying as a WAR File
Step 1. Generating a Self-signed Certificate for the HTTPS Tunnel Servlet
Step 2. Deploying the HTTPS Tunnel Servlet on a Web Server
Deploying as a Jar File
Step 3. Configuring the httpsjms Connection Service
Deploying as a Web Archive File
Step 4. Configuring an HTTPS Connection
Configuring JSSE
Example: Deploying the HTTPS Tunnel Servlet
Importing a Root Certificate
Setting Connection Factory Attributes
Using a Single Servlet to Access Multiple Brokers
Using an HTTP Proxy
Deploying as a Jar File
Deploying as a WAR File
Appendix C Using a Broker as a Windows ServiceRunning a Broker as a Windows Service
Service Administrator Utility (imqsvcadmin)
Syntax of Command
imqsvcadmin Subcommands
Summary of imqsvcadmin Options
Removing the Broker Service
Reconfiguring the Broker Service
Using an Alternate Java Runtime
Querying the Broker Service
Troubleshooting
Appendix D Location of MQ Data
Appendix E Stability of MQ Interfaces