Tomcat als Service unter Windows installieren UND für den Jazz Team Server konfigurieren

Weil ich es eben gemacht habe,
und falls ich es in Zukunft wieder brauche, mir ein wenig gegoogle erpare,
folgend eine kurze Zusammenfassung, wie man das Ganze zustande bringt:

Installation von Tomcat als Service / Dienst:

Nach dem download (hier) wird einfach der Installer wizard wie gewohnt ausgeführt.

Anschließend geht es darum, tomcat als Dienst festzulegen und automatisch zu starten.

Sehr geholfen hierbei hat mir das offizielle Windows service HOW-TO der Apache Foundation die unter anderem Folgendes beschreibt:

Installing services

The safest way to manually install the service is to use the provided service.bat script. Administrator privileges are required to run this script. If necessary, you can use the /user switch to specify a user to use for the installation of the service. NOTE: On Windows Vista or any other operating system with User Account Control (UAC) you must either disable UAC or right-click on cmd.exe and select "Run as administrator" in order to run this script. If UAC is enabled neither being logged on with an Administrator account, nor using the /user switch is sufficient. Install the service named 'Tomcat7' C:\> service.bat install

Also begeben wir uns auf der Windows command line in den Ordner, in dem Tomcat liegt, wechseln ins bin Verzeichnis und installieren das service wie beschrieben.
Konfigurieren kann man den service anschließend über das Gui, wenn man Tomcat7w.exe startet.


Konfiguration für den Jazz Team Server:

Um nun dem Jazz Framework mitzuteilen, welchen tomcat es wie verwenden soll,
klärt uns die Hilfe von RTC direkt von IBM auf:

Vorbereitende Schritte

Das Stammverzeichnis Ihrer Implementierung von Jazz Team Server muss C:\jazz sein. Passen Sie Ihre Pfade ausgehend vom tatsächlichen Stammverzeichnis an.

Bei diesen Anweisungen wird davon ausgegangen, dass der Dienst nicht installiert ist. 
Falls er installiert ist, überspringen Sie Schritt 1!

1. Öffnen Sie eine Eingabeaufforderung und führen Sie den folgenden Befehl aus, um den Tomcat-Dienst zu installieren.

   C:\jazz\server\tomcat\bin\service.bat install

2. Wenn Sie Derby als Datenbank für Ihr Jazz-Repository verwenden, bearbeiten Sie C:\jazz\server\conf\jazz\teamserver.properties so, dass für die Datenbankposition ein absoluter Pfad angegeben ist. Ändern Sie beispielsweise den Wert von db.jdbc.location in C:/jazz/server/repositoryDB.
   Beachten Sie die Schrägstriche (/) im Pfad.
   Zusätzlich zur Bearbeitung von teamserver.properties muss die Datei log4j.properties hinzugefügt werden, um den Protokolldateipfad zu einem absoluten Pfad zu machen. Bearbeiten Sie für die JTS-Protokolldatei conf\jts\log4j.properties, um den Wert der Eigenschaft log4j.appender.file.File auf einen absoluten Pfad zu setzen, z. B. auf log4j.appender.file.File=C:/jazz/server/logs/jts.log.
   Beachten Sie die Schrägstriche (/) im Pfad. 
   
3. Führen Sie C:\jazz\server\tomcat\bin\tomcat5w.exe aus, um den Dienst zu konfigurieren. 
   
4. Klicken Sie auf das Register Java und löschen Sie die Markierung im 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.

   C:\jazz\server\jre\bin\j9vm\jvm.dll

6. Fügen Sie unten im Textfeld Java Options die folgenden Zeilen hinzu:

   -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%
   -Djazz.connector.sslProtocol=SSL_TLS
   -Djazz.connector.algorithm=IbmX509
   -Dlog4j.configuration=file:///c:/jazz/server/conf/startup_log4j.properties
   

   Wenn Sie eine Oracle-Datenbank verwenden, fügen Sie folgende Zeile hinzu:

   -DORACLE_JDBC=[Pfad zur Oracle JDBC-Treiber-JAR]
   

   Falls Sie eine SQL-Server-Datenbank verwenden, fügen Sie auch die folgende Zeile hinzu:

   -DSQLSERVER_JDBC=[Pfad für die SQL Server JDBC-Treiber-JAR]

7. Ändern Sie die Größe für Maximum memory pool in den Wert '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, sofern der Dienst automatisch beim Start von Windows gestartet werden soll.
   
   
10. Starten Sie den Dienst, um den Server zu testen.

Damit sollte nun tomcat als Dienst unter Windows laufen und von Jazz verwendet werden.


Um den Jazz Team Server in einer vorhandener Apache-Tomcat-Umgebung implementieren habe ich folgende Informationen hier von IBM gefunden:

Verwenden Sie die folgenden Anweisungen, um Jazz Team Server für die Zusammenarbeit mit Ihrem vorhandenen Apache Tomcat Server zu konfigurieren.

Vorgehensweise

1. Kopieren Sie die Datei 'jts.war' aus dem Jazz-Installationsverzeichnis in das Verzeichnis tomcat\webapps.
   
2. Öffnen Sie die Tomcat-Startdatei zur Bearbeitung und fügen Sie die folgenden Einstellungen für Systemeigenschaften hinzu:

   set CATALINA_OPTS=-Dcom.ibm.team.server.configURL=file:///"%cd%"/teamserver.properties -Dlog4j.configuration=file:///"%cd%"/log4j.properties 
   set JAVA_OPTS=-Djava.awt.headless=true -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Dcom.ibm.team.repository.provision.profile="%cd%"\provision_profiles -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
   

3. Speichern und schließen Sie die Startdatei.
   
4. Öffnen Sie die Datei teamserver.properties und bearbeiten Sie sie so, dass sie auf Ihre Datenbank zeigt.
   
5. Speichern und schließen Sie die Datei teamserver.properties.

Doch leider weiß ich nicht, ob man für Jazz unbedingt den mitgelieferten tomcat verwenden MUSS oder einfach einen bereits installierten (in einer anderen Version?) verwenden kann.


Falls jemand hierbei Erfahrungen hat, bitte lasst es mich wissen, nutzt die Kommentar Funktion ;)