Configuration Variables

Home  Previous  Next

This section lists the configuration variables used by IBM DS6000, DS8000 Series 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)

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

Variable

Default Value

Description

AlertActions

n/a

List of alert actions to be executed by the KM upon a hardware failure.

Default: A PATROL event and an annotation on the parameter

collectionHubHeapSizeMax

n/a

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

Default: Not set

collectionHubHeapSizeMin

n/a

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

Default: Not set

collectionHubOverrideJavaCommandLine

n/a

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.

debugEndTime

None

Specifies when the debug mode will be disabled.

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

debugMode

0

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

Default: Not set

defaultReinitializationOptions

None

List of default options to be executed by IBM DS6000, DS8000 Series KM for PATROL on reinitialization. The default values are: 0=unchecked; 1=checked

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.

disableJavaInformationMessage

0 = activated

When set to ‘1’, disables the pop-up information message displayed when the java settings are modified.

Default: Not set

disableJRECheck

0 = activated

When set to '1', disabled 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

0 = activated

When set to ‘1’, deactivates 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.

disableVolumeMonitoring

0 = Volume Monitoring enabled

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

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.

javaPassword

None

Password associated to the javaUsername variable.

javaPath

None

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

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

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. (i.e. for which no collection will be performed).

productVersion

Automatically set by the KM during its initialization

Identifies the current version of the KM in the configuration. Do not alter this value.

psCommand

n/a

Command used on UNIX/Linux systems to retrieve the list of the currently running processes.

Note: 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.

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

This variable allows the administrator to specify a number of seconds that the KM will wait before starting its discovery. This variable may be useful on fast-booting computers where the PATROL Agent starts before the IBM DS Storage Manager (if any) and consequently triggers false.

Default: Not set (zero)

ThresholdsManagementMode

swGetThresholdsManagementType()

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)

‘as’ (through PATROL for Event Management)

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

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

(1) This setting is only used if the SMI-S Provider specific configuration is empty.

Configuration variables specific to the DS Storage Manager are listed in the table below. These configuration variables are stored under /SENTRY/SEN_I68/<DS Storage Manager ID> 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_I68_SMISPROVIDER 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_I68_MAIN application class is set to 2 (Failure) and triggers an alert.

excludeVolumes

None

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

hostname

None

Hostname of the SMI-S provider.

includeVolumes

None

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

password

None

Password used to perform queries.

port

5989

Port used to perform queries.

protocol

https

Protocol used to perform queries.

userName

None

Username used to perform queries.