Ausführung in Apache Tomcat als Windows-Dienst (32 Bit)

Apache Tomcat kann als Windows-Dienst ausgeführt werden. Dies ist ratsam, wenn Sie Jazz Team Server auf einem Computer mit Microsoft Windows ausführen möchten, ohne sich anmelden zu müssen.

Vorbereitende Schritte

Tipp: Vermeiden Sie Probleme, indem Sie in Dateipfaden keine Leerzeichen verwenden. Für das Verzeichnis Programme auf 32-Bit-Systemen können Sie PROGRA~1 verwenden.
Wenn Sie Derby als Datenbank für Ihr Jazz-Repository verwenden, bearbeiten Sie Sie die Datei teamserver.properties jeder Anwendung so, dass für die Datenbankposition ein absoluter Pfad angegeben ist. Ersetzen Sie die Variable Anwendungsname durch den Namen des jeweiligen Anwendungsverzeichnisses, z. B. durch jts, ccm, qm, rm:
  1. Öffnen Sie die Datei <Jazz-Installationsverzeichnis>\server\conf\<Anwendungsname>\teamserver.properties.
  2. Ändern Sie den Eintrag com.ibm.team.repository.db.jdbc.location=conf/<Anwendungsname>/derby/repositoryDB in com.ibm.team.repository.db.jdbc.location=C:/PROGRA~1/IBM/JazzTeamServer/server/conf/<Anwendungsname>/derby/repositoryDB. Beachten Sie die Schrägstriche (/) im Pfad.
  3. Ändern sie außerdem den Eintrag com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB in com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/C:/PROGRA~1/IBM/JazzTeamServer/server/conf/jts/derby/warehouseDB. Beachten Sie die Schrägstriche (/) im Pfad.
Neben der Datei teamserver.properties müssen Sie die Datei log4j.properties bearbeiten und einen absoluten Namen für den Protokolldateipfad angeben. Ersetzen Sie die Variable Anwendungsname durch denn Namen des Anwendungsverzeichnisses, z. B. durch jts, ccm, qm, rm, admin, und die Variable Anwendungsname.log durch die Protokolldatei der jeweiligen Anwendung, z. B. durch jts.log, ccm.log, qm.log, rm.log, admin.log:
  1. Öffnen Sie die Datei <Jazz-Installationsverzeichnis>\server\conf\<Anwendungsname>\log4j.properties.
  2. Ändern Sie den Eintrag log4j.appender.file.File=logs/<Anwendungsname.log> in log4j.appender.file.File=C:/PROGRA~1/IBM/JazzTeamServer/server/logs/<Anwendungsname.log>. Beachten Sie die Schrägstriche (/) im Pfad.
  3. Ändern Sie den Eintrag log4j.appender.etl.File=logs/<app name.log> in log4j.appender.etl.File=C:/PROGRA~1/IBM/JazzTeamServer/server/logs/<app name.log>. Beachten Sie die Schrägstriche (/) im Pfad.

Vergewissern Sie sich, dass der Service nicht installiert ist. Andernfalls müssen Sie ihn deinstallieren und dann den Computer neu starten. Installieren Sie dann den neuen Service.

Vorgehensweise

  1. Setzen Sie die Variable CATALINA_HOME und starten Sie das System neu. Gehen Sie zum Setzen der Variablen wie folgt vor:
    1. Klicken Sie auf Start > Systemsteuerung > System.
    2. Klicken Sie auf das Register Erweitert und dann auf Umgebungsvariablen.
    3. Klicken Sie unter "Systemvariablen" auf Neu.
    4. Geben Sie im Feld Variablenname CATALINA_HOME ein und im Feld Variablenwert C:\<Jazz-Installationsverzeichnis>\server\tomcat.
  2. Öffnen Sie eine Eingabeaufforderung und führen Sie den folgenden Befehl aus, um den Tomcat-Dienst zu installieren:
    <Jazz-Installationsverzeichnis>\server\tomcat\bin\service.bat install tomcat5
  3. Führen Sie <JazzInstallDir>\server\tomcat\bin\tomcat5w.exe zur Konfiguration des Dienstes aus.
    Anmerkung: Auf Windows-Betriebssystemen, die eine Benutzeraccountsteuerung einsetzen, wie beispielsweise Windows 7, muss man die Befehlsshell als Administrator ausführen.
  4. Klicken Sie auf das Register Java und löschen Sie die Markierung für das Kontrollkästchen Use default.
  5. Fügen Sie unter Java Virtual Machine den folgenden Pfad hinzu. Sie können auch auf die Auslassungspunkte klicken, um nach der Datei jvm.dll zu suchen.
    <Jazz-Installationsverzeichnis>\server\jre\bin\j9vm\jvm.dll
  6. Fügen Sie am Ende des Textfeldes Java Options die folgenden Zeilen hinzu:
    -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
    Wenn Sie die Oracle-Datenbank verwenden, fügen Sie folgende Zeile hinzu, die den Pfad mit der Treiberposition ersetzt:
    -DORACLE_JDBC_DRIVER_FILE=[Path to the ojdbc5.jar file.]
    Falls Sie eine SQL-Server-Datenbank mit JRE 6.0 verwenden, fügen Sie die folgende Zeile hinzu, die den Pfad mit der Treiberposition ersetzt:
    -DSQLSERVER_JDBC_DRIVER_FILE=[Path to the sqljdbc4.jar file.]
    Falls Sie eine SQL-Server-Datenbank mit JRE 5.0 verwenden, fügen Sie die folgende Zeile hinzu, die den Pfad mit der Treiberposition ersetzt:
    -DSQLSERVER_JDBC_DRIVER_FILE=[Path to the sqljdbc.jar file.]
  7. Ändern Sie die Poolgröße im Feld Maximum memory pool in '1200'.
  8. Vergewissern Sie sich, dass auf den Registerseiten Startup und Shutdown für Mode die Einstellung jvm ausgewählt ist.
  9. Klicken Sie auf das Register General und setzen Sie den Starttyp unter Startup type auf Automatic, um den Dienst beim Start von Windows automatisch zu starten.
  10. Starten Sie den Dienst, um den Server zu testen.

Feedback