Install Project Tracker on a CollabNet TeamForge site

You can make Project Tracker available as an integrated application for project managers on your CollabNet TeamForge site.

1. Download the PTInstaller.zip file from the location provided by your CollabNet representative.
2. Unzip the PTInstaller.zip file. On unzipping the PTInstaller.zip file, a ptinstaller directory is created.
3. Update the parameters in the PTInstaller-/installer/install.conf file. The install.conf file contains the configuration tokens for the database and the CollabNet TeamForge application with default values. You can change the values, if required.
   1. The location of the Project Tracker installation directory.
      
      • pt.dir = /u2/projecttracker
   2. The database user name.
      
      • scarab.database.user = tigris
   3. The database login password.
      
      • scarab.database.password = password for "tigris" user
      Note: Refer to CEE "runtime-options.conf" file to confirm the current setting for that site.
   4. The database host or box details.
      
      • scarab.database.host = localhost
   5. The database port details.
      
      • scarab.database.port = 3306
   6. The database name.
      
      • scarab.database.name = tigris.
   7. The CollabNet TeamForge domain information.
      
      • ctf.baseurl = http://<hostname>/
   8. The location of the ptctfevents.jar file.
      
      • ctf.site.var.dir = /opt/collabnet/teamforge/var
      Note: Specify this information only if the CollabNet TeamForge and Project Tracker applications are installed on the same box, else leave this value blank.
      Note: If the CollabNet TeamForge and Project Tracker applications are not installed on the same box, copy the ptctfevents.jar file from the ptinstaller/package directory and put it under the /opt/collabnet/teamforge/var directory on CollabNet TeamForge installation box.
   9. Tomcat port that Project Tracker runs on.
      
      • tomcat.port = 13000
   10. Project Tracker domain information.
       
       • domain = <hostname>
   11. The timezone has to be set depending on the box.
       
       • timezone = value found in "/usr/share/zoneinfo"
       Note: For boxes hosted in Brisbane, the value will be PST or US/Pacific.
   12. Change the java home setting, if required.
       
       • java_home = /usr/java/jdk1.5.0_12
       Note: This doesn't have to be changed unless a different Java is installed on the system.
   13. Set up the protocol.
       
       • protocol = "https" for a SSL based build or "http" for a non-SSL build.
4. In the ptinstaller directory, run the python install.py.
   
   • sudo python install.py -i -r
   Note: The installer options available for this script are:
   

   • -h, --help (show this help message and exit)
   • -i, --install (install project tracker)
   • -r, --runtime (create runtime environment)

   If you make any configuration changes to the install.conf file, then you can use the "sudo python installer.py -r" to re-create runtime.
   Tip: If you get a "CTF events have not been installed" message, you might have missed providing the ptctfevents.jar file.
   The message "Project Tracker has been installed. Please bootstrap the site using bootstrap-data.py and start Project Tracker through /etc/init.d/projecttracker start" appears on successful install.