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 adapter:
The TeamForge tracker adapter sends tracker changes to Orchestrate and may be
dependent on a specific version of TeamForge. To install the tracker adapter:
-
Download the TeamForge Tracker adapter orchestrate-tracker-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
-
Click Create.
-
Browse to the adapter and click Add.
Restart Orchestrate and TeamForge
Once the tracker adapter is installed, a reboot of both TeamForge and Orchestrate is necessary.
-
Restart TeamForge
See TeamForge documentation for details on restarting TeamForge.
-
Restart Orchestrate
Restart the "collabnet-nginx" service. See System Administration for details on restarting collabnet-nginx.