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.