Installing an MPX Cache Agent

Whether a MPX Cache Agent operates as a root MPX Cache Agent or a remote MPX Cache Agent is determined solely by its configuration. The installation of the MPX Cache Agent is similar in both cases except for consideration of the computer on which to install it:

The root MPX Cache Agent requires access to the vault for the server configuration that it services. Consequently, it is usually installed on the same computer as the Server. Alternatively, if it can be installed on a network-near computer to prevent the Root MPX Cache Agent from competing for CPU or network I/O with the corresponding server configuration. However, this requires it to access the vault files and the CacheJournal.dat file by way of a shared network drive, so use this option only when a high-speed network is in place .
Remote MPX Cache Agents should be installed in each geographic location that can benefit from local data access. One approach is to install a MPX Cache Agent in each network environment that local users can access over a highspeed LAN. (For example: Install two remote MPX Cache Agents at headquarters, one each for engineering and QA; install one at each regional office.) Another beneficial use of the MPX Cache Agent is to install an instance on a computer dedicated to a check-out intensive application such as a build utility. There is no limit on the number of MPX Cache Agents that can be installed throughout an enterprise. However, keep in mind that each MPX Cache Agent requires access to a Message Broker. For more information about clouds, see “Understanding Clouds” in the appropriate MPX Administrator’s Guide.

To install a root MPX Cache Agent or remote MPX Cache Agent on Microsoft Windows:

Log on to the computer as the administrator or as a user with administrative privileges.
Navigate to the directory that contains the downloaded files.
Run the downloaded installer.
Select a language from the list, and then click OK.
On the License Agreement page, read the agreement. If you agree with the license agreement, click I accept.... If you do not accept the license agreement, you cannot install the product.
On the Choose Install Folder page, browse for the location to be used as the installation folder.

The default installation path is C:\Program Files\Micro Focus\MPX Cache Agent <version>.
Choose a Root MPX Cache Agent or Remote MPX Cache Agent installation.

Root MPX Cache Agent installation

Message Broker Address

Enter the host name or address of the Message Broker that the Root MPX Cache Agent will use to communicate with other MPX Cache Agents and clients. This value can optionally include the protocol prefix (tcp:) and port number suffix (:1234). The port number must be provided if the Message Broker is not using the default port (5101 for StarTeamMPX and 61616 for ActiveMQ MPX). For example: tcp:MBServer1:5123

Server Cache folder

Click Choose to browse to the folder path that contains the vault cache of the server configuration that the MPX Cache Agent will serve. This path must be relative to the computer on which the Root MPX Cache Agent is being installed.

Remote Cache Agent installation

Message Broker Address

Enter the host name or IP address of the Message Broker that the Remote MPX Cache Agent will use to receive file content messages and to communicate with other MPX Cache Agents and clients. A Remote MPX Cache Agent should be configured to use a Message Broker and the tcp: address.

This option is described in more detail in “Configuring a Remote Cache Agent” in the in the MPX Administrator’s Guide.
On the Choose Shortcut Folder page, use the default setting (that is, keep the Other option button set to C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Micro Focus\MPX Cache Agent <version>).
On the Pre-installation Summary page, review the settings and click Previous one or more times if you want to change the installation options. Then return to the Pre-installation Summary page, and click Next or Install.
On the Install Complete page, click Done.