TeamForge installation requirements

Here's what it takes to install and run TeamForge.

Hardware requirements
The following table lists the CPU, RAM and JVM Heap Size recommendations for Small, Medium, Large and Extra-large sites.
  Small Medium Large X-Large
Users 100 500 1000-5000 10000+
CPU Octa-core 12-core > 12-core > 16-core
RAM 16GB 24GB 32GB 32GB
Jboss JVM Heap Size 1.5GB 3GB 6GB > 8GB
Elasticsearch JVM Heap Size* 2GB 2GB 2GB 2GB
200 GB (or more) hard drive #
The following table highlights the factors that can impact TeamForge performance. Numbers are indicative. Anything more than the prescribed numbers may impact the performance.
  Small Medium Large X-Large
Artifacts 15000 70000 100000 100000
Flex Fields 25 50 100 100
Projects 20 80 500 500
Integrations 0-1 0-2 0-2 0-2
Integrated Applications 0-2 0-3 3+ 3+
Important: On Medium, Large and X-Large sites, it is highly recommended that you install the TeamForge Application, Database and SCM services on separate 64-bit servers based on the usage pattern.
Software requirements
Important: Do not customize your operating system installation. Select only the default packages list.
Operating system RHEL 6.8 or 7.3 1 (64 bit) | CentOS 6.8 or 7.3 (64 bit)
Browser Google Chrome 53
Mozilla Firefox 49
Microsoft IE 11
Safari 6.0.5 (8536.30.1).
TeamForge user interfaces are best viewed at screen resolution of at least 1280 x 800 (or more) pixels.
Database PostgreSQL 9.3.12 is installed by default when you install TeamForge 17.1. However, you can use Oracle if you want to. See PostgreSQL or Oracle for more information.
Oracle Server 12c
Oracle Client 12c
Java 2 Jboss/Wildfly 10.1.0.Final
JRE 1.8.0_112
Tomcat 8.0.39
Elasticsearch 5.1.1
Yum package manager 3.2.29 or earlier versions
TeamForge 17.1 supports the following software versions for integration
Review Board 3 2.5.6.1
Git/Gerrit 2.13.x
Subversion 1.8.17
Subversion Edge 5.0
CVS 1.11.x
ViewVC 1.1.24
Nexus 2.9.0 or later
Artifactory Pro 4.7
Jira 6.3-7.1
TestLink 1.9.15 and 1.9.16
Microsoft applications

The following Microsoft applications have been tested with TeamForge:

  • Microsoft Office XP (with Service Pack 3) on Windows XP Service Pack 2 and Windows 2000 Service Pack 4.
  • Microsoft Office 2003 (with Service Pack 1) on Windows XP Service Pack 2 and Windows 2000 Service Pack 4.

PostgreSQL or Oracle?

PostgreSQL 9.3.12 is installed automatically when you install TeamForge 17.1. If you intend to use Oracle, CollabNet recommends that you let the installer run its course, make sure things work normally, and then set up your Oracle database and switch over to it.

If you want to use Oracle as your database, consider the following points:
  • TeamForge 17.1 supports Oracle server 12c and Oracle client 12c.
  • Oracle express edition is not supported for both client and server.
  • Review Board 2.5.6.1 was tested with PostgreSQL 9.3.12 only. Review Board with Oracle was not tested. Note that Review Board must be installed on the TeamForge application server and therefore uses the PostgreSQL database that is installed by default during TeamForge installation.
  • GIT integration works only with PostgreSQL. The Git integration will use PostgreSQL even if your TeamForge site uses Oracle.

The efficiency of your database can have an impact on your users' perception of the site's usability. If your site uses a PostgreSQL database (which is the default), you may want to consider tuning it to fit your specific circumstances. The default settings are intended for a small-to-medium site running on a single server. See What are the right PostgreSQL settings for my site? for recommendations from CollabNet's performance team on optimizing PostgreSQL for different conditions.

* You must have adequate RAM to accomodate the JVM heap requirements of Elasticsearch in addition to the JVM heap requirements of other components such as Jboss, integrated applications, and so on.
# The required hard drive capacity depends on the estimated amount of document and file release uploads.
1 Red Hat Enterprise Linux servers must have access to the Red Hat Network or equivalent (satellite server, spacewalk, or RHN proxy).
2 For larger installs, the max JVM heap size should be increased to 1024MB (or larger), depending on available resources on the server.
3 It is recommended to install Review Board on the TeamForge application server.