Storage Configuration

TDS has three main content types: template data, inspection report data (including C-scans) and raw-sensor data (A-scans).

The first two are stored within a single database (given by common-file), while the raw sensor data is stored separately (given by measurement-storage). The latter is the data that will occupy the most storage over time on your TDS instance.

For effective memory management, TDS regularly extracts the oldest measurement data entries and puts them into archives (given as backup-dir).

Before

v4.0.0

, TDS would store both C-scans and A-scans in the same database. This would drastically increase startup-times on TDS instances with larger databases.

If you're running a TDS instance that has been active since before

v4.0.0

, you may talk to your IT department to extract the A-scan data from your common-file database. This can be achieved by opening a command-line, navigating to your TDS installation directory (likely C:\Program Files\Tessonics\TDS2) and executing:

tds-server.exe tools migrate-ascans

The terminal will guide you through the process.

The db block contains all settings related to the TDS databases.

Name	Value type	Default	Behavior
common-file	filesystem path (file)	%TDS_DATA_DIR%\data\database.sqlite3	Defines the location for the main database containing all template and inspection data. This is the heart of TDS.
revisions-dir	filesystem path (directory)	%TDS_DATA_DIR%\data\revisions	The directory pointing to the location where TDS will store the zipped revision files.
measurement-storage	object	...	Additional settings regarding the raw-sensor data storage.

The measurement-storage object must contain the following keys:

Name	Value type	Default	Behavior
db-file	filesystem path (file)	%TDS_DATA_DIR%\data\measurements.sqlite3	filepath pointing to the location where TDS will store all raw sensor data
backup-dir	filesystem path (directory)	%TDS_DATA_DIR%\data\ms-backup	directory where TDS will store extract excess measurement data to. See below for more information
keep-count	integer	1048576	amount of measurements to keep in the database when archiving
keep-bytes	integer	1073741824	amount of bytes to keep in the database when archiving
backup-count	integer	1048576	amount of measurements to archive when database exceeds limits
backup-bytes	integer	1073741824	amount of bytes to archive when database exceeds limits

Whenever the database in db-file exceeds the size of keep-bytes + backup-bytes or the number measurements exceed keep-count + backup-count, TDS will extract as many measurements into an archive bundle until only keep-bytes or keep-count is left in the database. This keeps the database size manageable while still having the archived data available.

danger

The backup-dir directory is an archive, not a backup. Deleting this data will cause a loss in data.