Configuring MPX to use ActiveMQ MPX

This chapter explains how to modify your existing MPX Event Transmitter, MPX File Transmitter, and MPX Cache Agent configurations to ActiveMQ MPX (using Apache ActiveMQ technology). By default , new configurations for StarTeam Server and the MPX Cache Agent will be configured to use the ActiveMQ MPX Message Broker. To switch an existing StarTeamMPX configuration to use ActiveMQ MPX Messaging, you will need to update the following configuration files:
  • MPXEventTransmitter.xml.
  • MPXFileTransmitter.xml.
  • The Root MPX Cache Agent configuration file used.
  • The Remote MPX Cache Agent configuration files used.
  1. Modify MPXEventTransmitter.xml:
    1. Make sure the version of the file is 2.0. You should have this tag <StExternHandlerModule version="2.0">.
    2. Add/update the Name property in the <Handler> section. This indicates what type of messaging will be used with this configuration. Type ActiveMQ MPX Transmitter, which designates the use of ActiveMQ MPX-type messaging and brokers.
    3. Update the server_names property in all profiles with correct addresses and ports for your MPX Message Brokers.
  2. Modify MPXFileTransmitter.xml:
    1. Make sure the version of the file is 2.0. You should have this tag <StExternHandlerModule version="2.0">.
    2. Add/update the Name property in the <Handler> section. This indicates what type of messaging will be used with this configuration. Type ActiveMQ MPX File Transmitter, which designates the use of ActiveMQ MPX-type messaging and brokers.
  3. Modify Root Cache Agent and Remote Cache Agent configuration files:
    1. Make sure the version of the file is 2.0. You should have this tag <MPXCacheAgent version="2.0">.
    2. In the <MessageBroker> section, add/update the Name property to ActiveMQ MPX Transmitter.
    3. Update the server_names property in all profiles with correct addresses and ports for your MPX Message Brokers.
Parent topic: MPX Installation and Configuration