Running Message Broker on Microsoft Windows

On Microsoft Windows platforms, the Message Broker is installed as a Microsoft Windows service. When this service is installed, the installer asks whether you wish to create an automatic or a manual service.

  • If you choose automatic, the corresponding service will be started by Microsoft Windows each time the system is initialized.

  • If you choose manual, you must manually start the service each time the system is initialized.

Both automatic and manual services are automatically stopped when the system is shutdown. Both automatic and manual services can be manually started and stopped as needed. The procedures for starting and stopping the Message Broker are described below.

Starting a Message Broker

To start a Message Broker, do the following:

  1. On the computer where the Message Broker is installed, click Start >Settings > Control Panel > Administrative Tools > Services. On Microsoft Windows XP systems, click Start > Control Panel > Performance and Maintenance > Administrative Tools > Services.

  2. Select the service named Micro Focus ActiveMQ Message Broker.

  3. Click Start.

When the Message Broker starts, it reads the ActiveMQMessageBroker.ini configuration file. On Windows systems, this file is typically located in the C:\Program Files\Micro Focus\Message Broker folder. Options in this file tell the Message Broker what TCP/IP port (end point) to accept connections on, and which other Message Brokers (if any) to establish communication with to form a Message Broker cloud. See Configuring a Message Broker Cloud for details on the contents of the ActiveMQMessageBroker.ini file.

Back to top

Stopping a Message Broker

Under most conditions, a Message Broker runs continuously. However, it may be necessary to stop a Message Broker. For example, you may choose to move a Message Broker to a different computer or remove a Message Broker from a Message Broker cloud. If the Message Broker that you stop is serving clients, those clients continue to access the server configurations, but without using ActiveMQ MPX.

To stop a Message Broker, do the following:

  1. You should first notify users that ActiveMQ MPX will be unavailable.

  2. On the computer where the Message Broker is installed, click Start > Settings > Control Panel > Administrative Tools > Services. On Microsoft Windows XP systems, click Start > Control Panel > Performance and Maintenance > Administrative Tools > Services.

  3. Select the service named Micro Focus ActiveMQ Message Broker.

  4. Click Stop.

Back to top