ELM Service Agent Registry Entries

<< Click to Display Table of Contents >>

Navigation:  Technical Resources > Registry Entries >

ELM Service Agent Registry Entries

The table below lists registry entries from the Windows Registry recognized by ELM .

•Not all registry entries are created by default; some must be manually created.

•If a Name entry is not in the registry, ELM will use the default value listed.

•Not all values should be edited through the registry; when this is true, the appropriate interface is given in the Description.

•This table does not include the COM classes and libraries that are registered and written to the Registry (under HKEY_CLASSES_ROOT) during Setup.

•This table does not include the ELM Server service registry entries
(under HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services).

 

Service Agent Registry Keys

HKEY_LOCAL_MACHINE \ SOFTWARE \ TNT Software \ ELM Manager Agent \ 7.5.0 \ Settings

OR if 64bit Operating System

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\TNT Software\ELM Manager Agent\7.5.0\Settings

Name
Type
Default Value
Restart Required
Description

AllowSecondsCorrelationTimeOut
REG_DWORD
0
MMC Restart required.

When set to a value of 1 this key allows the use of seconds in correlation views.  Changing this value to allow seconds can result is false timouts and is generally not recommended..  

Name
Type
Default Value
Restart Required
Description

CacheDataMaxSize
REG_DWORD
104,857,600 (100MB)
Service Agent restart required
This value is set through the Agent properties. Controls the maximum size of the ELM Agent cache file size.

Name
Type
Default Value
Restart Required
Description

CachePath
REG_SZ
%systemroot%\TNTAgent
Service Agent restart required
This value is set through the Agent properties. Controls the destination of the ELM Agent cache file on the local computer. Also see MinDiskFreeSpaceInMBToContinueCaching.

Name
Type
Default Value
Restart Required
Description

MinDiskFreeSpaceInMBToContinueCaching
REG_DWORD
20 MB
Service Agent restart required
Controls the minimum free space in MB before a ELM Agent will write to a cache file. If disk free space drops below this value, then the Agent will stop saving data to the cache file. Logical drive checked is determined by CachePath.

Name
Type
Default Value
Restart Required
Description

MonitorNumLoggingChars
REG_DWORD
512
Service Agent restart required
This key controls the number of bytes that TNTDiag will capture for Monitor Item activity.  Use the Agent registry key when the Monitor Items are assigned to Service Agents.

Name
Type
Default Value
Restart Required
Description

ProcessCollectedEvtFiles
REG_DWORD
1
Service Agent restart required
This key stores the latest copy of evt(x) file in cache path for agent.

Name
Type
Default Value
Restart Required
Description

RemoteAgentInstall
REG_DWORD
1
No
Users should not change this registry entry.  This value is set internally by ELM. This value indicates if the Service Agent was installed through the ELM Console (1) or using Windows Installer (0).

Name
Type
Default Value
Restart Required
Description

RestartHandleCountMax
REG_DWORD
4000
Service Agent restart required
When the handle count of the TNTAgent.exe process exceeds this value the service will restart itself. The minimum value you can set is 2000. When this is triggered, the Service Agent will log event 5066 in the application event log and restart the Service Agent.

Name
Type
Default Value
Restart Required
Description

RestartThreadCountMax
REG_DWORD
400
Service Agent restart required
When the thread count of the TNTAgent.exe process exceeds this value the service will restart itself. The minimum value you can set is 200. When this is triggered, the Service Agent will log event 5066 in the application event log and restart the Service Agent.

Name
Type
Default Value
Restart Required
Description

RestartVirtualMemoryMaxMb
REG_DWORD
400
Service Agent restart required
When the virtual memory allocation for the TNTAgent.exe process exceeds this value the service will restart itself. The minimum value (in MB) you can set is 200. When this is triggered, the Service Agent will log event 5066 in the application event log and restart the Service Agent.

Name
Type
Default Value
Restart Required
Description

SMTPMaxTimeoutInSeconds
REG_DWORD
300
Service Agent restart required
Specifies the maximum number of seconds ELM will wait for an SMTP Server to respond.  This entry sets an upper bound which limits both the ELM SMTP Monitor and the ELM SMTP Notification Method.  The lower bound is hard-coded to 5 seconds.  Valid values for this key are 5-4,294,967,295.

An ELM SMTP Notification Method wait-time will use the SMTPEmailNotificationTimeOut registry key (or default value) if it is within the upper and lower bounds.  Otherwise the nearest boundary value is used.  This would be made in the ELM Server.

An ELM SMTP Monitor wait-time will use two times the Quality of Service (QoS) value if it is within the upper and lower bounds. Otherwise the nearest boundary value is used. <%REG_VIRTUAL_SERVICE%>

Name
Type
Default Value
Restart Required
Description

TCPAgentPort
REG_DWORD
1253
Service Agent restart required
This ADDS a listening port, which can be verified by using netstat. Changing TCPAgentPort to 1353 will result in both 1253 and 1353 to being listened to.

Name
Type
Default Value
Restart Required
Description

UseShellExecuteForScripts
REG_DWORD
0
No
This value will alter the method used by the Run Action in Monitor Items assigned to Service Agents.  Setting it to 1 will enable script execution on a remote system, but will disable environment variable expansion.

Name
Type
Default Value
Restart Required
Description

WebPageMonitorCaseInsensitive
REG_DWORD
0
Service Agent restart required
Specifies whether the fetched web pages are treated as case-sensitive (0) or not (1).

To use this with Virtual Agents this entry must be manually entered in the registry of the ELM Server computer.

Applies to EEM only.