Install an instance set

To apply special modifications to a CollabNet TeamForge installation, install an instance set.

1. If an instance set is already installed, remove it. To check if an instance set is present, look for this file: /opt/collabnet/teamforge/dist/conf/instance.txt. If there is an instance.txt file, an instance set is installed on the system.
2. Download the installation bundle for the instance set you want to install.

   cd <installation_source>

   sudo wget --http-user=deploy1 --http-passwd= [get password from releng] http://releng.extranet.collab.net/[instance_install_bundle]

   Note: Check with releng for the appropriate path and file.
3. Unpack the instance set installation bundle.

   sudo tar xvzf [instance_install_bundle]

4. Stop CollabNet TeamForge.
   Note: If CollabNet TeamForge is running on multiple machines, stop all of them.
   • sudo /etc/init.d/collabnet stop all
   • /etc/init.d/collabnet stop all
5. Install the instance set on each node.

   sudo ./instance-set-install.sh -f [manifest_file] -d /opt/collabnet/teamforge

   where:

   • [manifest_file]is the manifest file with the appropriate information for this upgrade
   • /opt/collabnet/teamforge is the directory where CollabNet TeamForge was previously installed. (The default directory is /opt/collabnet/teamforge).
   For example, to install an instance set for a site called mysitewith the CollabNet TeamForge installation source in the default location, use this command:

   sudo ./instance-set-install.sh -f mysite-manifest -d /opt/collabnet/teamforge

6. Start CollabNet TeamForge on all the machines in the group.
   • sudo /etc/init.d/collabnet start all
   • /etc/init.d/httpd start
   • /etc/init.d/postgresql start
   • /etc/init.d/collabnet start
7. Verify that the instance set was installed.
   1. Log onto the site as a site administrator.
   2. On the Admin tab, click System Tools.
   3. Click Build Information and confirm that the instance set is present.