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

  1. To gain access to the TeamForge Orchestrate upgrade script upgrade_[version].sh, contact CollabNet Support at https://www.collab.net/support/secure-customer-login
  2. 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

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

Upgrade process

  1. Log into the TeamForge Orchestrate application server (App server) with a privileged account.
  2. Copy upgrade_[version].sh to /tmp and change directories to that location.

    cp upgrade_[version].sh /tmp cd /tmp chmod 755 upgrade_[version].sh

  3. If you are using "disconnected media" to upgrade, follow the steps in Upgrading without internet access
  4. 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.

  5. 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.