Skip to main content
Delphix

KBA1331 Delphix Reporting (formerly Mission Control) tunable parameters

 

Delphix Reporting provides some custom tunable parameters that can address customer concerns for customization and data retention, etc.

Issue

The following parameters may be altered if necessary to accommodate customer requirements.  This list is not exhaustive, but addresses the most likely parameters to alter.  Parameters are referenced from TunableService.java.

To apply these modifications, the appropriate entry should be added to /opt/delphix/collector/collector.properties (this file does NOT exist by default).

Available tunable parameters

httpclient.cnxManager.maxConnections = default 200
httpclient.cnxManager.maxConnectionsPerRoute = default 2
notification.request.timeout.minutes = default 5
request.timeout.minutes = default 30 

This value should be larger than the request timeout.  The default accommodates capacity calls, which may take a long time to complete.

liveEngine.executor.threadpool.size = default 10
poll.period.capacitymetrics = default 10 (minutes)
historical.interval.days = default 30 (days)

This is the maximum number of days to retrieve historical data for; as this can affect total database storage, use caution.

historical.resolution.hours = default 1 (hour)

Many values in Mission Control are gathered and overwritten on each polling interval, so some tables do not grow.  Some caution should be exercised if these values are changed, and disk space monitored.

job.events.numToKeep = default 10
exit.on.uncaught.exception = default true
sync.clearCache = default false

This parameter forces a clear of cached data when doing a full sync.  Full sync will occur when a configured engine is disconnected for some amount of time (credential change, loss of connectivity, Engine maintenance, etc)

Enable and confirm tunable parameter

Once the parameter is added to the file, the Delphix Collector service should be restarted. Example entry:

notification.request.timeout.minutes = 10
[root@mission-control delphix]# service delphix-collector restart
Shutting down delphix-collector
Starting delphix-collector

To confirm the tunable has been successfully altered, search for the corresponding com.delphix.cm.TunableService entry in /var/log/delphix/collector.log after restart.  A successful configuration change will appear as a "Config override" DEBUG message.  Example:

2016-09-28 13:07:20,757 [main] DEBUG com.delphix.cm.TunableService - Config override: notification.request.timeout.minutes = 10

If the entry is incorrectly formatted or otherwise improper (underscores used instead of ".", for example), the corresponding ERROR message will appear, and the property will be disregarded:

2016-09-28 13:05:32,318 [main] ERROR com.delphix.cm.TunableService - Tunable override file sets an invalid property: NOTIFICATION_REQUEST_TIMEOUT_MINUTES