Upgrading the MPX Cache Agent

The MPX Cache Agent can be installed on a machine with a previous release.

Note: The goal is to transition StarTeam Server configurations from the older to the newer release.

The MPX Cache Agent can be run as either an application or a service. You can run multiple MPX Cache Agent instances on the same machine, but each needs its own configuration file.

By default, the installation creates a manual MPX Cache Agent service for your convenience. If the installation detects that a MPX Cache Agent service (for example, HKEY_LOCAL_MACHINES\SYSTEM\ControlSet001\Services\CacheAgentService) already exists and is registered, the installation does not set up a service. A warning advises

If the existing MPX Cache Agent service is no longer needed, uninstall the previous MPX Cache Agent release or use the previous release to run CacheAgentService -unregister from a console window to unregister the existing MPX Cache Agent. Note that this is optional and the older release can remain, including the services created for it.
Create an appropriate configuration file for each MPX Cache Agent service desired for the release just installed. You can reuse configuration files from the previous release of MPX Cache Agent by copying them to the new location. You might need to rename them for use with multiple MPX Cache Agent instances.
Using the release just installed, run CacheAgentService -register from a console window for each MPX Cache Agent service desired. Note that the "-name" parameter is used to define a unique service name for each new service created.
If an older MPX Cache Agent is installed, you are not asked whether you are installing a root or remote MPX Cache Agent and are not asked for any configuration information. The sample files (SampleRemoteCacheAgentConfig.xml and SampleRootCacheAgentConfig.xml) are installed (as always), but neither the RootCAConfig.xml nor the RemoteCAConfig.xml file is created.

See the appropriate MPX Administrator’s Guide available on the StarTeam > StarTeam Server <version> > Documentation menu for more information about configuring MPX Cache Agents.