Configuration Variables

Home  Previous  Next

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

PATROL Configuration Manager (PCM)

wpconfig (Windows)

xpconfig (UNIX/Linux)

The following table recapitulates the configuration variables used by the KM, i.e that apply to all of the monitored hosts. These configuration variables are stored under /SENTRY/NETAPP/<PATROL Object ID> in the PATROL Agent’s configuration.

Variable

Description

AlertActions

List of alert actions to be executed by NetApp Filers KM for PATROL upon a failure.

Default: A PATROL event and an annotation on the parameter.

collectorLockMaxTimeout

Determines the maximum time during which the collect is locked and no other collect can be executed.

debugMode

When set to '1', enables the debug mode of the KM.

Default: Not set.

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.

discoveryLockMaxTimeout

Determines the maximum time during which the discovery is locked and no other discovery can be executed

errorCountAutoResetTimeout

Defines the time in seconds after which the ErrorCount type parameters should be automatically reset when an error is detected.

Default: Not set.

forceSnmpSerialization

When set to ‘1’, forces the serialization of the SNMP requests made by the KM. As the KM is a multi-threaded program, it can send several SNMP requests at the same time on multi-processor computers. Some poorly written SNMP agents may not support this.

Default: Not set.

getSnapShotInformation

When set to 1, the KM lists all snapshots related to volumes. Set this variable to zero to prevent the KM from collecting the information about the snapshots if the number of volumes or snapshots is too important and the discovery and/or collection takes too much time to complete.

Default: Not set (assumes 1).

pausedObjectList

List of the PATROL object path of the paused objects.

pollingIntervalReference

Specifies the polling interval for the collect

productVersion

Determines the version number of the KM currently running. Do not change the value of this variable.

removedObjectList

List of the paths of the objects removed from the monitored environment using the “Remove” KM Command

Default: Not set.

snmpMaxRetry

Number of times the KM will retry performing SNMP requests after a timeout.

Default: Not set (assumed 3).

snmpTimeout

Timeout in seconds for SNMP queries.

Default: Not set (assumed 10 seconds).

startupDelay

Allows the administrator to specify a number of seconds that NetApp Filers KM for PATROL will wait before starting its platform detection and discovery. This variable may be useful on fast booting computers where the PATROL Agent starts before other important instrumentation services, which causes false alerts.

Default: Not set (assumed zero second).

telnetConnectionMethod

Method used by the KM to perform telnet connections.

Default (Windows): Java (if configured in the KM)

Note: If the PATROL agent version is 3.6.011 or later the connection method used by the KM is sopen; otherwise it is left blank

Default (UNIX): Telnet.

ThresholdManagementMode

Specifies how the KM should manage the alert thresholds on parameters. Please read carefully the User Guide chapter for more information on this topic.

Possible values:

<empty> (automatic detection of the suitable threshold management method)

‘AS’ (through PATROL for Event Management)

‘Tuning’ (through the standard "Override parameter" mechanism)

‘None’ (No threshold is set by the KM)

Default: Not set (automatic).

waitingPslExecuteTimeout

Maximum time in seconds after which a command executed in a separate PSL process is considered as failed.

Default: Not set.

Configuration variables specific to the NetApp Filers are listed in the table below. These configuration variables are stored under /SENTRY/NETAPP/<NetApp Filer ID for the NetApp Filer> in the PATROL Agent’s configuration.

Variable

Description

community

SNMP community used by NetApp Filers KM for PATROL to send SNMP requests to the monitored NetApp filer. The version of SNMP used by the KM is version 1 only.

Default: public.

hostname

Hostname or IP address of the controller of the NetApp filer being monitored.

Default: Not set (the hostID will be used).

port

SNMP port on the NetApp filer.

Default: Not set (assumed UDP/162).

 

The following configuration variables are stored in the folder SENTRY/MATSYA/.

Variable

Description

debugMode

When set to '1', enables the debug mode of the Sentry Collection Hub.

Default: Not set.

heapSizeMax

Maximum heap size in megabytes allocated to JVM applications.

Default: 128 MB.

heapSizeMin

Minimum heap size in megabytes allocated to JVM applications.

Default: 128 MB.

debugFolder

Path to the folder where the debug output files will be stored (when debug mode is enabled)

Default: Not set (output to the System Output Window).

javaPassword

Password for the specific account used to run Java.

Default path: /SENTRY/MATSYA/.

javaPath

Path to the folder containing the Java executable used by the Collection Hub.

Default: Not set (The KM will search for a suitable JRE automatically).

javaUsername

Username for the specific account used to run Java.

Default path: /SENTRY/MATSYA/.

overrideJavaCommandLine

To supersede the usual command line to run the JAR file.

Default: Not set.