dcma-telemetry.properties
The dcma-telemetry.properties file configures settings for the automatic reporting of consumption data to Transact. The dcma-telemetry.properties file is located at <Transact_Folder>\Application\WEB-INF\classes\META-INF\dcma-telemetry. For more information on your consumption data, see License Consumption Report.
Do not make any changes to this property file unless directed by Support or to enable or disable automatic reporting.
Property |
Description |
---|---|
dcma.telemetry.auto.upload |
This property enables or disables the automatic reporting of consumption data to Transact. If this is set to OFF, you will need to manually submit your consumption data each month. For steps, see Manual reporting. |
dcma.telemetry.consumption.upload.url |
This property specifies the URL where the license consumption snapshots are automatically uploaded. Do not change this URL unless requested by Transact. |
license.consumption.cronjob.expression |
This cron job controls when the license consumption data is captured, also referred to as a snapshot. In a multi-server environment, this cron job should be staggered for each server. By default, this is set to 9:00 PM daily. |
license.consumption.upload.cronjob.expression |
This cron job controls when the license consumption snapshot is automatically sent to Transact. In a multi-server environment, this cron job should be staggered for each server. By default, this is set to 5:00 AM daily. |
number.of.past.months.to.show.for.download |
This property controls how many previous months of consumption data will be visible from the Monthly consumption report drop-down list in the License Consumption Report. By default, this is set to 11 months. |
dcma.telemetry.reporting.email.to.address |
This property specifies the email address your consumption report will be sent to when the Email button is clicked on the License Consumption Report. |
license.consumption.snapshot.throttle* |
This property specifies the minimum interval in minutes between two cycles to capture consumption snapshots. By default, this is set to 360 minutes (6 hours). |
license.consumption.upload.throttle* |
This property specifies the minimum interval in minutes between two attempts to automatically upload consumption snapshots. By default, this is set to 5 minutes. |
license.consumption.upload.api.connect.timeout |
This property specifies how long Transact will wait (in minutes) for a server connection to be established when uploading the consumption report before timing out. By default, this is set to 1 minute. |
license.consumption.upload.api.read.timeout |
This property specifies how long Transact will wait (in minutes) for the servers to complete the request and provide a response before timing out. By default, this is set to 3 minutes. |
* Throttling is a countermeasure in the event the CRON job schedules for snapshot creation and upload are accidentally configured to run too frequently.