Running in Apache Tomcat as a Windows service (32-bit)

Apache Tomcat can be run as a Windows service, which is useful if you want to run the Jazz™ Team Server on a computer that is using Microsoft Windows without having to be logged on.

Before you begin

Tip: To avoid problems, do not use spaces in file paths. For the Program Files directory on 32-bit systems, you can use PROGRA~1.
If you are using Derby as the database for your Jazz Repository, edit the teamserver.properties file for each application to make the DB location an absolute path. Substitute the app name variable with the appropriate application directory name, for example, jts, ccm, qm, rm:
  1. Open the <JazzInstallDir>\server\conf\<app name>\teamserver.properties file.
  2. Change the com.ibm.team.repository.db.jdbc.location=conf/<app name>/derby/repositoryDB entry to com.ibm.team.repository.db.jdbc.location=C:/PROGRA~1/IBM/JazzTeamServer/server/conf/<app name>/derby/repositoryDB. Note the forward slash (/) in the path.
  3. Also change the com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB entry to com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/C:/PROGRA~1/IBM/JazzTeamServer/server/conf/jts/derby/warehouseDB. Note the forward slash (/) in the path.
In addition to editing the teamserver.properties file, you must edit the log4j.properties file to make the log file path name absolute. Substitute the app name variable with the application directory names, for example, jts, ccm, qm, rm, admin and the app name.log variable with each application log file, for example, jts.log, ccm.log, qm.log, rm.log, admin.log:
  1. Open the <JazzInstallDir>\server\conf\<app name>\log4j.properties file.
  2. Change the log4j.appender.file.File=logs/<app name.log> entry to log4j.appender.file.File=C:/PROGRA~1/IBM/JazzTeamServer/server/logs/<app name.log>. Note the forward slash (/) in the path.
  3. Change the log4j.appender.etl.File=logs/<app name.log> entry to log4j.appender.etl.File=C:/PROGRA~1/IBM/JazzTeamServer/server/logs/<app name.log>. Note the forward slash (/) in the path.

Verify that the service is not installed. If the service is installed, uninstall the service, and then restart the computer. Then install the new service.

Procedure

  1. Set the CATALINA_HOME variable, and restart the system. To set the variable:
    1. Click Start > Control Panel > System.
    2. Click the Advanced tab, then click Environment Variables.
    3. Under System variables click New.
    4. In Variable name enter CATALINA_HOME, and in Variable value enter C:\<JazzInstallDir>\server\tomcat.
  2. Open a command prompt, and run the following command to install the Tomcat service:
    <JazzInstallDir>\server\tomcat\bin\service.bat install tomcat5
  3. Run <JazzInstallDir>\server\tomcat\bin\tomcat5w.exe to configure the service.
    Note: On Windows operating systems that have User Account Control (UAC) such as Windows 7, the command shell must be run as an administrator.
  4. Click the Java tab, and clear the Use default check box.
  5. Add the following path to the Java Virtual Machine. You can also click the ellipsis icon to browse for the jvm.dll file.
    <JazzInstallDir>\server\jre\bin\j9vm\jvm.dll
  6. Add the following lines at the end of the Java Options text field:
    -DJAZZ_HOME=file:///C:/<JazzInstallDir>/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=%TEMP%
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/<JazzInstallDir>/server/conf/startup_log4j.properties
    If you are using the Oracle database, add this line substituting the path with the driver location:
    -DORACLE_JDBC_DRIVER_FILE=[Path to the ojdbc5.jar file.]
    If you are using the SQL Server database with JRE 6.0, add this line substituting the path with the driver location:
    -DSQLSERVER_JDBC_DRIVER_FILE=[Path to the sqljdbc4.jar file.]
    If you are using the SQL Server database with JRE 5.0, add this line substituting the path with the driver location:
    -DSQLSERVER_JDBC_DRIVER_FILE=[Path to the sqljdbc.jar file.]
  7. In the Maximum memory pool, change the pool size to 1200.
  8. On the Startup and Shutdown tabs, make sure that jvm is selected for the Mode setting.
  9. Click the General tab and change the Startup type to Automatic to start the service automatically when Windows starts.
  10. Start the service to test the server.

Feedback