KBEA-00080 - The agent -matchuser command line option

Article ID:360032827032
1 minute readKnowledge base

Summary

You may experience intermittent Mount::set couldn’t create directory "C:\<directory >" errors after using ecconfig to set all of the agent usernames to the same value. This is because the registry fails to set a registry key to -matchuser 0. (The registry key is HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ElectricAgent\Parameters, string value "extraArgs".)

The -matchuser options are as follows:

  • -matchuser 0 Processes are identified as belonging to the agent by strict process inheritance only; the username is ignored. This means that any action that proxies through an already running service or the client-server runtime subsystem will fail to locate files under emake roots, as will many OLE operations (such as accessing documents through Microsoft Office).

  • -matchuser 1 Processes are identified as belonging to the agent by process inheritance or by matching the username of the agent.

Solution

Do one of the following:

  • Uninstall and reinstall the agents; or

  • Contact Electric Cloud Customer Support to obtain the registry files that set the appropriate registry key

Applies to

  • Product versions: 4.4 and later

  • OS versions: All Windows

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.