Upgrading the StarTeamMPX Message Broker to 6.8

The 6.8 Message Broker that ships has several fixes, making it the only Message Broker that you will want to use with any release mentioned in this section. Install the 6.8 Message Broker over any older version of the 6.8 Message Broker and upgrade any installation of 6.7 Message Brokers. All Message Broker versions are interoperable; consequently, you can upgrade them one at a time.
  1. Install Message Broker 6.8 on the same machine as Message Broker 6.7, letting the installer set it up as an auto-start service.
  2. If you have customized the file STMessageBroker67.ini, copy it to the Message Broker 6.8 installation folder with the new name (STMessageBroker68.ini) so that you can reuse that file with Message Broker 6.8.
  3. Stop Message Broker 6.7, and set the corresponding service (MPX Message Broker 6.7) to Manual so it does not automatically start again.
  4. Start Message Broker 6.8.
  5. Determine that everything is working as expected, and then uninstall Message Broker 6.7. Multiple releases of Message Broker can run on the same machine if each uses its own port. You cannot start both the 6.7 and 6.8 Message Brokers at the same time if they are on the same machine and listening on the same port. Doing so causes a race condition, and the second one to start will fail.