Before Installing an MPX Cache Agent

When installing an MPX Cache Agent that will be used as a root MPX Cache Agent, StarTeam Server must be installed first. After you have installed StarTeam Server, you can install the other components in any order.

The following is a recommendation for installing MPX components:

Install StarTeam Server. The MPX Event Transmitter and MPX File Transmitter are installed automatically with StarTeam Server.
Install either type of MPX Message Broker (ActiveMQ MPX or StarTeamMPX) depending on the desired configuration.
Important: You can run multiple instances of the MPX Message Broker, but they must be of the same type. If a single MPX Cache Agent is used for multiple configurations, the configurations and the MPX Cache Agents must be configured to use the same type of MPX Message Broker.
Install the root MPX Cache Agent. You need to install it only once per machine, even when that machine has more than one server configuration. You run multiple instances to support multiple StarTeam Server configurations. Each server configuration must have its own root cache agent instance.
Install the remote MPX Cache Agent. This is the same installer as the root MPX Cache Agent. The remote MPX Cache Agents can use the same Message Broker as the root MPX Cache Agent, but multiple Message Brokers are suggested for distributed teams, especially over distances. In practice, remote MPX Cache Agent usually use remote Message Brokers.
Before you start a root MPX Cache Agent:
1. Start each server configuration that you will use with MPX Cache Agent. Doing this causes the MPX File Transmitter to generate or upgrade a CacheJournal.dat file for each configuration.
2. (Optional) Modify the MaxJournalAge parameter’s value in the FileTransmitter.xml file to represent the maximum number of days for which records will be kept within the Journal file. The pre-configured value is 180 days. Note that the Journal file is “trimmed” of expired records (those whose age exceeds the MaxJournalAge value) only when the server configuration is started.