8.2. Connecting to a Broker


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