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/SEN_NAP/ in the PATROL Agent’s configuration.

Variable

Default Value

Description

AlertActions

n/a

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

automaticReinitialization

0 = disabled

If set to 1, triggers a re-initialization of the KM. The discovery checks this variable every minute and deletes it before performing the re-initialization.

collectionHubHeapSizeMax

1024

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

collectionHubHeapSizeMin

None

Minimum heap size in megabytes allocated to Java Collection Hub.

collectionHubOverrideJavaCommandLine

None

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

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

debugEndTime

None

Specifies when the debug mode will be disabled.

Format required: YYYY/MM/DD HH:MM:SS

debugMode

0 = disabled

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

defaultReinitializationOptions

None

List of default options to be executed by the KM for PATROL on reinitialization.

 

resetThresholds
resetThresholdManagementMode
resetAlertActions
resetOtherAlertSettings
resetDebugMode
resetRemovedPausedObjectList
resetReport
resetSecuritySettings
resetJavaSettings

 

Insert a colon “;” between the variable and its value: “resetThresholds;1”; and if you enter multiple variables, they need to be separated by a carriage return.

 

Example: “resetThresholds;1” will display the remove thresholds option selected by default in the Reinitialize KM wizard.

disableJRECheck

0 = JRE validation tests enabled

When set to '1', disables the validation tests of the JRE used by the KM to run Java code. This can be used to force the KM to use a non-Sun or non-Oracle JRE.

disablePslExecuteBugWorkaround

0 = activated

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.

errorCountAutoResetTimeout

None

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

exportScheduling

None

Time when the activity and/or LUNs Mapping Table reports will be generated. Format required: HH:MM:SS.

forceClassicConfigMode

0 = disabled

When the KM is used with BMC ProactiveNet, all the KM configuration menus are disabled in the PATROL Consoles. To enable them, set the forceClassicConfigMode variable to 1.

javaPath

None

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).

javaPassword

None

Password associated to the javaUsername variable.

javaUsername

None

Username used to launch the Java Collection Hub.

Default: Not set.

pausedObjectList

n/a

List of the PATROL object path of the paused objects.

productVersion

Automatically set by the KM during its initialization

Indicates the version level of the configuration. This should always match with the KM version. The KM uses this variable to perform migration operations on the configuration.

psCommand

n/a

Command used on UNIX/Linux systems to retrieve the list of the currently running processes. \nNote: This command is used for debug purpose.

removedObjectList

n/a

List of instances that have been removed from the monitoring environment through the Remove KM Command.

retryDiscoveryAfterNTimes

5

Specifies the maximum number of retries when the discovery fails.

scheduledReports

n/a

List of reports that will be automatically generated. Possible values:

ACTIVITY to generate storage centers, controllers, disk folders, disks, ports and volumes activity reports
LUNS_MAPPING_TABLE to list mapped and unmapped LUNs

Values must be delimited by \n.

startupDelay

0 second

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.

ThresholdsManagementMode

Retrieved from the KM configuration

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).

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

Variable

Default Value

Description

collectOperationTimeout

6000 minutes

To customize the timeout of the collect process. When the timeout is reached, the CollectionStatus parameter of the related SEN_NAP_7_STORAGESYSTEM or SEN_NAP_C_CLUSTER application class is set to 2 (Failure) and triggers an alert.

discoveryOperationTimeout

6000 minutes

To customize the timeout of the discovery process. When the timeout is reached, the collectionStatus parameter of the SEN_ NAP_MAIN application class is set to 2 (Failure) and triggers an alert.

disableClassMonitoring

n/a

To disable application classes to speed up data collection.

warningDeactivating a parent application class (for example SEN_NAP_7_CONTROLLER) will lead to the deactivation of all its related/children objects (for example SEN_NAP_7_PROCESSOR). Before disabling the monitoring of any application class, make sure that its related objects also need to be disabled from your environment.

Refer to Disabling Component Monitoring for details.

informationValues must be delimited by commas (Example: disableClassMonitoring=Sis,Disk,ClusterDisk …).

disableLUNMonitoring

None

When set to 1, deactivates LUNs monitoring. When the LUNs monitoring is disabled, discovery and collect requests and operations are no longer performed.

disableVolumeMonitoring

None

When set to '1', deactivates volumes monitoring. When the volumes monitoring is disabled, discovery and collect requests and operations are no longer performed.

excludeVolumes

None

Filter to exclude all volumes whose names match the specified regular expression.

hostname

None

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

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

includeVolumes

None

Filter to keep only volumes whose names match the specified regular expression.

mode

None

Cluster-Mode or 7-Mode.

partnerHostname

None

Partner IP.

password

None

Password used to perform queries.

port

None

HTTP/HTTPS port on the NetApp filer.
Default HTTP: 80, HTTPS: 443

userName

None

Username used to perform queries.