In diesem Abschnitt wird beschrieben, wie Sie Jazz Team Server für WebSphere Application Server konfigurieren. Für diese Konfiguration wird vorausgesetzt, dass der Jazz Team Server auf demselben System installiert wird, auf dem sich auch Websphere Application Server befindet.
Vorbereitende Schritte
Vor der Ausführung dieser Schritte müssen folgende Voraussetzungen erfüllt sein:
- WebSphere Application Server wurde bereits installiert.
- Die Datenbank wurde erstellt und die Datei teamserver.properties wurde mit Ihren Datenbankeinstellungen aktualisiert.
- Anmeldung unter Mißachtung der Groß-/Kleinschreibung aktivieren (optional): Wenn im Rahmen der für den Anwendungsserver verwendeten Authentifizierungsmethode eine Anmeldung unter Mißachtung der Groß-/Kleinschreibung zulässig ist, können Sie diese Art der Anmeldung für die Jazz-Anwendung übernehmen. Sie können die Anmeldung unter Mißachtung der Groß-/Kleinschreibung über die Eigenschaft "Use case insensitive user ID matching" auf der Seite mit den erweiterten Eigenschaften der Webbenutzerschnittstelle für die Verwaltung aktivieren. Der Standardwert ist nicht geändert worden. Administratoren müssen diese Eigenschaft explizit überschreiben, um die Anmeldung unter Mißachtung der Groß-/Kleinschreibung zu aktivieren.
- Java™ 2-Sicherheitsoption muss inaktiviert sein. Ist diese Option in WebSphere Application Server aktiviert, wird dadurch ein korrekter Start der .war-Datei von Jazz Team Server verhindert.
- Stellen Sie sicher, dass die WAS-Sicherheitseinstellung "Use available authentication
data when an unprotected URI is accessed" aktiviert ist. Wenn Sie die WAS Integrated Solutions Console verwenden, können Sie das wie folgt bewerkstelligen:
- Durch Navigieren nach Security -> Secure administration, applications, and infrastructure -> Web Security - General Settings.
- Durch Auswählen des Kontrollkästchens für "Use available authentication data when an unprotected URI is accessed".
- Zu Jazz Team Server gehören die Dateien, die zum Ausführen eines kompletten Apache Tomcat-basierten Servers erforderlich sind. Für eine WebSphere-Installation werden nur einige der Jazz Team Server-Dateien benötigt. Diese Dateien müssen in einem Verzeichnis auf Ihrer WebSphere-Servermaschine platziert werden. In den folgenden Anweisungen wird dieses Verzeichnis als Jazz Team Server-Installationsverzeichnis oder kurz als jazz-installationsverzeichnis bezeichnet. Ausgehend von diesem Verzeichnis verwenden Sie:
- Die Datei jazz-installationsverzeichnis/server/tomcat/webapps/jazz.war
- Das Verzeichnis jazz-installationsverzeichnis/server/update-site
- Das Verzeichnis jazz-installationsverzeichnis/server/conf
- Die Standard-Repository-Datenbank in jazz-installationsverzeichnis/repositoryDB
- Die Repository-Tools in jazz-installationsverzeichnis/repotools
- Das Verzeichnis jazz-installationsverzeichnisserver/license-update-site
- Das Verzeichnis jazz-installationsverzeichnis/server/nl1-update-site
- Das Verzeichnis jazz-installationsverzeichnis/server/nl2-update-site
Tipp: Bei Verwendung von IBM® Installation Manager können die Jazz Team Server-Dateien in einem Webanwendungsverzeichnis installiert werden. Vermeiden Sie es, während des Installationsprozesses den dazugehörigen Apache Tomcat-Anwendungsserver zu installieren. Dadurch wird Installation Manager dazu veranlasst, nach einem Webanwendungverzeichnis zu fragen und nur die für WebSphere erforderlichen Dateien zu installieren. Unter Windows® lautet das Standardverzeichnis C:\Program Files\IBM\JazzTeamServer und unter Linux® /opt/IBM/JazzTeamServer. Das Installationsverzeichnis lautet in diesem Verfahren jazz-installationsverzeichnis. Wenn Sie die Dateien mit IBM Installation Manager im Webanwendungsverzeichnis von WebSphere Application Server installieren, müssen Sie sie nicht (wie oben beschrieben) manuell verlegen.
Informationen zu diesem Vorgang
Anmerkung: In diesem Dokument wird nicht die Konfiguration für die WebSphere-Authentifizierung oder SSL besprochen. Dies ist ein sehr komplexes Thema. Ausführliche Informationen zu den verschiedenen Authentifizierungs- und Verschlüsselungsoptionen für WebSphere finden Sie im WebSphere Information Center. Um weitere Informationen zu erhalten, rufen Sie das
WebSphere Information Center auf und suchen Sie nach dem Thema
Anwendungen und ihre Umgebung sichern. Für die Jazz-Webbenutzerschnittstelle ist es erforderlich, eine Authentifizierung zu konfigurieren, um Autorisierungen vornehmen und die Anwendung individuell gestalten zu können.
Vorgehensweise
- Überprüfen und aktualisieren Sie die Speicherposition der Datenbank in der Datei teamserver.properties.
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
Anmerkung: Dies ist eine Muster-DB2-Konfiguration. Je nach Datenbankanbieter (Oracle/MS-SQL) muss die Datei teamserver.properties aktualisiert werden.
- Überprüfen oder aktualisieren Sie die WebSphere Application
Server-Version.
Jazz Team Server erfordert WebSphere Application Server Version 6.1 mit IBM Java SDK
1.5 SR5 oder höher mit kumulativem Fix oder WebSphere Application
Server Version 7.0 (mindestens Version 7.0.0.7). Das Update für IBM Java SDK 1.5 SR6 SDK ist verfügbar unter http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Mit WebSphere 6.1
und dem GA IBM Java SDK gibt Jazz nach einigen Vorgängen "Proxyfehler" aus.
Sie müssen die entsprechenden WebSphere Application
Server-i-fixes für Programmkorrekturen für IBM Java SDK
1.5 SR9 oder IBM Java SDK
1.6 SR4 anwenden. Diese sind Voraussetzung dafür, dass IBM Rational Team Concert 2.0 fehlerfrei läuft. Andernfalls werden einige Services auf dem Server möglicherweise nicht ordnungsgemäß gestartet. Die i-fixes sind in den jeweiligen WebSphere Application Server-APARs verfügbar. Für IBM Java SDK 1.5/WebSphere Application
Server 6.1 lautet der APAR PK85942. Sie können die Dateien von ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ herunterladen. Installieren Sie mindestens WebSphere Application Server 6.1 Fixpack 19, bevor Sie den JRE i-fix installieren. Für IBM Java SDK 1.6/WebSphere Application
Server 7.0 lautet der APAR PK 86771. Sie können die Dateien von ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ herunterladen.
- Aktualisieren Sie die JVM-Argumente.
Für Jazz Team Server werden auf der Java Virtual
Machine, auf der das Programm ausgeführt wird, einige spezielle Einstellungen benötigt.
Die erste Eigenschaft, die bei den generischen JVM-Argumenten definiert werden muss, ist die Zuordnung der standardmäßigen maximalen Speicherkapazität über die Einstellung -Xmx. Dabei sind die Größe des vom Server unterstützten Teams sowie die Speicherkapazität des Servers zu berücksichtigen, auf dem Jazz Team Server ausgeführt wird. Für ein typisches mittelgroßes Team wird gewöhnlich der Wert -Xmx1536M verwendet, über den 1.536 MB Heapspeicher für den Jazz Team Server-Prozess bereitgestellt werden.
Eine zweite Eigenschaft, die (speziell für Rational Quality Manager) bei den generischen JVM-Argumenten definiert werden muss, ist die Thread-Stack-Größe. Eine typische Stackgröße für Rational Quality Manager lautet -Xss786K.
Wenn Sie eine Verbindung zu einer Oracle- oder SQL Server-Datenbank herstellen, müssen Sie eine Eigenschaft mit Namen "ORACLE_JDBC" bzw. "SQLSERVER_JDBC" hinzufügen. Geben Sie für die Eigenschaft den absoluten Dateipfad (keine URL) zu den entsprechenden JDBC-Treibern an.
Die folgenden Beispiele zeigen die generischen JVM-Argumente für die Verbindungen mit Oracle- und SQL Server-Datenbanken. Gezeigt werden außerdem die Werte für die Zuordnung der standardmäßigen maximalen Speicherkapazität sowie die Thread-Stack-Größe. Tragen Sie für jazz-installationsverzeichnis Ihr Jazz Team Server-Installationsverzeichnis ein.
-DORACLE_JDBC=jazz-installationsverzeichnis\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=jazz-installationsverzeichnis\server\sqlserver -Xmx1536M -Xss768k
Es gibt noch zahlreiche andere Systemeigenschaften, die zum Steuern bestimmter Serververhalten definiert werden müssen. Diese werden unten eingefügt. Es folgen nun die beim Definieren dieser JVM-Eigenschaften über die WebSphere-Administrationskonsole zu berücksichtigenden Spezifikationen. Tragen Sie für jazz-installationsverzeichnis Ihr Jazz Team Server-Installationsverzeichnis ein:
- Klicken Sie auf .
- Klicken Sie auf server1.
- Klicken Sie auf .
- Klicken Sie auf Java Virtual Machine.
- Fügen Sie bei Initial Heap den Wert 100 ein.
- Fügen Sie bei Maximum Heap Size den Wert 1000 ein.
- Klicken Sie auf Apply.
- Klicken Sie auf Logging and Tracing. Klicken Sie auf Change Log Detail Levels. Der Jazz Team Server verwendet die BIRT-Berichtsengine. Möchten Sie verhindern, dass BIRT-Informationseinträge in die WebSphere-Protokolldatei geschrieben werden, geben Sie für die org.eclipse.birt.*-Pakete für die Protokollierungsstufe den Wert severe an. Klicken Sie auf Apply.
- Klicken Sie auf Custom Properties. Eine der benutzerdefinierten Eigenschaften, die Sie hinzufügen müssen, ist JAZZ_HOME. Dabei handelt es sich um eine Systemeigenschaft, über die angegeben wird, wo bestimmte Konfigurationsdateien zu finden sind. Diese Eigenschaft arbeitet mit einer URL statt einem einfachen Pfad, sodass der Wert als Datei angegeben werden muss: //-style URL.
- Fügen Sie die folgenden Eigenschaften hinzu: Klicken Sie auf New. Geben Sie Werte für Name und Value ein und klicken Sie auf OK.
- Name: java.awt.headless Value:
true
- Name: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Value:
true
- Name: JAZZ_HOME Value: file:///jazz-installationsverzeichnis/server/conf
- Klicken Sie für die Hauptkonfiguration direkt auf Save.
- Führen Sie zum Installieren der Jazz-Anwendung einen Neustart für Websphere durch.
In den folgenden Befehlszeilenbeispielen steht
was-installationsverzeichnis für die Position, an der WebSphere Application Server auf Ihrem Server installiert ist.
- Rufen Sie die Administrationskonsole für Ihren WebSphere Application Server auf.
- Klicken Sie auf .
- Klicken Sie unter Path to new Application auf das lokale Dateisystem.
- Nehmen Sie bei Full path folgende Eingabe vor:
jazz-installationsverzeichnis/server/jazz.war
- Geben Sie bei Context Root den Wert /jazz ein.
- Klicken Sie auf Next und fahren Sie mit den verbleibenden Schritten unter Install New Application fort.
- Klicken Sie auf Finish.
- Klicken Sie für die Hauptkonfiguration direkt auf Save.
- Klicken Sie auf .
- Wählen Sie das Feld neben jazz_war aus und klicken Sie auf Start.
Es sollte ein grüner Pfeil angezeigt werden, durch den darauf hingewiesen wird, dass die Anwendung erfolgreich gestartet wurde.
Nächste Schritte
Wenn Sie Benutzer von
Rational Team Concert sind, fahren Sie mit dem Abschnitt
Installationsassistenten ausführen fort. Für
Rational Quality Manager informieren Sie sich in dem Abschnitt, in dem erklärt wird, wie Sie den "Assistenten zum Einrichten des Jazz Team Servers ausführen" können.
Weitere Informationen zu diesem Thema finden Sie über die folgenden Links:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ