Managing Advanced Configuration Variables

 Home  Previous  Next

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

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

List of available configuration variables

Variables

Default Value

Description

collectionHubAdditionalArgs

n/a

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

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

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, disable the validation tests of the JRE used by the monitoring solution 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’, deactivates the workaround in the monitoring solution for a bug in the PslExecute() PSL function.

If the product 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 product is used with BMC TrueSight Operations Management, 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. Path to the folder containing the Java executable used by the Collection Hub.

javaUsername

None

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.

retryDiscoveryAfterNTimes

5

To specify the maximum number of retries when the discovery fails.

startupDelay

0 second

To specify the number of seconds that TrueSight Operations Management - EMC Storage Monitoring will wait before starting its discovery. This variable may be useful on fast booting computers where the EMC SMI-S Provider starts after the monitoring solution and triggers an alert.

To set a configuration variable

1.Create a new policy or edit an existing policy.
2.Click Add Monitoring Configuration and scroll down to the Advanced Configuration Variables section and click Add to open the Configuration Variables panel:

105_EMC_Configuring_Variables_Add

Adding a Configuration Variable

3.In the Configuration Variables panel, enter the name of the configuration variable and enter the value to be set. Refer to the table above to learn about all the configuration variables you can use to perform operations you cannot complete with the console standard user interface.

105_EMC_Configuring_Variables_Conf

Configuring a Variable

4.Click OK to save your settings.

warningThe Name field is case sensitive.

5.The configuration variable is then listed in the Additional Configuration Variable section:

105_EMC_Configuring_Variables_Result

List of Set Configuration Variables

To edit a configuration variable

1.Click the TS_Action_Menu button next to the variable you wish to modify and click Edit.

105_EMC_Configuring_Variables_Edit

Editing a Configuration Variable

2.Change the variable value and click OK to save your settings.

To delete a configuration variable

1.Click the TS_Action_Menu button next to the variable you wish to remove and click Delete.

105_EMC_Configuring_Variables_Delete

Deleting a Configuration Variable

2.Click OK to validate. The configuration variable is removed from the list.