Installing Tomcat as a Windows Service for running Jazz Team server

Answer

This technote assumes that your Jazz Team Server deployment is rooted at C:\Program Files\IBM\JazzTeamServer so adjust your paths accordingly based on your actual root directory.
Moreover, this technote assumes that you are using Derby as backing database.

1. 1Execute in a command shell service.bat install to install the Tomcat service:
1. C:\Program Files\IBM\JazzTeamServer\server\tomcat\bin>service.bat install
2. Check under Services in the Administrative Tools whether Apache Tomcat is listed now as service:
   
   
3. Using Derby as the backing database for your Jazz Repository, edit the file teamserver.properties to make the DB location an absolute path. For example, change the value of db.jdbc.location to C:/Program Files/IBM/JazzTeamServer/server/repositoryDB.
   Teamserver.properties is located under C:\Program Files\IBM\JazzTeamServer\server\conf\jazz. Enter the absolute path with forward slashes.
5. Specify the WorkItem text index with a fully qualified location. Edit teamserver.properties to change the value of com.ibm.team.fulltext.indexLocation to C:/Program Files/IBM/JazzTeamServer/server/workitemindex.
   

Extract of teamserver.properties com.ibm.team.repository.db.jdbc.location=C:/Program Files/IBM/JazzTeamServer/server/repositoryDB com.ibm.team.fulltext.indexLocation=C:/Program Files/IBM/JazzTeamServer/server/workitemindex

8. Execute C:\Program Files\IBM\JazzTeamServer\server\tomcat\bin\tomcat5w.exe to configure the service.
   
   
   
9. On the Java tab, uncheck Use default:
10. Change the Java Virtual Machine path to be
    C:\Program Files\IBM\JazzTeamServer\server\jre\bin\j9vm\jvm.dll
11. Add these lines at the bottom of the Java Options text field with this content (Also check the server.startup.bat file located under C:\Program Files\IBM\JazzTeamServer\server for additional environment settings that are not included here).

-DJAZZ_HOME=file:///C:/Program Files/IBM/JazzTeamServer/server/conf -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Dcom.ibm.team.repository.tempDir=%TEMP%

14. Change the "Maximum memory pool" size to be 700 (instead of adding the Java option -Xmx700M)
    

Java Options in Apache Tomcat Properties window -Dcatalina.base=C:\Program Files\IBM\JazzTeamServer\server\tomcat -Dcatalina.home=C:\Program Files\IBM\JazzTeamServer\server\tomcat -Djava.endorsed.dirs=C:\Program Files\IBM\JazzTeamServer\server\tomcat\common\endorsed -Djava.io.tmpdir=C:\Program Files\IBM\JazzTeamServer\server\tomcat\temp -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///C:/Program Files/IBM/JazzTeamServer/server/conf -Dcom.ibm.team.repository.tempDir=%TEMP%

15. On the Startup and Shutdown tabs, make sure the Mode setting is jvm.
16. On the General tab you can change the Startup type to be Automatic if you want the service to start on its own.
17. Start the service to test out the server.