Note: These settings should be used with caution. If misused, the configuration settings can cause non-optimal behavior or prevent TEM from working properly. Please consult with your support technician for questions about changing these configuration settings.
The following configuration settings apply to the TEM Server, TEM Relays, and TEM Clients. These settings are administered through the Custom Settings configuration in the TEM Console's Computer Status dialog.
Some of the Configuration Settings listed on this page are commonly used and have had Tasks created in the TEM Support site to assist in using the Configuration Settings correctly and easily. If such a Task exists it will be indicated in the 'Task Available' field below and you should try to use the Task instead of manually creating the Configuration Setting. If no task exists please follow these steps to set a Configuration Setting:
_BESClient_Inspector_ActiveDirectory_Refresh_Seconds
To control the frequency that Active Directory information will be polled by the TEM Client. |
|
_BESClient_ActionManager_UIMissingHoldMode
To control client behavior for actions with "don't care" user constraint and UI to display. |
|
_BESClient_EMsg_Detail
This configuration setting will enable the TEM Client debug log that will give information about the TEM Client activity. The higher the level of detail, the greater the detail of the messages that are put into the file and/or NT event log. |
|
_BESClient_EMsg_File
Full path to file to store activity messages. If empty string and the computer is not Win9x, activity messages are added to the NT event log. Note: The _BESClient_EMsg_Detail setting must be greater than 0 to use this option. |
|
_BESClient_Resource_WorkIdle
The TEM Client will do work (evaluate relevance) for a designated amount of time then go to sleep for a designated amount of time. This setting controls how many milliseconds to work before going to sleep in each cycle. If this number is high in comparison to the _BESClient_Resource_SleepIdle setting, then the TEM Client will evaluate Fixlet relevance faster, but the CPU usage will be higher. |
|
_BESClient_Resource_SleepIdle
The TEM Client will do work (evaluate relevance) for a designated amount of time then go to sleep for a designated amount of time. This setting controls how many milliseconds to sleep after working in each cycle. If this number is high in comparison to the _BESClient_Resource_WorkIdle setting, then the TEM Client will take longer to evaluate Fixlet relevance, but the CPU usage will be lower. |
|
_BESClient_Resource_QuietEnable
Quiet mode causes the TEM Client to not actively process Fixlets, send in reports, respond to commands, etc. It will basically sit idle until the wakeup time is enabled. A TEM Client can be put in quiet mode for a maximum of 20 hours a day. Note: If you put a TEM Client in quiet mode, it will not send any reports to the TEM Server or respond to any commands so use caution when enabling this setting. |
|
_BESClient_Resource_QuietStartTime
If quiet mode is enabled, you can specify a time for the TEM Client to enter quiet mode. Set the time as a string in the form hh:mm where hh is number between 0 and 23, and mm is a number between 0 and 59. This is the local time for which the TEM Client will quiet down to no activity. If the value is not properly formatted, the client will not enter quiet mode. |
|
_BESClient_Resource_QuietSeconds
If quiet mode is enabled, you can specify the number of seconds the TEM Client should stay quiet. This number must be greater than 0 and less or equal to 72000 (20 hours) in order for the TEM Client to enter quiet mode. In quiet mode, the TEM Client checks once a minute to determine if the quiet time has elapsed. However, the TEM Client will quickly respond to service shutdown requests at any time. |
|
_BESClient_Log_Days
This specifies the number of days the TEM Client logs are retained on a computer. |
|
_BESClient_Comm_UseUrlMoniker
The TEM Client has two methods of communication over the network. The first method uses the Windows URL Monikers API, which is a higher-level network interface that uses the computer's Internet connection settings (such as proxy settings, security settings, etc.). The second method uses the winsock API, which is a lower-level direct socket access layer that doesn't use the computer's Internet connection settings. Using winsock will allow the TEM Client to connect to the TEM Server regardless of the Internet connection settings, but URL Monikers should be used if the Internet connection settings are required for network access to the TEM Server for some reason. |
|
_BESClient_Comm_SkipInternetActiveTest
Before the TEM Client tries to gather it will check the Windows API connection test to determine if an internet connection is available. This setting will allow the TEM Client to ignore the results of the connection test and attempt to gather anyway. |
|
_BESClient_Comm_ListenEnable
When set to 0 the TEM Client will not listen for UDP messages. If the TEM Client does not receive UDP messages it will not receive gather pings sent from the TEM Server notifying the TEM Client of new actions and content. |
|
_BESClient_Register_IntervalSeconds
The TEM Client will contact the ClientRegister CGI on the TEM Server periodically to report its IP address (this is important if the TEM Client changes IP addresses through DHCP), get the TEM Server time, and get the TEM Server version. If this setting is set too high, the TEM Client may not receive UDP "pings" that tell it to gather the latest sites when new actions or new Fixlet content is available. If this setting is set too low, the TEM Client will flood the TEM Server with registration requests. |
|
_BESClient_Download_Direct
Normally, TEM Clients will contact their TEM Relay to receive downloads from the internet. This setting forces the TEM Client to download files directly from the internet using the url specified. This setting takes precedence over other download settings. |
|
_BESClient_Download_DirectOnFail
When the TEM Client fails to download a file from the TEM Server or TEM Relay, it can attempt to download the file directly from the Internet. Note: if there is a proxy in your network that blocks unauthenticated access to the Internet, turning this setting to 1 (True) may not work. |
|
_BESClient_Download_MirrorBypass
When set to 0, the TEM Client will download files directly from the main TEM Server if it can't find a TEM Relay. When set to 1, the TEM Client will not attempt to collect downloads from the main TEM Server. |
|
_BESClient_Download_RetryMinutes
When the TEM Client fails to download a file from the TEM Server or a TEM Relay during an action, it will wait for the specified amount of time then try again. After each failed attempt, it will double the retry time. |
|
_BESClient_Download_RetryLimit
When the TEM Client fails to download a file from the TEM Server or a TEM Relay during an action, it will retry the specified number of times (each time it will double the amount of time it waits to retry). |
|
_BESClient_Download_ChannelThreshold
The TEM Client can simultaneously download two files at a time by using one "main channel" and one "thin channel". The main channel is used for all downloads, but if the main channel is currently downloading a large file, the thin channel can be used to download smaller files if the download size is less than the specified threshold. If this setting is set high, the TEM Client will use the thin channel to download larger files, which could slow down actions because two large files may be downloading at the same time (each using half the bandwidth) instead of one file after the other. If this setting is set low, the thin channel will be used for only very small file downloads. |
|
_BESClient_Download_LimitBytesPerSecond
The TEM Client can "throttle" the download speed by limiting the amount of bytes it downloads per second. This setting is especially effective if network bandwidth is a concern (such as with a dial-up connection). If the TEM Server or TEM Relay is also set to use throttling, the lower of the two values will be used as the download speed. |
|
_BESClient_Download_InactivityTimeout
When the TEM Client is downloading a file from the TEM Server or TEM Relay, it sometimes will experience some inactivity because of network problems, disconnections, etc. When there is inactivity, the TEM Client will wait for the specified number of seconds to receive more data before aborting the download. |
|
_BESClient_Report_MinimumInterval
When the TEM Clients are performing an action, they will send reports of the status of the action (Evaluating, Waiting, Running, Fixed, etc.). This setting controls the minimum number seconds between sending reports. If this number is too high, the TEM Clients will take a long time update their action status. If this number is too low, it will put extra load on the TEM Server to process the extra action status reports. |
|
_BESClient_ActionManager_RemindAutoPostponeSeconds
If users are allowed to postpone running an action a dialog will appear on the TEM Client computer asking the user how long they want to postpone the action. After some amount of time the action will automatically be postponed and the dialog will close. This setting controls the length of time to display the postponement dialog. |
|
_BESClient_ActionManager_ReminderDialogTitle
This setting controls the title of the action postponement dialog that appears on TEM Client computers for actions that can be postponed by users. By default the title is 'Reminder'. |
|
_BESClient_Inspector_DisableWMI
This setting will disable the use of any inspectors that make calls to the Windows WMI. WMI has been found to cause problems on some computers, especially older versions of Windows (95 and 98). Problems include high CPU usage and 'blue screen' crashing of Windows. WMI is used by some some optional retrieved properties. |
|
_BESClient_ActionManager_PendingRestartExclusions
String(s) residing in the key X which are to be ignored by the TEM Client when determining if a restart is needed. |
|
_BESClient_ActionManager_LocaleEnable
This configuration setting will enable TEM Clients to�display non-English messages if the translation files are in�place (TEM 6.0+). |
|
_BESClient_ActionManager_RemindTakeActionsNow
This configuration setting will remind users periodically that they have actions to run that they have postponed (TEM 6.0+). |
|
_BESClient_ActionManager_SkipVoluntaryOnForceShutdown
A value of 1 will cause the client to handle restart and shutdown operations in a forceful way that will not give applications the opportunity to cancel the operation. Terminal services systems should always have this set to 1. |
|
_BESClient_ActionManager_TaskbarIcon
This configuration setting will determine whether or not message boxes will have an entry in the Windows task bar (TEM 6.0+). |
|
_BESClient_Comm_CommandPollEnable
When this configuration setting is enabled, computers will poll their parent relay for UDP commands they may have missed (TEM 6.0+). |
|
_BESClient_Comm_CommandPollIntervalSeconds
This configuration setting determines how often the TEM Client will check with its TEM Relay for any gathers or refreshes, if the "_BESClient_Comm_CommandPollEnable" setting is enabled. Avoid setting this to be less than 900 seconds due to performance implications (TEM 6.0+). |
|
_BESClient_Download_DownloadsCacheLimitMB
This configuration setting sets the TEM Client download cache limit (TEM 6.0+). |
|
_BESClient_Download_UtilitiesCacheLimitMB
This configuration setting sets the Utility cache limit (TEM 6.0+). |
|
_BESClient_RegistrationManager_RegisterWith51Relays
This configuration setting enables a TEM 6.0 Client to gather from a TEM 5.1 Relay for troubleshooting purposes (TEM 6.0+). |
|
_BESClient_Resource_InterruptSeconds
When a TEM Client receives a UDP message but is too busy processing a relevance clause, this TEM 6.0 configuration setting determines the length of time the TEM Client will wait before it stops evaluating the relevance clause to deal with the UDP message. |
|
(Set on the TEM Clients to control their behavior to the TEM Relays.)
_BESClient_RelaySelect_IntervalSeconds
The TEM Relay selection algorithm will run this often. If a closer TEM Relay is found, the closer TEM Relay will be used. Note that if the TEM Relay selection is failing, this interval is ignored. |
|
_BESClient_RelaySelect_MinRetryIntervalSeconds
If the TEM Relay selection algorithm fails (no TEM Relays are found), the TEM Client will try again after this many seconds. The TEM Client will double this value on each successive retry that fails to locate a TEM Relay. |
|
_BESClient_RelaySelect_MaxRetryIntervalSeconds
After failing to find a TEM Relay, the TEM Client will continue to try to find a TEM Relay. Each time it fails, the TEM Client will double the time it spends until this maximum is exceeded. Then the TEM Client will try with this maximum retry interval until it successfully selects a TEM Relay. |
|
_BESClient_RelaySelect_MaximumTTLToPing
The maximum number of network hops (Time To Live) a TEM Client will search over before considering its automatic relay selection attempt a failure. A TEM Client will be able to find only TEM Relays that are less then the maximum number of network hops away from the TEM Client. This setting can be used to limit the ICMP traffic generated by the automatic relay selection algorithm. |
|
_BESClient_RelaySelect_PingDelayMicroSeconds
During the automatic relay selection algorithm, the TEM Client will wait this long between each iteration. On each iteration the TEM Client sends ICMP packets with a TTL greater then the last iteration. This setting can be used to slow down the automatic relay selection algorithm and reduce the network traffic generated. |
|
_BESClient_RelaySelect_ResistFailureIntervalSeconds
This setting controls the time interval that the TEM Client will ignore communications errors before performing TEM Relay selection. Once a TEM Relay has been selected and the TEM Client has successfully registered, it will ignore errors when it attempts to post its results to the TEM Relay or TEM Server for this long before deciding to choose another TEM Relay. |
|
_BESClient_RelaySelect_FailoverRelay
This setting determines what the TEM Client will do in the event that no TEM Relays respond to TTL pings up to the maximum configured distance. In this event, the TEM Client will attempt to register with the defined failover TEM Relay before trying the TEM Server. This setting was first introduced in TEM 5.1. |
|
_BESClient_RelaySelect_TertiaryRelayList
When using manual relay selection, this setting is a way to specify a list of failover relays to choose from when the primary and secondary relays are not reachable. This setting is a semi-colon delimited list of relays to try. Manual selection goes in this order, primary/secondary/tertiary list/failover/root. For automatic relay selection you should look at the document on relay affiliation. |
|
_BESClient_Relay_NameOverride
If the TEM Relay is using a DNS name that is not accessible by all TEM Clients, an override can be used. If this value is set on the TEM Relay computer, it will return this setting for the dns name inspector, which will be reported to the TEM Server and used by other TEM Clients to locate the TEM Relay. You can also use this value if you want your TEM Clients to locate their relays by IP address, rather than DNS name lookup. For example, if the TEM Relay is reported at relay1:52311, you can use this setting to make the TEM Relay be accessible at relay1.company.com:52311 or even 192.168.100.123:52311. (Note: this value needs to be set on only the one TEM Relay computer and not on all the TEM Client computers.) |
|
_BESClient_Relay_ControlData
Setting this setting to 0 will cause the TEM Client to use only the TEM Relay system to collect downloads and all other interactions will interact directly with the main TEM Server. This setting is provided in order to allow a configuration where the load on a TEM Relay does not significantly change from the 3.x TEM Relay implementation. Note that the TEM Clients with this setting of 0 will not manage their TEM Relays configuration automatically. TEM Clients with this setting will ignore the automatic configuration setting and will collect downloads from their primary and then secondary TEM Relays. |
|
_BESClient_Comm_CommandPollEnable
Setting this setting to 1 will cause the TEM Client to poll for new gathers or refreshes. Please refer to the setting _BESClient_Comm_CommandPollIntervalSeconds for the timing of the poll. Setting this to a value of 0 will disable this mechanism. This setting was first added in TEM 6.0. |
|
_BESClient_Comm_CommandPollIntervalSeconds
This setting determines how often the TEM Client will check with its TEM Relay for any new gathers or refreshes. It must be enabled with the setting _BESClient_Comm_CommandPollEnable |
|
_BESGather_EMsg_Detail
This configuration setting will enable the TEM Gather debug log that will give information about the TEM Gather activity. The higher the level of detail, the greater the detail of the messages that are put into the file and/or NT event log. |
|
_BESGather_EMsg_File
Full path to file that stores activity messages. If empty string and the computer is not Win9x, activity messages are added to the NT event log.Note: The _BESClient_EMsg_Detail setting must be greater than 0 to use this option. |
|
_BESGather_Comm_UseUrlMoniker
The TEM Gather service has two methods of communication over the network. The first method uses the Windows URL Monikers API, which is a higher-level network interface that uses the computer's Internet connection settings (such as proxy settings, security settings, etc.). The second method uses the winsock API, which is a lower-level direct socket access layer that doesn't use the computer's Internet connection settings. URL Monikers are used by default to connect to the Internet using the Internet connection settings. Using winsock will allow TEM Gather to connect to the Internet without using the Internet connection settings. |
|
_BESGather_Download_CheckParentFlag
When a file is requested from the TEM Relay, it can either download the file from the TEM Server or download the file directly from the Internet. If this setting is set to 1 (True), then the TEM Relay will first attempt to download the file from the TEM Server. Note: This setting should stay at 0 (False) for the TEM Server. |
|
_BESGather_Download_CheckInternetFlag
When a file is requested from the TEM Relay, it can download the file directly from the Internet instead of from the TEM Server. If this setting is set to 1 (True), then the TEM Relay will first attempt to connect to the TEM Server (if the _BESGather_Download_CheckParentFlag is set to 1) then directly connect to the Internet if the download from the TEM Server fails. Note: This setting should stay at 1 (True) for the TEM Server. |
|
_BESGather_Download_CacheLimitMB
TEM Gather will cache downloaded files on the TEM Server or TEM Relay computer so that the file will not need to be downloaded again if the action is reissued. This setting will specify how many MB to cache before overwriting the old files. When the cache is full, the least recently used files will be replaced. Note: This caching number applies to both cached files and cached action folders so the total space that the TEM Relay will take up is actually 2x cache size (by default this is 2 GB). |
|
_BESGather_Download_RetryMinutes
When TEM Gather fails to download a file from the Internet or its parent during an action, it will wait for the specified amount of time then try again. After each failed attempt, it will double the retry time. |
|
_BESGather_Download_RetryLimit
When TEM Gather fails to download a file from the Internet or its parent during an action, it will retry the specified number of times (each time it will double the amount of time it waited to retry the last time). |
|
_BESGather_Download_ChannelThreshold
TEM Gather can simultaneously download two files at a time by using one "main channel" and one "thin channel". The main channel is used for all downloads, but if the main channel is currently downloading a large file, the thin channel can be used to download smaller files if the download size is less than the specified threshold. If this setting is set high, TEM Gather will use the thin channel to download larger files, which could slow down actions because two large files may be downloading at the same time (each using half the bandwidth) instead of one file after the other. If this setting is set low, the thin channel will be used for only very small file downloads. |
|
_BESGather_Download_LimitBytesPerSecond
TEM Gather can "throttle" the download speed by limiting the amount of bytes it downloads per second. This setting is especially effective if network bandwidth is a concern (such as with a dial-up connection). When this setting is used on the TEM Relay, the TEM Relay will limit its download speed when downloading from the TEM Server or parent TEM Relay. As of TEM 5.0, this setting throttles all downloading traffic. |
|
_BESGather_Download_InactivityTimeout
When the TEM Gather service is downloading a file from the Internet or its parent, it sometimes will experience some inactivity because of network problems, disconnections, etc. When there is inactivity, TEM Gather will wait for the specified number of seconds to receive more data before aborting the download. |
|
_GatherService_ForwardGet_UserAgentOverride
This string determines the User-Agent: string in the HTTP headers that the BES Gather Services uses |
|
(Set on the TEM Client to control the TEM Relay component.)
_BESRelay_Selection_AutoSelectableRelay
A value of "0" makes the TEM Relay unavailable for auto seletion after the next actionsite propagation. A value of "1" allows the TEM Relay to be used by TEM Clients for auto selection. |
|
_Enterprise Server_ClientRegister_MaxChildCount
Maximum number of clients the TEM relay will allow to register. Once this limit is reached, connections will be rejected. |
|
_Enterprise Server_ClientRegister_MaxChildRelayCount
Maximum allowed number of TEM Clients that are TEM Relays. This limit is calculated independently of the MaxChildCount -- it can be used to keep a TEM Relay from indirectly acquiring a lot of TEM Clients by picking up too many children that are TEM relays. |
|
_BESRelay_Log_Verbose
A non-zero value will enable verbose logging on the TEM Relay for troubleshooting purposes. This setting increases the information written to the existing logfile.txt and should not be left on during normal operation. |
|
_BESRelay_HTTPServer_MaxConnections
Maximum number of simultaneous connections, once this limit is reached, connections will be rejected. |
|
_BESRelay_HTTPServer_ThrottleKBPS
'Global' throttling on outgoing data to TEM Clients from the TEM Relay/Server (0 means no limit). If its value is 1000 and there are 100 clients downloading simultaneously, the TEM Relay/Server will send data to each TEM Client at 10KBPS (for a total of 1000KBPS). Throttling is implemented by sending a chunk of data at full speed, and then waiting chunksize/KBPS seconds before sending the next chunk so if all requests are smaller than the chunk size, then there may be no throttling at all. Uploaded data to other TEM Relays/Server is not throttled by this setting (PostResults data). |
|
_BESRelay_PostResults_ResultCountLimit
The TEM Relay accumulates reports from the TEM Clients and then compresses them and sends them to the parent TEM Relay or TEM Server. This setting sets the maximum number of reports in each compressed report. Results are forwarded once the ResultCountLimit or ResultTimeLimit is reached. Setting a low value will cause more network traffic with increased response time. A higher value will result in less network traffic with slower response time. |
|
_BESRelay_PostResults_ResultTimeLimit
The TEM Relay accumulates reports from the TEM Clients and then compresses them and sends them to the parent TEM Relay or TEM Server after waiting a specified amount of time. This setting sets the amount of time to wait before sending the reports. The longer the wait, the more latency before the TEM Server receives the reports from the TEM Clients, but the greater the efficiency of the system (lower network traffic). |
|
_BESRelay_HTTPServer_HttpLogDirectoryPath
If set a connection log will be written to this path. A new log file will be created each day with the days date as teh name of the file. Connection logs can get quite big, gigabytes per day, so this setting should be used for only troubleshooting purposes. |
|
_BESRelay_HTTPServer_HttpLogExpirationDays
Sets the number of days to keep connection logs for. After this many days the older connection logs will be deleted. |
|
_Enterprise Server_ClientRegister_ProxyUser
A TEM Relay can be set up to use a proxy server when downloading files. This could be useful if their is a proxy between the TEM Relay and the TEM Server or if the TEM Relay is connecting directly to the internet for downloads and must use a proxy. This setting controls the username used to authenticate with the proxy if the proxy requires authentication. |
|
_Enterprise Server_ClientRegister_ProxyPass
A TEM Relay can be set up to use a proxy server when downloading files. This could be useful if their is a proxy between the TEM Relay and the TEM Server or if the TEM Relay is connecting directly to the internet for downloads and must use a proxy. This setting controls the password used to authenticate with the proxy if the proxy requires authentication. Warning: The password will be stored in plain text within the registry. |
|
_Enterprise Server_ClientRegister_ProxyServer
A TEM Relay can be set up to use a proxy server when downloading files. This could be useful if their is a proxy between the TEM Relay and the TEM Server or if the TEM Relay is connecting directly to the internet for downloads and must use a proxy. This setting controls the hostname used to reach the proxy. |
|
_Enterprise Server_ClientRegister_ProxyPort
A TEM Relay can be set up to use a proxy server when downloading files. This could be useful if their is a proxy between the TEM Relay and the TEM Server or if the TEM Relay is connecting directly to the internet for downloads and must use a proxy. This setting controls the port used by the proxy server. |
|
_BESRelay_ClientRegister_BatchCount
This setting controls the number of UDP pings the TEM Relay will send before delaying for a period of time. The length of the delay is controlled by _BESRelay_ClientRegister_BatchDelay. This setting could be used to limit the rate at which a TEM Relay sends out UDP pings if this network traffic is harmful in some way. |
|
_BESRelay_ClientRegister_BatchDelay
This setting controls how long the TEM Relay will wait between sending out a batch of UDP pings to TEM Clients. This setting could be used to limit the rate at which a TEM Relay sends out UDP pings if this network traffic is harmful in some way. |
|
_BESRelay_ClientRegister_MaxRelayPathLength
This setting is used to control the maximum length a chain of TEM Relays can extend. The setting prevents circular chains of TEM Relays from forming by automatic TEM Relay selection. This setting could be used to stop long chains of TEM Relays from forming or create a maximum depth a TEM Relay can be from the TEM Server. |
|
_BESRelay_ClientRegister_ClientRegistrationExpirationPeriod
This setting controls how quickly TEM Relays mark TEM Clients as expired. TEM Clients have this length of time to register again before their license is made available for use by another TEM Client. This setting could be used to increase the rate at which licenses are transfered from offline TEM Clients to active TEM Clients when the total number of clients gets above the license seat count. |
|