Single host upgrades

This article provides steps for upgrading single host TeamForge Orchestrate installations to the latest release.

The following steps pertain to TeamForge Orchestrate upgrades when all services are located on a single machine. Upon successful completion, TeamForge Orchestrate will be upgraded to the latest available release.

Important: The upgrade process stops the TeamForge Orchestrate App server while upgrading. Anticipate up to 20 minutes of end-user downtime from the time services are shut down.

Download upgrade_[version].sh

To gain access to the TeamForge Orchestrate upgrade script upgrade_[version].sh, contact CollabNet Support at https://www.collab.net/support/secure-customer-login
Once Support has given you access, download upgrade_[version].sh from https://ctf.open.collab.net/sf/sfmain/do/viewProject/projects.sfdl
where [version] represents the upgrade target version of Orchestrate.

Back up the TeamForge Orchestrate system

Before upgrading, backup TeamForge Orchestrate system and data, see Backup and Restore

Upgrade process

Log into the TeamForge Orchestrate application server (App server) with a privileged account.
Copy upgrade_[version].sh to /tmp and change directories to that location.
cp upgrade_[version].sh /tmp cd /tmp chmod 755 upgrade_[version].sh
If you are using "disconnected media" to upgrade, follow the steps in Upgrading without internet access
Perform the upgrade by running upgrade_[version].sh, passing the all flag.
sudo ./upgrade_[version].sh all

Note: The TeamForge Orchestrate web interface will be unavailable to end-users until after the upgrade process.

Services will be restarted automatically upon completion.
Verify that all services are running after upgrade_[version].sh terminates
The upgrade script should display a list of all services with [OK] denoting a successful restart.

Install/upgrade the Collabnet TeamForge tracker and commit adapters:

The TeamForge tracker and commit adapters send tracker changes and commit data respectively to Orchestrate and may be dependent on a specific version of TeamForge. To install the tracker and commit adapters:

Download the TeamForge Tracker Adapter, orchestrate-tracker-adapter-[version].jar, and the TeamForge Commit Adapter, orchestrate-commit-adapter-[version].jar, corresponding to your version of CollabNet TeamForge from the TeamForge Orchestrate Community.
Log into your CollabNet TeamForge as a site admin.
Navigate to Admin > System Tools > Customizations
Note: If Customizations is not available on your instance of TeamForge, please see TeamForge adapters - alternative installation method.
Select the existing Orchestrate tracker and commit adapters, if any, and click Delete.
Click Create.
Browse to the tracker and commit adapters (one at a time) you downloaded earlier and click Add.