API ReferenceDocumentation
Documentation

Data Sync Utility v2.0.x Release Notes

Release notes for Tetra Data Sync Utility versions 2.0.x

The following are the Data Sync Utility release notes for versions 2.0.x.

📘

NOTE

Starting with v2.0.0, the Tetra Data Sync Utility focuses exclusively on file synchronization via saved searches. Thread and block capture functionality is now available in the standalone Tetra Data Capture App, which is versioned and released independently. See the Data Capture App Beta Release Notes for changes specific to that product.

v2.0.0

Release date: June 15, 2026

What's New

TetraScience has released the first general availability (GA) version of the Data Sync Utility, version 2.0.0. This release graduates the Data Sync Utility from Limited Availability to GA by delivering a collection of usability improvements, security hardening, compliance updates, and bug fixes identified during the Limited Availability period.

Key Updates

  • New download-only sync modes, including a centrally administered global download-only mode.
  • New administrator overrides for session persistence ("Remember Me").
  • Additional operating system metadata captured on uploaded files.
  • Custom CA certificate support for secure connections to on-premises TDP deployments.
  • Security hardening validated through a penetration test ahead of GA.

New Functionality

New functionality includes features not previously available in the Tetra Data Sync Utility.

  • Download-only sync mode — You can now sync a saved search in download-only mode, which retrieves data from TDP without uploading local files. This supports use cases such as deprecating centralized network drives in favor of cloud storage. To enable download-only mode, select the Download Only toggle on the saved search card. For more information, see Download-Only Sync Mode.
  • Global download-only mode (admin override) — Administrators can now centrally enforce a global download-only mode that prevents users from uploading any data to TDP, regardless of per–saved search settings. To enable, set "globalDownloadOnly": true in the organization's default-settings.json file. For more information, see Configure Org-Level Settings.
  • Remember Me admin override — Administrators can now centrally prevent users from persisting authenticated sessions across application restarts. To enable, set "disableRememberMe": true in the organization's default-settings.json file. For more information, see Configure Org-Level Settings.
  • Operating system metadata on uploads — Uploaded files now include additional operating system metadata: osCreatedTime, osLastModifiedTime, osSizeOnDisk, osFilePath, osType, osVersion, and osCreatedUser (included when the operating system user can be resolved). The Data Sync Utility automatically registers these fields in TDP attribute management on login, and they're visible on the file's details page in TDP. For more information, see Operating System Metadata on Uploads.
  • Custom CA certificate support — The Data Sync Utility now supports a configurable custom CA certificate path for TLS verification in the Node.js HTTP layer. This enables secure connections to on-premises TDP deployments without disabling certificate validation. Administrators can configure the certificate path by setting "caCertPath" in the organization's default-settings.json file. The renderer process uses Chromium's certificate handling, which defers to the operating system certificate store (for example, macOS Keychain or the Windows Certificate Store), so the CA certificate must also be installed at the OS level for full coverage. For more information, see Configure Org-Level Settings.

Enhancements

Enhancements are modifications to existing functionality that improve performance or usability, but don't alter the function or intended use of the system.

  • Preservation of PROCESSED file category — Data Sync Utility now preserves the PROCESSED category when re-uploading modified files that were originally synced from TDP. This capability requires TDP v4.5.0 or higher. On older TDP versions, modified PROCESSED files are skipped and flagged with an upload issue instead of being uploaded as RAW.
  • Size on Disk label and tooltip — The saved searches UI now includes a clear label and tooltip for the size on disk metric to clarify that it reflects the local disk size of synced content.
  • SHA-1 checksum support — The Data Sync Utility now supports SHA-1 checksums in addition to its existing checksum verification, improving compatibility with files that were originally uploaded to TDP with SHA-1 hashes.
  • Reset and uninstall data cleanup — Resetting or uninstalling the Data Sync Utility now fully removes local user data, including the sync database and cached settings, preventing stale state from affecting a fresh installation.

Bug Fixes

The following bugs are now fixed:

  • The Data Sync Utility could fail to sync when the local SQLite database became read-only after a reset or reload.
  • Saved searches created in the Data Sync Utility did not work correctly in TDP because the description field was not passed forward.
  • Users with the data user role experienced issues when syncing folders containing many small files.
  • Some files were not downloaded when a folder was selected for sync, resulting in fewer files than expected.
  • Image file previews failed on Mac Intel devices.
  • Sync incorrectly pulled files from additional folders when folder names were numeric.
  • The IDS Type filter was parsed incorrectly in the Data Sync Utility, producing different results than TDP.
  • Date-based filters were parsed incorrectly in the Data Sync Utility, producing different results than TDP.
  • The Data Sync Utility failed to open on new Mac Intel builds, displaying an error message.
  • File preview was unavailable and displayed a "Failed to load" error.
  • Saved searches with multiple File Type filter values could not be loaded or synced due to a 400 error in the request payload.
  • Users with the analyst permission could not upload files to TDP through a saved search.
  • File uploads hung after a user logged out and logged back in.
  • Saved searches created in TDP with a Folder filter showed zero files in the Data Sync Utility.
  • A Source Name filter on a saved search was not applied in the Data Sync Utility, so synced results weren't filtered.

Deprecated Features

There are no new deprecated features in this release. For more information about TDP deprecations, see Tetra Product Deprecation Notices.

Known and Possible Issues

  • On the Saved Searches page, a warning triangle icon may appear on saved searches that haven't been synced yet. This icon is intended to appear only when a previously synced saved search is missing its local files (for example, if the files were deleted from the local disk). There is no functional impact, and syncing works as expected. Status: New in v2.0.0. A fix is planned for an upcoming patch release.
  • Modifying a previewed file outside of the Data Sync Utility (by manually unlocking the read-only file) and then attempting to preview the same file again may result in an error. Status: Known since v1.9.0.

Security

TetraScience continually monitors and tests its codebase to identify potential security issues. Various security updates are applied to the following areas on an ongoing basis:

  • Operating systems
  • Third-party libraries

As part of the GA release, TetraScience conducted a penetration test of the Data Sync Utility ahead of customer deployments to validate security hardening and identify potential vulnerabilities before broad availability.

For more information, see Product Security.

Quality Management

This GA release completed product, compliance, and quality engineering sign-off prior to release. Software is developed and tested following the ISO 9001-certified TetraScience Quality Management System.

Installation

To install and run the Tetra Data Sync Utility, see the Data Sync Utility Setup Guide (v2.0.x). For usage instructions after setup, see the Data Sync Utility User Guide (v2.0.x).

Upgrade Considerations

Upgrading from v1.10.0 or later: Install v2.0.0 directly over an existing v1.10.0 installation. Saved searches and settings are preserved during the upgrade.

Upgrading from v1.9.0 or earlier: You must first clear your application state and complete a clean installation before installing v2.0.0. For upgrade instructions, see the Data Sync Utility EAP Migration Guide in the TetraConnect Hub. For access, see Access the TetraConnect Hub.

On-premises TDP installations: Administrators must complete two additional steps to enable full TLS verification: configure the custom CA certificate path in the Data Sync Utility managed settings (applies to the Node.js HTTP layer and background workers), and install the CA certificate in the operating system certificate store (required by the renderer process, which uses Chromium's certificate handling via macOS Keychain or the Windows Certificate Store). Both steps must be completed before upgrading end-user installations. For configuration details, see Configure Org-Level Settings.

Other Release Notes

To view other Data Sync Utility release notes, see Data Sync Utility Release Notes.