Setting Advanced Configuration Variables

 Home  Previous  Next

Advanced configuration variables are used to manually set variables that are normally not available through the standard interface.

warningThese variables should only be set when instructed so by Sentry Software Support.

To configure a variable

1.Log on to Central Monitoring Administration.
2.Edit the Monitoring Policy that applies to the PATROL Agent for which you need to enable the debug mode:
•In the Navigation pane, click the Policies drawer.
•Expand the Monitoring folder and select a policy view (e.g. All).
•Select your policy and click Edit.
•Click the Monitor Configuration link.
•Select the IBM XiV Storage Monitor Type and click Edit.
3.Click the Advanced button.

IBM_XIV_Configuration_Variables

Configuring variables

4.In the Configuration Variables section, enter the name of the variable you need to configure and enter the value to be set. Please note that the Name field is case sensitive.

The configuration variables available for TrueSight Operations Management - IBM XiV Storage Monitoring and their possible values are:

Variables

Default Value

Description

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.

collectionHubAdditionalArgs

None

To add arguments to the command line when launching the Java Collection Hub (For example, enter Xdebug -Xrunjdwp:transport=dt_socket,address=4711,server=y,suspend=n to launch the solution in debug on a specific port).

collectionHubHeapSizeMax

None

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 monitoring solution to launch the Java Collection Hub. This variable should only be set if instructed by Sentry Support.

defaultReinitializationOptions

None

List of default options to be executed by TrueSight Operations Management - IBM XiV Storage Monitoring 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.

disableJRECheck

0 = JRE validation tests enabled

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

disableMissingDeviceDetection

None

When set to "1", disables the missing device detection mechanism of IBM XiV Storage Monitoring. By default, IBM XiV Storage Monitoring raises an alarm for devices that were discovered and that are no longer discovered.

disablePslExecuteBugWorkaround

0 = activated

When set to ‘1’, deactivates the workaround in the monitoring solution for a bug in the PslExecute() PSL function.

If the monitoring solution 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.

forceClassicConfigMode

0 = disabled

When the monitoring solution is used with BMC ProactiveNet, all the monitoring solution 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.

javaUsername

n/a

Username used to launch the Java Collection Hub.

pausedObjectList

n/a

List of the PATROL object path of the paused objects. (i.e. for which no collection will be performed).

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.

startupDelay

0 seconds

To specify the number of seconds that TrueSight Operations Management - IBM XiV Storage Monitoring will wait before starting its discovery.
5.Click Add to List.
6.Click Close to save your settings.

You can easily modify or remove a variable by selecting it in the list and clicking either the Modify Selection or the Remove from List buttons.