Running Jazz Team Server in Apache Tomcat as a Windows service

Apache Tomcat has the ability to run as a Windows® service. This can be useful if you want to run the Jazz™ Team Server on a Windows-based machine without having to be logged on.

Before you begin

This topic assumes that your Jazz Team Server deployment is rooted at C:\jazz; adjust your paths accordingly based on your actual root directory.

Procedure

  1. Open a command prompt and execute the following command to install the Tomcat service.
    C:\jazz\server\tomcat\bin\service.bat install
  2. If you are using Derby as your database for your Jazz Repository, edit C:\jazz\server\conf\jazz\teamserver.properties to make the DB location an absolute path. For example, change the value of db.jdbc.location to C:/jazz/server/repositoryDB. Note the forward slash (/) in the path.
  3. Execute C:\jazz\server\tomcat\bin\tomcat5w.exe to configure the service.
  4. Click the Java tab and clear the check box for Use default.
  5. Add the following path to Java Virtual Machine. You can also click the ellipsis icon to browse for the jvm.dll file.
    C:\jazz\server\jre\bin\j9vm\jvm.dll
  6. Add the following lines at the bottom of the Java Options text field
    -DJAZZ_HOME=file:///c:/jazz/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=%TEMP%
    If you are using Oracle database, add the following line:
    -DORACLE_JDBC=[path to Oracle JDBC driver jar]
    If you are using SQL Server database, also add the following line:
    -DSQLSERVER_JDBC=[path to SQL Server JDBC driver jar]
  7. Change the Maximum memory pool size to 1536.
  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 if you want to start the service automatically when Windows starts.
  10. Start the service to test the server.

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug