Registry
Allows for the mapping of any executable name to a specific product to include application usage metering. This setting can be used to specify an executable that will not be detected as installed by either RayManageSoft Unified Endpoint Manager or the native package format, or is not detected from Add/Remove Programs.
Create a key under:
Usage Agent\CurrentVersion\Manual Mapper\
This key is the application identifier for the mapper. Create multiple values for this key:
Application="application name (friendly string)"
ExecutablePath="path to executable, may contain regular expression"
|
Be aware: It is possible to either specify a file name or a folder name. When specifying Windows executable paths, the file names can be specified under the Windows Installation directories but not simply Windows system folder names. Windows system folder names such as C:\Windows and C:\Wondows\System32 will be ignored. |
Version="version"
Regex="true" (this is only required if ExecutablePath contains regular expressions)
Priority="priority for this key, which takes precedence over the
default priority specified by the ManualMapperDefaultPriority"
|
Be aware: If no priority is specified, the value of ManualMapperDefaultPriorty is used. |
Typical regular expression syntax is supported for the configuration of the usage metering. See Mozilla Developer Network - Regular Expressions for reference.
|
Note: Expressions that affect vertical spacing, such as newline and carriage returns, have no effect in this context and are not supported. [] is sued to escape characters with a special meaning. |
A summary of commonly used regular expressions is:
Regular Expression |
Matches |
|---|---|
. |
Matches any single character |
* |
Matches any preceding character one or more times |
[xyz] |
A character set. Matches any one of the enclosed characters. A range of characters can be specified by using a hyphen. For example, [a-d] is the same as [abcd]. |
x|y |
Matches x or y. For example Office 10|Office 11 matches Office 10 or Office 11 but not Office 12. |
Example:
Applications in the Windows Directory should not be monitored (recommended). But at a later date one program shall be monitored: Solitaire (sol.exe).
Example key:
Application="Solitaire"
ExecutablePath="C:\WINNT\System32\sol.exe"
Version="1.0"
To track use of sol.exe even if users install it in a different location use wildcards:
Application="Solitaire"
ExecutablePath".*\sol[.]exe"
Version="1.0"
Regex="true"
Values / Range: |
String |
Default value: |
None |
Registry
Installed by: |
Manual configuration |
User setting: |
HKEY_CURRENT_USER\SOFTWARE\ManageSoft Corp\ ManageSoft\Usage Agent\CurrentVersion |
Computer setting: |
[Registry]\ManageSoft\Ussage\CurrentVersion |