Agent Builder Environment Variables

Posted by on Nov 24, 2012 in ITM6 | No Comments

These environment variables control the behavior of the agent at runtime. On Windows® systems, these variables are defined in the agent KXXENV file. On UNIX® and Linux® systems, these variables can be set in the agent $CANDLEHOME/config/XX.ini file. XX is the two-letter product code. The agent must be restarted for the new settings to take effect.

 

Environment variable Default Value Valid Values Description
CDP_ATTRIBUTE_GROUP_REFRESH_INTERVAL N/A Any non-negative integer The interval in seconds at which a particular specified attribute group is updated in the background. This works in the same way as CDP_DP_REFRESH_INTERVAL, except it targets only the specified attribute group. If set to 0, the specified attribute group is not updated in the background, even if CDP_DP_REFRESH_INTERVAL is non-zero. The attribute group name in the variable name must be in upper case, even if the actual attribute group name is not.
CDP_DP_REFRESH_INTERVAL 60 if subnodes are defined, otherwise not set Any non-negative integer The interval in seconds at which attribute groups are updated in the background. If this variable is not set or is set to 0, background updates are disabled. If a thread pool is configured (see variable CDP_DP_THREAD_POOL_SIZE) then the attribute groups can be refreshed in parallel. If there is no thread pool, then the updates happen serially, which can take a long time. This is logically equivalent to a thread pool size of 1
CDP_DP_THREAD_POOL_SIZE 15 if subnodes are defined, otherwise not set Any non-negative integer The number of threads created to perform background data collections at an interval defined by CDP_DP_REFRESH_INTERVAL. If this variable is not set or is set to 0, there is no thread pool.
The Thread Pool Status attribute group shows how it is performing, and helps you adjust the thread pool size and refresh interval for best results. By default, the query for this attribute group is not displayed on the agent Navigator tree. If you have not included it in a custom workspace for the agent, you can easily view it by assigning the Thread Pool Status query to a base agent level workspace view.
CDP_DP_SCRIPT_TIMEOUT 30 Any positive integer greater than or equal to 10. The number of seconds to wait for the program launched by a script based attribute group to complete.
CDP_DP_HOSTNAME Name of the first installed network interface An IP address or hostname Sets the preferred host name (network interface) on a multiple interface system. Use this environment variable if the agent binds its listening ports to a non-default network interface address. This is currently only used by the SNMP data provider.

 

Leave a Reply