Tetra Chromeleon Agent Release Notes

The Tetra Chromeleon Agent release notes appear below. They are organized by version number.

📘

NOTE:

To upgrade the Tetra Chromeleon Agent, see this document.

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