Sentry Software
Storage Analyzer 1.13.00

Advanced Configuration Variables

Global Configuration Variables

This section lists the configuration variables used by Storage Analyzer globally, i.e that apply to all of the monitored hosts. These configuration variables are stored under /SENTRY/STORAGE in the PATROL Agent’s configuration and can be managed through the Configuration Variables page of BMC Helix Operations Management.

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

Variable Description
/SENTRY/STORAGE/automaticReinitialization Set to 1 to perform a KM reinitialization. (Optional) Use /SENTRY/STORAGE/defaultReinitializationOptions to indicate what should be reinitialized.
/SENTRY/STORAGE/collectionErrorCountAutoAcknowledgeTime Number of seconds after which the CollectionErrorCount parameter will be automatically set to 0, canceling any alerts. Default: 8100 seconds (2h15).
/SENTRY/STORAGE/collectionHubHeapSizeMax Maximum heap size in megabytes allocated to the Java Collection Hub. Default: Not set (assumed 2048 MB).
/SENTRY/STORAGE/collectionHubHeapSizeMin Minimum heap size in megabytes allocated to Java Collection Hub. Default: Not set (assumed 128 MB).
/SENTRY/STORAGE/collectionHubOverrideJavaCommandLine 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.
/SENTRY/STORAGE/debugCompress Specifies whether log files are compressed at the end of the debug window. Default: 1 (compressed).
/SENTRY/STORAGE/debugEndTime Specifies when the debug mode will be disabled. Format required: YYYY/MM/DD HH:MM:SS.
/SENTRY/STORAGE/debugHostList List of endpoint IDs for which the debug mode is enabled. This list is automatically deleted when the debug mode is set to Off (0).
/SENTRY/STORAGE/debugMode When set to 1, enables the debug mode of Storage Analyzer KM for PATROL. Default: Not set.
/SENTRY/STORAGE/defaultCollectInterval Interval between two collects of endpoint parameters if no custom collect interval has been set at the endpoint level.
/SENTRY/STORAGE/defaultDiscoveryInterval Interval between two endpoint environment discoveries if no custom discovery interval has been set at the endpoint level.
/SENTRY/STORAGE/defaultReinitializationOptions List of default options to be executed by the KM upon reinitialization:

  • resetPollingIntervals

  • resetTimeouts resetAlertMessages

  • resetOtherAlertSettings

  • resetDebugMode

  • resetJavaSettings

Default values are: 0=unchecked; 1=checked.

Insert a colon “;” between the variable and its value (ex: resetTimeouts;1). Multiple variables need to be separated by a carriage return.
/SENTRY/STORAGE/disableJRECheck To disable 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.
/SENTRY/STORAGE/disableMissingDeviceDetection When set to 1, disables the missing device detection mechanism of the KM. By default, the KM raises an alarm for devices that were discovered and that are no longer discovered.
/SENTRY/STORAGE/endpointSiliciumLockTimeout Maximum time in seconds an endpoint discovery waits for the collect to end. Default: 3600 seconds.
/SENTRY/STORAGE/endpointSiliciumRetryDelay Number of seconds after which the engine will perform a second query if the first query returned an empty result. This value is used by default if no endpoint specific value is set. Default: 60
/SENTRY/STORAGE/forceClassicConfigMode Makes the KM ignore policies sent by BMC Helix and retrieve the configuration through the /SENTRY/STORAGE path. To enable this mode, set the forceClassicConfigMode variable to 1.
/SENTRY/STORAGE/forceDiscovery If set to 1, the KM will trigger a global discovery. It may take up to a minute for the discovery to start.
/SENTRY/STORAGE/globalDiscoveryTimeout Maximum time in seconds the main discovery process waits for the previous discovery to complete. When this timeout is reached, it means the previous discovery did not complete in a timely fashion. A collection error is triggered and the discovery is canceled. Default: Not set (assumed 300 seconds).
/SENTRY/STORAGE/javaPassword Password associated to the javaUsername variable.
/SENTRY/STORAGE/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).
/SENTRY/STORAGE/javaUsername Username used to launch the Java Collection Hub. Default: Not set.
/SENTRY/STORAGE/messageAnnotate Alert message annotations activation and content: <activation>;<content>. <activation> must be set to 1 for the annotation to be added to the graph when thresholds are breached. <content> is the text of the annotation which by default is “%{OBJECT_TYPE} problem on %{DEVICE_METAFQDN} with %{OBJECT_LABEL}. %{PARAMETER_TITLE} = %{PARAMETER_VALUE} %{PARAMETER_UNITS}%{NEWLINE}%{NEWLINE}%{PROBLEM}%{NEWLINE}%{NEWLINE}%{RECOMMENDED_ACTIONS}”.
/SENTRY/STORAGE/messageEventCollectionError Event triggered when a collection error is reported: The event type can be “none”, “standard” or “specific”. The default content is “Collection problem on %{ENDPOINT_ID} (%{ENDPOINT_HOSTNAME}): %{ENDPOINT_COLLECTIONSTATUSINFORMATION}%{NEWLINE}%{NEWLINE}%{PROBLEM}%{NEWLINE}%{NEWLINE}%{RECOMMENDED_ACTIONS}”.
/SENTRY/STORAGE/messageEventStorageError Event triggered when parameter thresholds are breached: <event type>;<content>. The event type can be “none”, “standard” or “specific”. The default content is: %{OBJECT_TYPE} problem on %{DEVICE_METAFQDN} with %{OBJECT_LABEL}. %{PARAMETER_TITLE} = %{PARAMETER_VALUE} %{PARAMETER_UNITS}%{NEWLINE}%{NEWLINE}%{PROBLEM}%{NEWLINE}%{NEWLINE}%{RECOMMENDED_ACTIONS}.
/SENTRY/STORAGE/messageLog Filepath and content written to the file when parameter thresholds are breached: <path>;<content>. By default, the content is: %{TIME:%Y-%m-%d %H:%M:%S}%{SEMICOLON}%{ENDPOINT_ID}%{SEMICOLON}%{ENDPOINT_HOSTNAME}%{SEMICOLON}%{ENDPOINT_FQDN}%{SEMICOLON}%{ALARM_TYPE}%{SEMICOLON}%{OBJECT_TYPE}%{SEMICOLON}%{PARAMETER_NAME}%{SEMICOLON}%{PARAMETER_VALUE}.
/SENTRY/STORAGE/noDeviceCreationForStorageSystems If set to 1, prevents the creation of devices for Storage Systems. Device information is only set on the endpoint.
/SENTRY/STORAGE/noMissingDeviceDetectionClasses List of classes that will not trigger missing device alerts. Default: SKM_MAIN, SKM_ENDPOINT, SKM_SYSTEM, SKM_STORAGEPOOL, SKM_VOLUME, SKM_FILER, SKM_FILESYSTEM and SKM_BUCKET. A configured value replaces this built-in list. With the built-in list, a deleted bucket is destroyed at the next discovery without any alert. SKM_SYSTEM and SKM_BUCKET have no Present parameter, so a custom list that omits either one raises no missing device alert for it, and the deleted storage system or bucket remains as an instance with all its parameters inactive until the list is corrected.
/SENTRY/STORAGE/rediscoverEndpoints Comma separated list of endpoint IDs for which a rediscover should be performed. It may take up to a minute for the endpoints rediscovery to start.
/SENTRY/STORAGE/removeMissingDevicesOnStartup When set to 1, deletes the list of previously discovered devices. This setting prevents false “missing device” alerts to be triggered on startup.

Note: Devices that went missing during the startup (reboot) operation will not be reported as missing. Default: 0.
/SENTRY/STORAGE/startupDelay Allows the administrator to specify the number of seconds that the KM will wait before starting the global discovery. Default: Not set (zero).

Endpoint-Specific Configuration Variables

The configuration variables listed below are used by Storage Analyzer KM for PATROL for each monitored endpoint. They are stored under /SENTRY/STORAGE/<endpoint-id> in the PATROL Agent’s configuration.

Variable Description
/SENTRY/STORAGE/<endpoint-id>/associatedFQDN Replaces the device MetaFQDN by the provided FQDN to attach the endpoint to a device in Helix.
/SENTRY/STORAGE/<endpoint-id>/clientTimeout Duration in minutes after which the endpoint should be considered as not responding and a query stopped.
/SENTRY/STORAGE/<endpoint-id>/collectInterval Data polling frequency, in minutes.
/SENTRY/STORAGE/<endpoint-id>/disableVolumeMonitoring Disables the monitoring of volumes for the endpoint (0 = enabled; 1 = disabled). Disabling volumes means no data is collected for the volumes attached to the endpoint. This saves resources and lowers the number of created instances. However, values dependent on volume information (Configured Capacity, Subscribed Capacity and Oversubscription Situation) may not be properly calculated.
/SENTRY/STORAGE/<endpoint-id>/hideVolumes Hides (1) or displays (0) volume instances. Default: Hidden (1). Hidden volumes are not visible in Helix but their metrics continue to be collected. This allows the calculation of values dependent on the volumes information while it lowers the number of created instances and saves resources.
/SENTRY/STORAGE/<endpoint-id>/disableBucketMonitoring Disables the discovery and data collection of storage buckets for the endpoint (1 = disabled, 0 or not set = enabled). Default: Enabled. Buckets are monitored on every endpoint whose Storage Intelligence Adapter reports them. Each bucket adds one request per collect, so the request count and the collect duration grow linearly with the number of buckets. The default collect interval of 2 minutes may need to be increased on endpoints with many buckets.
/SENTRY/STORAGE/<endpoint-id>/discoveryInterval Discovery frequency, in minutes, to discover new devices.
/SENTRY/STORAGE/<endpoint-id>/enableHardwareMonitoring Enables (1) or disables (0) the monitoring of hardware components through Hardware Sentry KM. Default: Disabled (0).
/SENTRY/STORAGE/<endpoint-id>/endpointSiliciumRetryDelay Number of seconds after which the engine will perform a second query if the first query returned an empty result. This value is specific to the endpoint and overrides the global variable. Default: 60
/SENTRY/STORAGE/<endpoint-id>/hostname Hostname or IP address to be used to communicate with the endpoint.
/SENTRY/STORAGE/<endpoint-id>/password Encrypted password used to connect to the endpoint.
/SENTRY/STORAGE/<endpoint-id>/port Port used by the KM to perform the queries to the endpoint.
/SENTRY/STORAGE/<endpoint-id>/protocol Protocol (HTTP or HTTPs) used to communicate with the endpoint. Default: HTTPS.
/SENTRY/STORAGE/<endpoint-id>/si Filename of the Storage Intelligence Adapter the KM should use to monitor the endpoint.
/SENTRY/STORAGE/<endpoint-id>/siliciumTimeout Duration in minutes after which the engine should be stopped when querying the endpoint.
/SENTRY/STORAGE/<endpoint-id>/token Encrypted token used to connect to the endpoint.
/SENTRY/STORAGE/<endpoint-id>/username The username used to connect to the endpoint.
km bmc helix policy configuration variables custom settings storage km patrol
Searching...
No results.