Apply TeamForge 17.8 Update 1

TeamForge 17.8 Update 1 is now available. Apply TeamForge 17.8 Update 1 on your site if you are on TeamForge 17.8.

Note:

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

The most common Add-ons and their TeamForge compatibility are published here: https://ctf.open.collab.net/sf/go/page1363

If you have any questions regarding compatibility or updating a specific add-on, contact CollabNet Support.

Important: You must log in as a root user to apply TeamForge 17.8 Update 1.
  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 17.8 Update 1 installation repository on sites without Internet access.
    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 17.8 Update 1 disconnected installation and save it in /tmp.
      • Red Hat Enterprise Linux/CentOS 7.3 64 bit RPM package: CTF-Disconnected-media-17.8.655-104.rhel7.x86_64.rpm
      • Red Hat Enterprise Linux/CentOS 6.x 64 bit RPM package: CTF-Disconnected-media-17.8.655-104.rhel6.x86_64.rpm
    2. Back up the old repo file.
      For example:
      • mv /etc/yum.repos.d/CTF-Disconnected-media-17.8.586.repo /etc/yum.repos.d/CTF-Disconnected-media-17.8.586.repo.cn_backup
    3. Unpack the 17.8 Update 1 disconnected installation package.
      • rpm -Uvh <package-name>
    4. Verify your yum configuration files.
      • yum list httpd
      • yum list apr
  3. Configure your TeamForge installation repository. This step is to configure TeamForge 17.8 Update 1 installation repository on sites with Internet access.
    1. Remove the existing TeamForge repository package.
      • yum erase collabnet-teamforge-repo-17.8-1.noarch
    2. Contact the CollabNet Support and download the TeamForge 17.8 Update 1 installation repository package to /tmp.
    3. Install the TeamForge 17.8 Update 1 installation repository package.
      • yum install -y /tmp/collabnet-teamforge-repo-17.8-1.noarch.rpm
    4. Refresh your repository cache.
      • yum clean all
  4. Install the TeamForge 17.8 Update 1.
    • yum install teamforge

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

  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. Important: Do this if and only if you are upgrading from TeamForge 17.1 (or earlier) to 17.8 on a new hardware.
    Update file permissions on your site's data.
    • teamforge apply-permissions
    Note: This process can take a long time on sites with a lot of data.
  8. Restart TeamForge.
    • teamforge restart