JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server Message Queue 4.5 Administration Guide
search filter icon
search icon

Document Information


Part I Introduction to Message Queue Administration

1.  Administrative Tasks and Tools

2.  Quick-Start Tutorial

Part II Administrative Tasks

3.  Starting Brokers and Clients

4.  Configuring a Broker

5.  Managing a Broker

6.  Configuring and Managing Connection Services

7.  Managing Message Delivery

8.  Configuring Persistence Services

9.  Configuring and Managing Security Services

10.  Configuring and Managing Broker Clusters

11.  Managing Administered Objects

12.  Configuring and Managing Bridge Services

The Bridge Service Manager

Bridge-Related Broker Properties

To Enable the Bridge Service Manager

Bridge Manager Utility

Logging of Bridge Services

Configuring and Managing JMS Bridge Services

JMS Bridge Components

JMS Bridge Features

Pooled, Shared, and Dedicated Connections

Transactional Message Transfer

JMS Bridges in High Availability (HA) Broker Clusters

Message Transformation During Message Delivery

JMSReplyTo Header Processing

Dead Message Queue (DMQ) Processing

Message Processing Sequence Across a Link in a JMS Bridge

Configuring a JMS Bridge

Specifying the Broker Properties for a JMS Bridge

Creating the XML Configuration File for a JMS Bridge

Starting and Stopping JMS Bridges

To Configure a JMS Bridge to Start at Broker Startup

To Start a JMS Bridge Manually

To Stop a JMS Bridge Manually

Starting and Stopping Links in a JMS Bridge

To Stop a Link Manually

To Start a Link Manually

Configuring and Managing STOMP Bridge Services

Configuring the STOMP Bridge

Starting and Stopping the STOMP Bridge

To Activate the STOMP Bridge

To Stop the STOMP Bridge Manually

To Start the STOMP Bridge Manually

Message Processing Sequence Across the STOMP Bridge

Message Transformation During Message Processing

STOMP Protocol Features and the STOMP Bridge

13.  Monitoring Broker Operations

14.  Analyzing and Tuning a Message Service

15.  Troubleshooting

Part III Reference

16.  Command Line Reference

17.  Broker Properties Reference

18.  Physical Destination Property Reference

19.  Administered Object Attribute Reference

20.  JMS Resource Adapter Property Reference

21.  Metrics Information Reference

22.  JES Monitoring Framework Reference

Part IV Appendixes

A.  Distribution-Specific Locations of Message Queue Data

B.  Stability of Message Queue Interfaces

C.  HTTP/HTTPS Support

D.  JMX Support

E.  Frequently Used Command Utility Commands


The Bridge Service Manager

The Message Queue Bridge Service Manager is an application that runs in same JVM as a broker to manage the bridges configured for the broker. Two administrative components control operation of the Bridge Service Manager:

The following sections introduce these two components.

Bridge-Related Broker Properties

The operation of the Bridge Service Manager is in part controlled by several broker properties. These broker properties, all of which begin with imq.bridge, are listed in tables under Bridge Properties. Some of the properties apply to all bridges configured for the broker, while others apply only to a specific bridge. The properties that apply to a specific bridge all begin with imq.bridge.bridgeName, where bridgeName is:

Of all the bridge-related broker properties, the two most important are imq.bridge.enabled and imq.bridge.activelist:

To Enable the Bridge Service Manager

  1. Set the imq.bridge.enabled broker property to true.
  2. Set the imq.bridge.admin.user broker property to the user name of the admin user.
  3. Set the imq.bridge.admin.password broker property to the password of the admin user.

    Alternatively, you can specify the password using the -passfile option when you use the imqbrokerd command to start the broker hosting the bridge service manager.

  4. Set the imq.bridge.activelist broker property to a comma-separated list of bridges to instantiate at broker startup.

Bridge Manager Utility

The Bridge Manager utility (imqbridgemgr) is the interface to the bridge management functions of the Bridge Service Manager. It provides commands to:

The imqbridgemgr utility uses the same command line syntax as the other Message Queue utilities:

imqbridgemgr subcommand commandArgument [ options ]

For example, the following command lists all bridges of type JMS on the broker localhost:7373:

imqbridgemgr list bridge -t jms -b localhost:7373

For the complete set of subcommands, command arguments, and options supported by the imqbridgemgr utility, see Bridge Manager Utility.

Logging of Bridge Services

Each bridge managed by the Bridge Service Manager for a broker has its own log file stored in the IMQ_VARHOME/instances/broker-name/bridges/bridge-name/ directory.

The JMS and STOMP bridge services use the Java logging facility, which can be configured by the Java logging configuration file. The logging level for a bridge can be controlled by setting the imq.bridge.bridge-name.level property in the Java logging configuration file. Then, the Java system property java.util.logging.config.file can be set to the Java logging configuration file when the broker is started; as in:

imqbrokerd -Djava.util.logging.config.file=config-file