Dependencies - Startup Order for MPX Components

The startup order of MPX components is important:

  • The Message Broker is core to everything, so you should start it first. There is no particular order to starting root and remote Message Brokers. In general, if the Message Broker used by an MPX component is not running, the MPX component fails to start. For example, if a Root MPX Cache Agent is installed as an auto-start service and uses a Message Broker on the same computer, the Root MPX Cache Agent may start more quickly than the Message Broker. In this case, the Root MPX Cache Agent fails. The fix is to make the Root MPX Cache Agent service depend on the Message Broker service.

  • You should start the MPX-enabled StarTeam Server configuration next. You must start it at least once before starting the Root MPX Cache Agent to create the CacheJournal.dat file. The first time you start a StarTeam configuration after a MPX File Transmitter has been activated, it creates the CacheJournal.dat file for that server configuration. If the Message Broker it uses is not running, the server configuration starts in non-MPX mode. This means the server will work, but no MPX messages will be broadcast, and "fixing" it requires restarting the server.

  • You should start the Root MPX Cache Agent(s) next. If the Message Broker it uses is not running, or if the CacheJournal.dat file does not exist for the server configuration it is tracking, the Root MPX Cache Agent fails to start. Once the CacheJournal.dat file exists, the root MPX Cache Agent no longer has a start-order dependency with the StarTeam Server configuration. It can start before or after the StarTeam Server configuration has started.

  • You can start the Remote MPX Cache Agent(s) at any time. It is independent of all other MPX components except for the Message Broker to which it connects. If that Message Broker is not running, the Remote MPX Cache Agent fails to start. However, if one of the Root MPX Cache Agent or the StarTeam Server configuration it is tracking are not running, it detects them when they are started.

  • The MPX-enabled StarTeam Server configuration must be running before the MPX Cache Agents or clients can access it.

  • The MPX Cache Agents must be running before the clients can retrieve files from them.