Global Configuration Variables

Home  Previous  Next

This section lists the configuration variables used by Monitoring Studio KM for PATROL. Configuration variables are stored in the PATROL Agent configuration and can be managed through:

PATROL Configuration Manager (PCM)
wpconfig.exe (Windows)
xpconfig (UNIX/Linux)

Global configuration variables are stored under the /SENTRY/STUDIO/ folder in the configuration tree.

importantRestart the PATROL Agent or force a discovery for changes made to configuration variables to take effect.

The following table sums up the configuration variables used by Monitoring Studio globally, i.e that apply to all of the monitored hosts. These configuration variables are stored under /SENTRY/STUDIO/ in the PATROL Agent’s configuration.

Variable

Description

addTimestampToLastMatchingLines

When set to '1', adds a timestamp to the matching lines when stored in the PATROL Agent namespace.
Default: unset.

bufferMaxBytes

Maximum number of bytes stored in the PATROL namespace (memory) for one Monitor collection result. If the result is over the number of bytes set, it will be stored in a temporary file instead.

collectionErrorCountAutoAcknowledgeTime

Number of seconds after which the SEN_MS_MAIN/CollectionErrorCountParameter is reset if no new error is detected.

Default: 8100 (2 hours and 15 minutes).

collectionHubHeapSizeMax

Maximum heap size in megabytes allocated to the Java Collection Hub.

Default: Not set (assumed 128 MB).

collectionHubHeapSizeMin

Minimum heap size in megabytes allocated to Java Collection Hub.

Default: Not set (assumed 128 MB).

collectionHubOverrideJavaCommandLine

Command line used by the KM to launch the Java Collection Hub.

Default: Not set

This variable should only be set if instructed by Sentry Support.

completeCommandLineOnAIX

When set to '1', the process information is obtained using the standard (system V) "ps" command instead of the custom AIX command.

defaultExitStatusCodes

Command line default status and status code, separated by a line. This is used to set the default values in the appropriate fields of the command line wizard.
Default: 1\n0.

dfCommand

df command executed on Linux and UNIX systems to retrieve file systems information.

dfCommand2

df command executed to retrieve filesystem inode usage information for the given Linux and UNIX systems.

disableI2D

When set to 1, no MetaTokenID and no MetaFQDN information will be set in the PATROL namespace for any Host.

disableJRECheck

To disable the validation tests of the JRE used by the KM to run Java code and therefore force the KM to use a non-Sun or non-Oracle JRE.

disablePslExecuteBugWorkaround

When set to ‘1’, disables the workaround in the KM for a bug in the PslExecute() PSL function.

If the KM detects that the version of the PATROL Agent is affected by the PslExecute() bug, it uses an alternate technique to create asynchronous threads with the event_trigger() function and the RemPsl standard event. The disablePslExecuteBugWorkaround variable disables this workaround.

Default: Not set.

doNotUsePslExecuteForChildren

When set to '1', String Searches, Numeric Value Extractions, dynamic objects and text transforms collects are not called through a PSL execute call. This should be used only if the PATROL Agent is affected by the PSL execute bug.
Default: Not set (false).

fileFindCommand

On Linux and UNIX systems, command line to retrieve all files matching the monitored file mask.
Default: find %{FILENAME} -prune.

fileFindCommandOneDay

On Linux and UNIX systems, command line to retrieve the list of files matching the monitored file mask that were created or modified less than 24 hours ago.
Default: find %{FILENAME} -prune -mtime -1.

fileFindCommandSevenDays

On Linux and UNIX systems, command-line to retrieve the list of files matching the monitored file mask that were created or modified less than 7 days ago.
Default: find %{FILENAME} -prune -mtime -8.

folderUnixLsCommand

On Linux and UNIX systems, command line to retrieve all files in the monitored folder.
Default: /bin/ls -atp1 %{FOLDERPATH}.

folderUnixRecursiveLsCommand

On Linux and UNIX systems, command line to retrieve all files in the monitored folder, including sub-folders.

Default: /bin/ls -atpR1 %{FOLDERPATH}.

forceSnmpSerialization

When set to '1', forces the serialization of the SNMP requests. Several SNMP requests may be sent at the same time on multi-processor computers. Some poorly written SNMP agents may not support this.
Default: Not set.

httpRequestConnectionType

HTTP request connection method: sopen or telnet.
Default: auto-detect.

LastMatchingLinesNumber

Maximum number of matching lines that should be stored in the PATROL Agent namespace. Default: 50.

maxConcurrentHostDiscoveryThreads

Maximum number of concurrent Host discovery threads.
Default: 50.

maxConcurrentHostSSHConnections

Maximum number of concurrent SSH connections to a Host.
Default: 10.

maxConcurrentTCPChannels

Maximum number of concurrent socket channels open when performing a Host TCP availability check.
Default: 10.

maxConcurrentWMIQueries

Maximum number of concurrent WMI queries.
Default: 10.

maxFileSizeRead

Maximum numbers of characters that should be read from a LOG file in a single collect to perform String Searches, Numeric Value Extractions, etc. Remaining text will be read at the next collect.
Default: 33554432 bytes (32MB).

maxParameterValueLength

Maximum number of characters a text parameter should contain. Once this limit is reached, the value is truncated.
Default: 1048576.

newerFileFindCommand

On Linux and UNIX systems, command line to retrieve all files matching the monitored file mask that are newer than the currently monitored file.
Default: find %{FILENAME} -prune -newer %{MONITOREDFILE}.

psCommand

ps command executed on Linux and UNIX systems to retrieve process information.

psCommand2

Additional "ps" command executed on Linux and UNIX systems to retrieve additional process information.

psCommand3

ps command executed on Linux and UNIX systems to retrieve process performance data.

restartFromStartUponFileSizeDecrease

When set to '1', LOG files are read from the start if their size decreases, indicating the file was purged.
Default: 1.

temporaryFolder

Path to the folder where temporary files used by the KM are stored. By default, this is set to C:\Windows\Temp on Windows based PATROL Agents and /var/tmp for UNIX/Linux based Agents.

windowsWebRequestScriptPath

Path to the VB script used to execute web requests on Windows.
Default: Not set (PATROL bin folder\SEN_MS_winHTTP.vbs)

wmiQueryColumnSeparator

When multiple values are returned by a WMI query, separator used to split the values.
Default: '.