Fuse MQ Enterprise - Managing and Monitoring a Broker - Deploying a New Broker into a Fabric

Deploying a New Broker into a Fabric

Overview

Deploying a new broker instance into a fabric involves creating a new broker profile and deploying it to a Fabric Container. The fabric infrastructure simplifies these tasks by:

allowing you to do them from a remote location
providing tools that assist in automatically configuring fail over clusters, networks of brokers, and master/slave clusters.
allowing you to reuse parts of existing profiles to ensure consistency
providing tooling to do rolling updates
providing tooling to roll back changes when needed

From the Fuse MQ Enterprise console you can use the fabric:mq-create to create new broker profiles and new containers for the brokers. You can also use Fuse Management Console to perform to create the profiles and assign them to containers.

Procedure

To deploy a new broker into a fabric:

Create a template Fuse MQ Enterprise XML configuration file in a location that is accessible to the container.
In the command console, use the fabric:import command to upload the your XML configuration template to the Fabric Ensemble as shown in Example 37.
Example 37. Uploading a Template to a Fabric Ensemble
```
FuseESB:karaf@root> fabric:import -t /fabric/configs/versions/version/profiles/mq-base/configFile configFile
```
version must match the version of the new profile you will create for the new broker.
Use the fabric:mq-create command to create a profile for the new broker and assign it to a container.
- To deploy the new broker into an existing container use the command shown in Example 38
  Example 38. Creating a New Broker in an Existing Container
```
FuseESB:karaf@root> fabric:mq-create --assign-container containerName --config configFile profileName
```
  This will create a new broker profile that inherits from the mq-base profile, but uses your XML configuration template, and deploy it to the specified container.
- To deploy the new broker into an new container use the command shown in Example 39
  Example 39. Creating a New Broker in a New Container
```
FuseESB:karaf@root> fabric:mq-create --create-container containerName --config configFile profileName
```
  This will create a new broker profile that inherits from the mq-base profile, but uses your XML configuration template, create a new container named containerName, and deploy the broker profile to it.
  Note
  The new container will be a child of the container from which you execute the fabric:mq-create command.
Tip
You can add network configuration settings to the profile as well. See fabric:mq-create in Console Reference.
Use the fabric:profile-edit command shown in Example 40 to set the required properties.
Example 40. Editing a Broker Profile
```
FuseESB:karaf@root> fabric:profile-edit --pid org.fusesource.mq.fabric.server-profileName/property=value profileName
```
The properties that need to be set will depend on the properties you specified using property place holders in the template XML configuration and the broker's network settings.
For information on using fabric:profile-edit see fabric:profile-edit in Console Reference.

	Note
The new container will be a child of the container from which you execute the fabric:mq-create command.

	Tip
	Fuse Management Console makes this process easier by providing a Web based UI.

More information

For more information on configuring brokers to work together see:

For more information on using Fuse Management Console see the Fuse Management Console Documentation.

Comments powered by Disqus

	Tip
	You can add network configuration settings to the profile as well. See fabric:mq-create in Console Reference.