Skip to main content
Version: TeamForge 23.1

TeamForge 23.1 Update 3 Release Notes

Release Information​

VersionReleased On
GA Version: 23.1.325Dec 29, 2023
Update 1: 23.1.355-462Mar 25, 2024
Update 2: 23.1.356-473May 13, 2024
Update 3: 23.1.397-553May 13, 2025

Issues Fixed in Teamforge 23.1 Update 3 Release​

  • Fixed an issue where downloading document versions from the association tab resulted in an empty page instead of downloading the document. Users can now successfully download document versions from the association tab.
  • Fixed an issue with artifact due date handling when using different date formats in user account settings. Previously, changing the date format from "MM/dd/yyyy" to other formats (such as "dd/MM/yyyy") could result in incorrect date conversions. The system now correctly maintains the intended date regardless of the user's preferred date format setting.
  • Fixed an issue in the document review system where review completion status was being incorrectly attributed to users who had not submitted reviews. The system now correctly tracks and displays review completion status for the actual reviewer who submitted the response.
  • Fixed an issue where changes to Actual Effort and Estimated Effort fields were not being captured in the audit log API for artifacts configured with Sum points from Children option. The audit log now properly records historical changes for these effort-related fields in parent-child artifact relationships.
  • Fixed an issue where importing artifacts with numerous dependencies would fail with an "Unable to lock item" error. The system now properly handles the import of artifacts regardless of the number of dependencies, ensuring successful status updates and other modifications during the import process.
  • Fixed an issue where document images linked in artifact descriptions appeared as broken links after upgrading to TeamForge 23.1. This issue affected both existing artifacts migrated from version 21.2 and newly created artifacts in version 23.1.
  • Improved query performance for retrieving artifact assignment history in environments with large audit tables. The optimization significantly reduces response time when accessing previous assignee information, particularly in systems with extensive audit data.
  • Fixed performance issues causing high CPU load on database servers, particularly during intensive artifact operations. The improvements include:
    • Optimized query handling for audit table operations
    • Enhanced database performance during high-volume artifact updates and event processing
  • Fixed a timeout issue in CollabNet Desktop that prevented access to documents in projects with large document repositories. The fix improves handling of projects containing numerous documents and folders, ensuring reliable access through the CollabNet Desktop interface.
  • Fixed an issue where artifact imports were failing after upgrading to TeamForge 23.1. The fix includes updates to the MessagingService component to properly handle user email destinations during the import process, resolving the post-upgrade import failures.
  • Fixed an issue where SOAP API login would fail with valid credentials after multiple failed login attempts. Previously, users were unable to log in through the SOAP API even with correct credentials after 10 failed login attempts. The system now properly handles authentication attempts and allows successful login with valid credentials regardless of previous failed attempts.
  • Fixed an issue where users would encounter a "TeamForge system error" when attempting to log in with their old password after initiating but not completing the password reset process. The system now provides appropriate error messaging and handles incomplete password reset scenarios correctly.
  • Fixed issues with TeamForge-Gerrit synchronization error handling. The improvements include:
    • Modified RbacSoap calls to properly throw SystemFault instead of an exception
    • Improved exception handling and logging for role cluster synchronization
    • Enhanced error reporting for invalid project and role IDs during sync operations
  • Fixed a connection leak issue in WEBR when requests are routed through HAProxy. The fix implements a new HTTP client using DialWithTimeout to properly manage connection life cycles and prevent resource leaks.
  • Fixed an issue with document management operations after upgrading. The fix includes:
    • Replaced Java EE executor service with Java executor service for improved performance
    • Enhanced execution handling for document deletion, folder deletion, and document move operations
    • Resolved permission verification issues affecting site and project administrators
    • Improved concurrent operation handling during artifact imports and document operations
  • Optimized the PageRecord class performance with the following improvements:
    • Implemented Caffeine Cache for better caching performance
    • Improved concurrency handling

Apply Teamforge 23.1 Update 3​

Teamforge 23.1 Update 3 is now available. Apply Teamforge 23.1 Update 3 on your site if you are on Teamforge 23.1.

TeamForge add-on packages can remain installed when you apply Teamforge 23.1 Update 3. No updates are required. However, you should verify the compatibility of Add-ons applied to your site as some may be more specific to your site.
If you have any questions regarding compatibility or updating a specific add-on, contact Digital.ai Support.

important

You must log in as a root user to apply Teamforge 23.1 Update 3.

  1. Stop TeamForge.

    note

    Stop TeamForge on all the servers in a distributed setup.

    teamforge stop

  2. Skip this step if your site has internet access. This step is to configure Teamforge 23.1 Update 3 installation repository on sites without Internet access.

    a. Contact the Digital.ai Support to get the auxiliary installer package for Teamforge 23.1 Update 3 disconnected installation and save it in /tmp.

    • Red Hat Enterprise Linux/CentOS 7.9 64 bit RPM package: CTF-Disconnected-media-23.1.357-xxx.rhel7.x86_64.rpm
    • Red Hat Enterprise Linux 8.8 64 bit RPM package: CTF-Disconnected-media-23.1.357-xxx.rhel8.x86_64.rpm

    b. Back up the old repo file.

    For example:

    mv /etc/yum.repos.d/CTF-Disconnected-media-23.1.356.repo /etc/yum.repos.d/CTF-Disconnected-media-23.1.356.repo.cn_backup

    c. Unpack the 23.1 Update 3 disconnected installation package.

    rpm -Uvh <package-name>

    d. Verify your yum configuration files.

    yum list httpd
    yum list apr

  3. Configure your TeamForge installation repository. This step is to configure Teamforge 23.1 Update 3 installation repository on sites with Internet access.

    a. Remove the existing TeamForge repository package.

    yum erase collabnet-teamforge-repo-23.1-0.noarch

    b. Contact the Digital.ai Support and download the Teamforge 23.1 Update 3 installation repository package to /tmp.

    c. Install the Teamforge 23.1 Update 3 installation repository package.

    yum install -y /tmp/collabnet-teamforge-repo-23.1-0.noarch.rpm

    d. Refresh your repository cache.

    yum clean all

  4. Install the Teamforge 23.1 Update 3.

    yum install teamforge

    The above command installs all the TeamForge updates available in the CollabNet yum repository for Teamforge 23.1.

  5. Check the /opt/collabnet/teamforge/var/scm/gerrit/gitroot directory. If it is empty, remove it manually.

    rm -rf gitroot

  6. Deploy services.

    teamforge provision

  7. Update file permissions on your site's data.

    important

    Do this if and only if you are upgrading from TeamForge 17.1 (or earlier) to 23.1 on a new hardware.

    teamforge apply-permissions
    note

    This process can take a long time on sites with a lot of data.

  8. Restart TeamForge.

    teamforge restart