Fuse ESB Enterprise - Deploying into the Container - Working with the Default Broker

Working with the Default Broker

Overview

When you deploy an Fuse ESB Enterprise instance, whether as a standalone container or as a part of a fabric, the default behavior is for a Apache ActiveMQ instance to be started in the container. The default broker creates an Openwire port that listens on port 61616. The broker remains installed in the container and activates whenever you restart the container.

Broker configuration

The default broker's configuration is controlled by two files:

etc/activemq.xml—a standard Apache ActiveMQ configuration file that serves as a template for the default broker's configuration. It contains property place holders, specified using the syntax ${propName}, that allow you to set the values of the actual property using the OSGi Admin service.
etc/org.fusesource.mq.fabric.server-default.cfg—the OSGi configuration file that specifies the values for the properties in the broker's template configuration file.

For details on how to edit the default broker's configuration see Editing a Broker's Configuration in Managing and Monitoring a Broker.

Broker data

The default broker's data is stored in data/activemq. You can change this location using the config command to change the broker's data property as shown in Example 24.

Example 24. Configuring the Default Broker's Data Directory

FuseESB:karaf@root> config:edit org.fusesource.mq.fabric.server.3e3d0055-1c5f-40e3-987e-024c1fac1c3f
FuseESB:karaf@root> config:propset data dataStore
FuseESB:karaf@root> config:exit

Disabling the default broker

If you decide that you don't want to use the default broker, you can disable it by removing it's OSGi configuration file:

From the Fuse ESB Enterprise command console, delete the configuration PID using the config:delete command as shown in Example 25.
Example 25. Deleting the Default Broker Configuration
```
FuseESB:karaf@root> config:delete org.fusesource.mq.fabric.server.xxx
```
xxx is the system generated ID for the broker. You can find this value using the config:list command.
From the system terminal, delete the actual configuration file etc/org.fusesource.mq.fabric.server-default.cfg.

It is important to do both steps. Step 1 removes the broker from the running container and its cached deployment information. Step 2 removes the broker's configuration from the file system and ensures that it will not be automatically reloaded if the container is restarted.

More information

For more information about working with the included Apache ActiveMQ distribution, see Managing and Monitoring a Broker.

Comments powered by Disqus