Tetra Chromeleon Agent Release Notes (v2.x and Below)

📘

NOTE

To upgrade the Tetra Chromeleon Agent, see Common Tetra Agent Upgrade and Installation Information and Tetra Chromeleon Agent Installation and Configuration (Version 2.x). As newer versions of Agents are released, their release notes will appear in the Tetra Agent and Tetra Data Release Notes topic.

The following are the Tetra Chromeleon Agent release notes for versions 2.x and earlier.

v2.0.3

Release date: 3 August 2023

What's New

TetraScience has released its next version of the Tetra Chromeleon Agent, version 2.0.3. This release focuses on enhancements, including adding the ability to configure scan and generation batch size settings.

Prerequisites

The following Tetra Data components are required for the Tetra Chromeleon Agent v2.0.3 release:

  • Protocol chromeleon-raw-to-ids v3.0.0.

New Functionality

New Functionality includes features not previously available in the Tetra Data Platform (TDP) or Tetra Chromeleon Agent. These features may or may not affect "intended use" for GxP validation purposes.

  • There is no new functionality in this release.

Enhancements

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

  • Sequence Scan Batch Size and Injection Generation Batch Size settings can now be configured in the Agent Management Console. Customers can use these settings along with the existing Processing Interval setting to optimize scan and generation performance. Customers can also use these settings to manage the number of audits in Chromeleon that are recorded when the Agent connects to it for scan and generation. The default setting for Sequence Scan Batch Size is 25. The default setting for Injection Generation Batch Size is 50.
  • On the Data Vault tab of the Agent Management Console, the data vault list now displays the Data Vault Server in the tree view within the Server Name column. Customers can use this view to activate or turn off a Data Vault Server. Activating a Data Vault Server allows customers to select one or more data vaults in that server. Turning off a server makes it so that no data vaults in that server can be selected in the Agent, and so that the data vault server will not be accessed during scan. The Agent will scan all of the selected data vaults in the tree and log errors only if any of the data vaults have access errors.

Bug Fixes

There are no customer reported bugs fixed in this release.

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

There are no known issues in this release.

Upgrade Considerations

To upgrade the Agent, see Tetra Chromeleon Agent Installation and Configuration (Version 2.x). To upgrade the protocol, see Edit a Pipeline.

v2.0.2

RELEASE DATE: 3 November 2022

Enhancements
The following are enhancements for this release.

  • AG-2537 - Added “Decode Injection URL” toggle to Agent management console. When this is Yes, the injection path in the platform will not contain the URL encoding characters. Default value is No. To know more about how this feature impacts the data on TDP, please read here.
  • AG-2558/AG-2577 - Added support for running/loading .NET libraries at runtime which have been built in a lower version than the .NET runtime Agent uses. If there is still a .NET System.IO.FileLoadException runtime exception, the injection will not be extracted and error will be surfaced.

Bug Fixes
The bug fixes for this release appear below.

  • AG-2491 - Typo “Detrail” fixed to “Detail” in Agent summary screen.
  • AG-2565 - Following report variables are now extracted in RAW JSON:
    • Number of Peaks in Peak Category
    • Group Evaluation in Peak Group category
    • Matrix Correction in Processing Method category
    • Blank Run Subtraction in Processing Method category
    • Use Amount Ratio for Var. ISTD Processing Method category
    • Amount Ratio Confirmation channel in Composite Scoring - Processing Method category

Minor Functionality Changes
There are no minor functionality changes in this release.

Known Issues
Certain Report Variables may return error. This may be because the Agent does not have enough context to generate the Report Variable value through the SDK. For a complete list of such Report Variables please click here. Tetra is actively working with the vendor to resolve the errors and remediate the issue in a future release.

v2.0.1

RELEASE DATE: 21 September 2022

Enhancements
The following are enhancements for this release.

  • AG-2357 - To improve the Tetra Chromeleon Agent’s efficiency, failed injections are retried 2 additional times, in its own batch, at the end of the current Data Vault generation and in the next generation of Data Vault. If the maximum retry limit of 3 is reached and the injection still has errors, it will not get considered for further generation jobs.
  • AG-2358 - The Ignore Recycle Bin option has been added to the Tetra Chromeleon Agent Management Console screen. You can now determine if you want to exclude the generation of the Sequence and Injections stored in Data Vault’s Deleted Item folder. (Internally, Chromeleon refers to it as Recycle Bin.)

Bug Fixes
The bug fixes for this release appear below.

  • AG-2386 - For GxP compliance, Infinity or NaN is output as null in Chromatogram Data Points. In other places, they will be output as Negative Infinity or Positive Infinity or NaN respectively.
  • AG-2319 - Agent will retry failed database operation in case database transaction-related errors occur, such as the database is locked. The Agent logs every retry attempt. Since the Agent retries up to 5 times, only the message "Failed the operation in 5 times" message means a real operation failure.

v2.0.0

RELEASE DATE: 7/14/2022 (Updated 8/4/2022)

Enhancements
The following features and functionality have been added to the software for this release.

  • AG-1260 - A busy indicator now appears while the Chromeleon user account is being verified.
  • AG-1286 - User-deleted files during scans no longer cause unrecoverable errors.
  • AG-1723 - The culture/regional handling for dates and numbers has been improved. Context for the cultural and regional values are in the RAW JSON file.
  • AG-1899 - The TDP can push data to Chromeleon to create Sequences. This command will work when connecting through GDC and L7 Proxy.
  • AG-1965 - Password and role fields on the UI are now wider.
  • AG-1968/AG-1934 - Logging has been improved; more details have been added. Also, logs can now be over 1 MB in size.
  • AG-1992 - We've updated the logic to render report variables in RAW JSON with full object context.
"CreationTime": {
	"IsError":false,
	"IsNumeric":false,
	"IsString":false,
	"IsTime":true,
	"IsBoolean":false,
	"NumericValue":null,
	"StringValue":null,
	"TimeValue":"2022-05-12T10:21:53.0000000-04:00",
	"BooleanValue":null,
	"Value":"5/12/2022 4:21:53 PM +02:00"
}
  • AG-1993 - Scan errors are now available on the Management Console's Summary Page.
  • AG-2006 - Datapoint and Peak data (if available) is now shown; issues resolved by AG-2038, which changed the way it processes errors to better manage memory usage. The agent recovers from any out of memory errors and continues to process the injection(s) in a separate batch.
  • AG-2045 - We've updated the logic to render custom fields in RAW JSON so that they follow the same serialization logic as report variables.
{
        "FieldDefinitionContext": "Injection",
        "Name": "Column SN.",
        "Description": "",
        "Key": "Column SN.",
        "Value": null,
        "Value_Data_Type": "string",
        "Number_Value": null,
        "String_Value": "001290,01827143",
        "Boolean_Value": null,
        "Time_Value": null
}
{
        "FieldDefinitionContext": "Injection",
        "Name": "Column SN.",
        "Description": "",
        "Data": {
          "IsBoolean": false,
          "IsError": false,
          "IsNumeric": false,
          "IsString": true
          "IsTime": false,
          "BooleanValue": null,
          "NumericValue": null,
          "StringValue": "",
          "TimeValue": null;
          "Value": ""
        }   
}
  • AG-2044 - The following report variables are now part of the RAW file that is uploaded to the TDP:
    • Chromatogram Category
    • Sequence Category
    • Injection Category
  • AG-2134 - Addressed additional memory issues. Note that the agent recovers from any out of memory errors and continues to process the injection(s) in a separate batch.

Bug Fixes
Here are the bug fixes made for this version of the agent software:

  • AG-1703/AG-1936 - Domain and local Chromeleon users are now set in the same way in the UI. The "Chromeleon LDAP User" yes/no setting has been removed from the UI.
  • AG-1972 - The file name now appears in the log when the SetValue Errors are thrown.

Bug Fixes from 1.3.0 were also included.

  • AG-1909/AG-1923 - If the Tetra Chromeleon Agent cannot access remote data vaults due to a network or user permission issue, this information now appears in the logs. If the Agent cannot access a data vault, scanning for the rest of the data vaults still continues.
  • AG-2000 - The Tetra Chromeleon Agent won’t upload empty injection object due to an access permission error; instead the Agent will mark the injection as a generation error.
  • AG-2007 - If the Tetra Chromeleon Agent scans a data vault and there is no access permission for a file, the Agent logs an error message.

Deprecated Features

  • There are no deprecated features for this release.

Minor Functionality Changes

  • AG-1703 - Users authenticated and authorized using LDAP is now handled differently. There is no longer "Chromeleon LDAP User" yes/no setting. Agent Group User is the service account that runs the Tetra Chromeleon Agent while Chromeleon user/password/role used in Service Settings is used to access Chromeleon (when User Mode is enabled in Chromeleon).

v1.3.0

RELEASE DATE: 6/6/2022 (Internal Release Only)

Enhancements
No new features and functionality have been added to the software for this release.

Bug Fixes
Here are the bug fixes made for this version of the agent software:

  • AG-1909/AG-1923 - If the Tetra Chromeleon Agent cannot access remote data vaults due to a network or user permission issue, this information now appears in the logs. If the Agent cannot access a data vault, scanning for the rest of the data vaults still continues.
  • AG-2000 - The Tetra Chromeleon Agent won’t upload empty injection object due to an access permission error; instead the Agent will mark the injection as a generation error.
  • AG-2007 - If the Tetra Chromeleon Agent scans a data vault and there is no access permission for a file, the Agent logs an error message.

Deprecated Features
There are no deprecated features for this version of the software.

Minor Functionality Changes
There are no minor functionality changes for this version of the software.

v1.2.0

RELEASE DATE: 27 December 2021

Enhancements (New Features and Functionality)

  • The Tetra Chromeleon Agent has been upgraded to receive a TDP command. Only one command can be accepted, which SequenceCreation. Note that the Tetra Chromeleon Agent can only receive this command if the Queue is manually enabled in both the TDP and the Tetra Chromeleon Agent.

  • FileId has been added in the Chromeleon Agent log files. This makes it consistent with the other Agent log files.

  • The Tetra Chromeleon Agent now has new sections: Windows Scheduled Task, Run Time, Enable Queue, and Agent Configuration Advanced Settings. These sections were added for consistency with other Tetra Agents. The authorization section was also updated. New documentation is also available.

Bug Fixes

  • AG-1214 - Connection status is missing
    The status next to the Connection URL field always shows whether the Tetra Chromeleon Agent is connected or not.

  • AG-1251 - Chromeleon Agent failure when used with longer Folder Length
    The Tetra Chromeleon Agent now supports folder path lengths that are longer than 256 characters.

Minor Functionality Changes

  • The Tetra Chromeleon Agent can no longer start until the TDP connection is established and the user account configuration is completed.

v1.1.0

RELEASE DATE: 7 Sep 2021

Enhancements (New Features and Functionality)

The Chromeleon Agent installer was modified to use the same installation mechanism as other Tetra Agents.

v.1.0.1

RELEASE Date: 8 Dec 2020

Enhancements (New Features and Functionality)

  • Support Chromeleon 7.2.5

v 1.0.0

RELEASE DATE: 6 Dec 2020

Main Functionality

  • Fetch Injection data from Chromeleon
  • The injection data is serialized as JSON format and uploaded to TDP for harmonization