8.2. Connecting to a Broker

download PDF


This section describes how to connect a client to a broker. In order to connect to a JBoss MQ broker, you need to know its group name. Every MQ broker is associated with a group when it is created: if none is specified explicitly, it automatically gets associated with the default group.

Client URL

To connect to an MQ broker, the client must specify a discovery URL, in the following format:
For example, to connect to a broker associated with the default group, the client would use the following URL:
The connection factory then looks for available brokers in the group and connects the client to one of them.

Example client profiles

You can test broker by deploying the example-mq profile into a container. The example-mq profile instantiates a pair of messaging clients: a producer client, that sends messages continuously to the FABRIC.DEMO queue on the broker; and a consumer client, that consumes messages from the FABRIC.DEMO queue.
Create a new container with the example-mq profile, by entering the following command:
JBossFuse:karaf@root> fabric:container-create-child --profile example-mq root example
You can check whether the example container is successfully provisioned, using the following console command:
JBossFuse:karaf@root> watch container-list
After the example container is successfully provisioned, you can connect to it and check its log to verify the flow of messages, using the following console commands:
JBossFuse:karaf@root> container-connect example
JBossFuse:karaf@example> log:display
Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.