Starting a Broker

You start a broker using a simple command. The broker can either be started so that it launches a command console or so that it runs as a daemon process. When a broker is part of a fabric, you can remotely start the broker remotely.

Overview

A broker can be run in one of two modes:

console mode—the broker starts up as a foreground process and presents the user with a command shell
daemon mode—the broker starts up as a background process that can be manged using a remote console or the provided command line tools

The default location for the broker's configuration for the broker is the InstallDir/etc/activemq.xml configuration file. The configuration uses values loaded from the InstallDir/etc/system.properties file and the InstallDir/etc/org.fusesource.mq.fabric.server-default.cfg file.

Starting in console mode

When you start the broker in console mode you will be placed into a command shell that provides access to a number of commands for managing the broker and its OSGi runtime.

	Important
	When the broker is started in console mode, you cannot close the console without killing the broker.

To launch a broker in console mode, change to InstallDir and run one of the commands in Table 2.

Table 2. Start up Commands for Console Mode

`Windows`	bin\fusemq.bat
`Unix`	bin/fusemq

If the server starts up correctly you should see something similar to Example 18 on the console.

Example 18. Broker Console

______                  ___  ___ _____ 
|  ___|                 |  \/  ||  _  |
| |_  _   _  ___   ___  | .  . || | | |
|  _|| | | |/ __| / _ \ | |\/| || | | |
| |  | |_| |\__ \|  __/ | |  | |\ \/' /
\_|   \__,_||___/ \___| \_|  |_/ \_/\_\
  Fuse MQ (7.0.0.fuse-036)
  http://fusesource.org/mq/

Hit '<tab>' for a list of available commands
and '[cmd] --help' for help on a specific command.
Hit '<ctrl-d>' or 'osgi:shutdown' to shutdown Fuse MQ.

FuseMQ:karaf@root>

Starting in daemon mode

Launching a broker in daemon mode runs Fuse MQ Enterprise in the background without a console. To launch a broker in daemon mode, change to InstallDir and run one of the commands in Table 3.

Table 3. Start up Commands for Daemon Mode

`Windows`	bin\start.bat
`Unix`	bin/start

Starting a broker in a fabric

If a broker is deployed as part of a fabric you can start it remotely in one of three ways:

using the console of one of the other broker's in the fabric
If one of the brokers in the fabric is running in console mode you an use the fabric:container-start command to start any of the other brokers in the fabric. The command requires that you supply the container name used when creating the broker in the fabric. For example to start a broker named fabric-broker3 you woul duse the command shown in Example 19.
Example 19. Starting a Broker in a Fabric
```
FuseMQ:karaf@root> fabric:container-start fabric-broker3
```
For more information see fabric:container-start, in Console Reference.
using the administration client of one of the broker's in the fabric
If none of the brokers are running in console mode, you can use the administration client on one of the brokers to execute the fabric:container-start command. The administration client is run using the client command in Fuse MQ Enterprise's bin folder. Example 20 shows how to use the remote client to start remote broker in the fabric.
Example 20. Starting a Broker in a Fabric with the Administration Client
```
bin/client fabric:container-start fabric-broker3
```
using Fuse Management Console
Fuse Management Console can start and stop any of the brokers in the fabric it manages from a Web based console.
For more information see the Fuse Management Console Documentation.

Comments powered by Disqus