Install, Upgrade and Site Administration

Install/Upgrade best practices

  • See Platform specification for TeamForge 8.2 and understand the software and hardware requirements.
  • See the CollabNet TeamForge 8.2 release notes and know more about the TeamForge version you want to install or upgrade to.
  • Plan your installation or upgrade. See Plan your installation | Plan your upgrade
  • Do not customize your operating system installation. Select only the default packages list.
  • If the TeamForge server has SELinux enabled, run it in 'Permissive' mode temporarily while installing or upgrading TeamForge.
  • You must have no tasks in progress while uninstalling the CLI add-ons during the upgrade process.
  • Look for new or modified site-options.conf tokens and update your site-options.conf file as required during the upgrade process.
  • Always use the site-options-dedicated.conf file that's packaged with the TeamForge version you are upgrading to. Refer to the TeamForge 8.1 site-options.conf file and make sure that the TeamForge 8.2 site-options.conf file inherits all the required tokens.
    CAUTION:
    You run the risk of missing out on newly added site option tokens if you keep reusing your site-options.conf file from an older TeamForge version on newer versions.
  • Do not manually modify TeamForge-managed site option tokens such as the AUTO_DATA token. See AUTO_DATA for more information.
  • No backup is required for same hardware upgrades. However, you can create a backup as a precaution. See Back up and restore CollabNet TeamForge data to learn more about backing up TeamForge database and file system.
  • Always use compatible JDBC drivers meant for specific database versions. See JDBC Drivers Reference for more information. Also see: Why do ETL jobs fail post TeamForge upgrade?
  • You can run the initial load job any time after the site is upgraded to TeamForge 8.2. We recommend that you run it before you hand over the site to the users. For more information, see When do I run the initial load job?

Install TeamForge

Before you begin

Platform information | Software requirements
How many servers are required to run TeamForge?
Plan your installation | Set up networking | Open ports
Installation FAQs

Single-server setup

All services on a single: RHEL/CentOS 7.2 server | RHEL/CentOS 6.7 server

Two-server setup

Refer to the following topics if you plan to install TeamForge 8.2 on a two-server distributed setup.

RHEL/CentOS 7.2
Install TeamForge 8.2 on a server and:
Database and Datamart on a separate server
Reporting services on a separate server
Black Duck Code Sight on a separate server
SCM and Git on a separate server
Oracle database on a separate server
Git on a separate server

Three-server setup

Refer to the following topic if you plan to install TeamForge 8.2 on a three-server distributed setup.

Install TeamForge 8.2 on a server and Database and SCM on separate servers

Post installation

Supply license key: From TeamForge user interface | As a text file
Verify your TeamForge 8.2 installation
Maintain your site | Perform common administration tasks

Install TeamForge on VMware Player or VMware ESXi

Hardware and software requirements for CollabNet TeamForge 8.2 on a virtual machine
Install TeamForge 8.2 on: VMware Player | ESXi
Configure CollabNet TeamForge on VMware Player
Supply your TeamForge license key

Upgrade TeamForge

Before you begin

Platform information | Software requirements
How many servers are required to run TeamForge? | Should I upgrade to TeamForge 8.2 on a new server?
Plan your upgrade
Upgrade FAQs

Single-server setup

You may choose to upgrade on the same hardware or new hardware. Refer to the topic that suits your needs.

Upgrade on same hardware Upgrade on new hardware
From 8.1 to 8.2 on: RHEL/CentOS 6.7 server | RHEL/CentOS 7.2 server From 8.1 to 8.2 on: RHEL/CentOS 7.2 server
From 7.1 to 8.2 on RHEL/CentOS  

Two-server setup

Refer to the following topics if you have TeamForge 8.1 running on a two-server distributed setup and are planning to upgrade to TeamForge 8.2 on the same hardware.

RHEL/CentOS 6.7
Upgrade TeamForge on a server and:
Database and datamart on a separate server
Reporting services on a separate server
Black Duck Code Sight on a separate server
Git on a separate server
Oracle database on a separate server
RHEL/CentOS 7.2
Upgrade TeamForge on a server and:
Database and datamart on a separate server
Reporting services on a separate server
Black Duck Code Sight on a separate server
Git on a separate server
Oracle database on a separate server

Three-server setup

Refer to the following topics if you have TeamForge 8.1 running on a three-server distributed setup and are planning to upgrade to TeamForge 8.2 on the same hardware.

RHEL/CentOS 6.7
Upgrade TeamForge on a server and Database and SCM on separate servers
RHEL/CentOS 7.2
Upgrade TeamForge on a server and Database and SCM on separate servers

Install or upgrade Orchestrate

Installation requirements | Installation orientation
Install Orchestrate
Upgrade Orchestrate
Orchestrate integration adapters