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:
- Open the <JazzInstallDir>\server\conf\<app
name>\teamserver.properties file.
- 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.
- 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:
- Open the <JazzInstallDir>\server\conf\<app
name>\log4j.properties file.
- 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.
- 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
- Set the CATALINA_HOME variable,
and restart the system. To set the variable:
- Click .
- Click the Advanced tab, then
click Environment Variables.
- Under System variables click New.
- In Variable name enter CATALINA_HOME,
and in Variable value enter C:\<JazzInstallDir>\server\tomcat.
- Open a command prompt, and run the following command to
install the Tomcat service:
<JazzInstallDir>\server\tomcat\bin\service.bat install tomcat5
- 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.
- Click the Java tab, and clear the Use
default check box.
- 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
- 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.]
- In the Maximum memory pool, change
the pool size to 1200.
- On the Startup and Shutdown tabs,
make sure that jvm is selected for the Mode setting.
- Click the General tab and change
the Startup type to Automatic to
start the service automatically when Windows starts.
- Start the service to test the server.