10.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.

To connect to an MQ broker, the client must specify a discovery URL, in the following format:

discovery:(fabric:GroupName)

For example, to connect to a broker associated with the default group, the client would use the following URL:

discovery:(fabric:default)

The connection factory then looks for available brokers in the group and connects the client to one of them.

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