Data Sync Utility v1.x Release Notes

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

🚧

IMPORTANT

The Data Sync Utility is currently available as part of a beta release and is activated for customers through coordination with TetraScience. For more information, or to activate the Data Sync Utility in your environment, contact your customer success manager (CSM) or account executive.

v1.9.0

Release date: 25 June 2025

What's New

TetraScience has released its next version of the Data Sync Utility, version 1.9.0. This release introduces new features for file management, conflict resolution, and enterprise configuration capabilities.

Installation

To install and use the Data Sync Utility, see the Data Sync Utility Setup Guide and Data Sync Utility User Guide in TetraConnect Hub. For access, see Access the TetraConnect Hub.

Prerequisites

  • Tetra Data Platform (TDP) v4.2.3 or higher
  • Administrator privileges (required for MacOS installation)
  • Supported operating systems:
    • Windows 7 or higher
    • MacOS 10.15 or higher
  • Minimum hardware requirements:
    • 1.6 GHz processor
    • 1 GB RAM
    • 1 GB storage, plus space for synchronized data

New Functionality

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

File Previews

The new Previews page allows customers to view files up to 10 MB in the Data Sync Utility locally before committing to a full sync with the TDP. provides access to comprehensive metadata, tags, and labels for any file, helping users make informed decisions about which files to sync. Customers can also use the page to create new saved searches that are pre-filtered to a folder containing a specific file by using a new Sync the folder of file action.

The following file formats are currently supported:

  • Images: jpg, jpeg, png, gif, bmp, webp
  • Documents: pdf, doc, docx
  • Spreadsheets: csv, xls, xlsx
  • Text files: json, txt, md, xml, html
  • Presentations: ppt, pptx

To prevent accidental modifications when files are opened locally for preview, they are automatically set to read-only and produce system notifications.

Merge Conflict Management

The Data Sync Utility now automatically detects when local file changes conflict with updated file versions in the TDP, preventing potential data loss scenarios. When conflicts are detected, the system automatically pauses upload and download actions for the affected files to make sure that no data is overwritten without user consent.

Users can select one of three conflict resolution options:

  • Overwrite their local changes and download the new TDP file version
  • Ignore the TDP file version and upload their local changes as a new version to TDP
  • Create a "branched" version by renaming their local file and then downloading the latest TDP file version.

The system provides OS-level notifications about conflicts with quick action options, ensuring users are immediately aware of conflicts, even when the application is minimized.

Enterprise Configuration Management

IT administrators can now pre-configure Data Sync Utility settings across their organizations through a new global default settings system. The application supports centralized configuration files on both macOS and Windows, allowing for consistent deployment and management across enterprise environments.

For organizations wanting to pre-configure the Data Sync Utility, administrators can now create the following default configuration files and add them to user's machines before installing the Data Sync Utility:

MacOS Configuration

Create file: /Library/Application Support/tetrascience/default-settings.json

Windows Configuration

Create file: C:\ProgramData\Tetrascience\default-settings.json

Example Configuration
{
  "helpLink": "https://your-organization-support-url.com",
  "endpoint": "https://api.tetrascience.com",
  "subdomain": "your-organization-subdomain",
  "orgSlug": "your-organization-slug",
  "downloadFolder": "/absolute/path/to/download/folder"
}

Enhancements

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

  • Authentication settings are now stored separately from application settings for improved security and easier management.
  • In General Settings, organizations can now customize support links to point to their own system for users to report issues by using a new Support Link field.
  • There's now enhanced reliability when switching between organizations.
  • Synced searches maintain their status when switching between organizations or logging back in.
  • Resources are automatically cleaned up when authentication changes.
  • Improved validation for saved search folder names with support for international characters.
  • Improved process for removing synced searches with better cleanup.
  • Added checks to ensure files exist before attempting sync operations.

Bug Fixes

The following bugs are now fixed:

  • Organization selection now consistently persists for TetraScience administrators.
  • Resolved sync state loss when switching between organizations or restarting the application.
  • Fixed URL switching problems that prevented proper endpoint changes.
  • Improved sync folder validation to prevent errors with empty or invalid directories.

Known Issues

The following are known issues in this release:

  • There may be noticeable delays when previewing larger files locally (including files as small as 1 MB JSON files).
  • 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.
  • Editing files that are common to more than one synced search can result in multiple staged files uploading to TDP as well as being flagged as a conflict.

Upgrade Considerations

Users upgrading from v1.8.5 will automatically benefit from the new features. Enterprise administrators should review the new configuration options to determine if centralized settings would benefit their deployment.

v1.8.5

Release date: 30 April 2025

What's New

TetraScience has released its first prerelease version of the Data Sync Utility, version 1.8.5. The Data Sync Utility enables seamless transfer of primary scientific data from laboratory instruments and control software to desktop analytical applications that are commonly used by biopharmaceutical companies.

Installation

To install and use the Data Sync Utility, see the Data Sync Utility Setup Guide and Data Sync Utility User Guide in TetraConnect Hub. For access, see Access the TetraConnect Hub.

Prerequisites

The Data Sync Utility requires the following:

  • Tetra Data Platform (TDP) v4.2.3 or higher (it can work with TDP v4.1.3 and higher, but requires a manual workaround for SSO login in TDP v4.2.2 and earlier)
  • Administrator privileges (required for MacOS installation)
  • Supported operating systems:
    • Windows 7 or higher
    • MacOS 10.15 or higher
  • Minimum hardware requirements:
    • 1.6 GHz or faster processor
    • 1 GB of RAM
    • 1 GB of storage and additional space for synchronized data

New Functionality

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

  • Automatic upload of analysis results with comprehensive scientific metadata
  • Path shortening for compatibility with analysis software that can't handle long file paths
  • Parallel download processing with scalable workers (2-6 workers based on CPU cores)

Enhancements

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

  • Automatic retry mechanism for failed downloads
  • Checksum verification for data integrity
  • Configurable synchronization schedules (5 minutes minimum)
  • Local storage management with disk space warnings

Bug Fixes

There are no bug fixes in this release.

Limitations

The following are known limitations of the Data Sync Utility:

  • A maximum of 10,000 files can be downloaded simultaneously.
  • For saved searches containing more than 10,000 files, only the first 10,000 files are downloaded (sorted by creation date with the newest file listed first).
  • Relative time filtering is not supported in the TDP web client.

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

The following are known issues in this release:

  • Windows OneDrive Integration:
    • File size counts may be unreliable when syncing to OneDrive.
    • Workaround: Use a local folder outside of OneDrive or ensure files are fully downloaded.
  • Relative Time Filtering:
    • Relative time filtering is not supported in the TDP web client.
    • Filters applied in Data Sync Utility won't be reflected in TDP search.
  • Organization Switching:
    • Saved searches are cleared when switching organizations.
    • Workaround: Set a default organization in your TDP account settings.
  • Role Changes:
    • Users must log out and back in for role changes to take effect.

Upgrade Considerations

The Data Sync Utility is currently available as a beta release and is activated for customers through coordination with TetraScience. For more information, or to activate the Data Sync Utility in your environment, contact your customer success manager (CSM) or account executive.