Skip to main content
Version: TeamForge 23.1

TeamForge 23.1 Update 4 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
Update 4: 23.1.0.419July 25, 2025

Issues Fixed in Teamforge 23.1 Update 4 Release​

  • Fixed an issue where users could create or modify a repository with a corrupted .gitmodules file via the TeamForge UI or REST API. The system now validates .gitmodules structure to prevent introducing invalid configurations that would otherwise be rejected during Git push operations over SSH or HTTPS.
note

When a review request contains a corrupted .gitmodules file, merging is currently blocked. In such cases, the UI displays a generic error message: "Failed to merge: Unknown error." We're aware that this message lacks clarity and are working to improve it in an upcoming release.

  • Fixed an issue where downloaded Excel files from Collab DOC contained special characters (such as square brackets) in their filenames, causing compatibility issues with newer versions of Microsoft Excel. Filenames are now automatically sanitized during download to ensure compatibility with Excel’s updated restrictions.

TeamForge SCM—Enterprise Version Control​

TeamForge—Git Integration 23.1.15-3.5.6

For more information about vanilla Gerrit version 3.5, see Gerrit 3.5 Release Notes.

Apply Teamforge 23.1 Update 4​

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

TeamForge add-on packages can remain installed when you apply Teamforge 23.1 Update 4. 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 4.

  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 4 installation repository on sites without Internet access.

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

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

    b. Back up the old repo file.

    For example:

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

    c. Unpack the 23.1 Update 4 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 4 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 4 installation repository package to /tmp.

    c. Install the Teamforge 23.1 Update 4 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 4.

    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