In diesem Abschnitt wird beschrieben, wie der Jazz-Team-Server für die Arbeit mit WebSphere Application Server konfiguriert wird. Für diese Konfiguration ist Voraussetzung, dass der Jazz-Team-Server auf derselben Maschine wie WebSphere Application Server konfiguriert wird. Die Anweisungen basieren auf
der WebSphere Application
Server-Version 6.1.0.23. Für Version 7.0.0.7
und höher gibt es geringfügige Abweichungen. Darauf wird gegebenenfalls im Text hingewiesen.
Vorbereitende Schritte
Stellen Sie vor der Ausführung dieser Schritte sicher, dass die folgenden Punkte durchgeführt wurden:
- WebSphere Application Server ist bereits installiert.
- Die Datenbank wurde erstellt und die Datei 'teamserver.properties' wurde mithilfe Ihrer Datenbankeinstellungen aktualisiert.
- Aktivieren der Anmeldung, bei der Groß-/Kleinschreibung nicht beachtet werden muss (optional): Wenn die Authentifizierungsmethode des Servers eine Anmeldung ermöglicht, bei der die Groß-/Kleinschreibung nicht beachtet werden muss, ist es möglich, dass die Jazz-Anwendung dies ebenfalls akzeptiert. Die Anmeldung, bei der die Groß-/Kleinschreibung nicht beachtet werden muss, kann auf der Seite Erweiterte Eigenschaften der Webbenutzerschnittstelle für Verwaltung über die Eigenschaft "Abgleich von Benutzer-IDs ohne Berücksichtigung von Groß-/Kleinschreibung durchführen" aktiviert werden. Die Standardeinstellung wird nicht geändert; Administratoren müssen diese Eigenschaft explizit außer Kraft setzen, um eine Anmeldung zu aktivieren, bei der die Groß-/Kleinschreibung nicht beachtet werden muss.
- Die Java™ 2-Sicherheitsoption muss inaktiviert sein. Wenn diese Option in WebSphere Application Server aktiviert ist, schlägt der Start der WAR-Datei von Jazz-Team-Server fehl.
- Stellen Sie sicher, dass die WAS-Sicherheitseinstellung 'Verfügbare Authentifizierungsdaten beim Zugriff auf einen ungeschützten URI verwenden' ausgewählt ist. Wenn Sie die WAS Integrated Solutions Console verwenden, können hierzu wie folgt vorgehen:
- Navigieren Sie zu 'Sicherheit' -> 'Sichere Verwaltung, Anwendungen und Infrastruktur' -> 'Websicherheit - Allgemeine Einstellungen'. (Navigieren Sie unter WAS 7.0.0.7 zu 'Sicherheit' -> 'Globale Sicherheit' -> 'Web- und SIP-Sicherheit' ->
'Allgemeine Einstellungen'.)
- Wählen Sie das Markierungsfeld für 'Verfügbare Authentifizierungsdaten beim Zugriff auf einen ungeschützten URI verwenden' aus.
- Im Lieferumfang des Jazz-Team-Servers sind die Dateien zur Ausführung eines vollständigen Apache Tomcat-basierten Servers enthalten. Für eine WebSphere-Installation ist nur eine Teilmenge der Dateien des Jazz-Team-Servers erforderlich; diese Dateien müssen Sie in ein Verzeichnis auf der WebSphere-Servermaschine stellen. In anderen Anweisungen wird dieses Verzeichnis als Installationsverzeichnis des Jazz-Team-Servers oder als 'jazz-installationsverzeichnis' bezeichnet. Verwenden Sie in diesem Verzeichnis Folgendes:
- 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: Wenn IBM® Installation
Manager zur Installation von Jazz-Team-Server für die Verwendung mit Rational Team Concert verwendet wird,
können die Jazz-Team-Server-Dateien
in einem Webanwendungsverzeichnis installiert werden. Während des Installationsprozesses dürfen Sie nicht den im Lieferumfang enthaltenen Apache Tomcat-Anwendungsserver installieren, da Sie in diesem Fall von Installation Manager aufgefordert werden, ein Webanwendungsverzeichnis anzugeben und von Installation Manager nur die für WebSphere erforderlichen Dateien installiert werden.
Das Standardverzeichnis lautet unter Windows® 'c:\Programme\IBM\JazzTeamServer' und unter Linux® '/opt/IBM/JazzTeamServer'.
Das Installationsverzeichnis in dieser Prozedur lautet 'jazz-installationsverzeichnis'. Wenn Sie IBM Installation Manager für die Installation der Dateien im Webanwendungsverzeichnis von WebSphere Application Server verwenden, müssen Sie die Dateien nicht wie oben beschrieben manuell verschieben.
Informationen zu diesem Vorgang
Anmerkung: In diesem Dokument wird nicht die Konfiguration der WebSphere-Authentifizierung oder von Secure Sockets Layer (SSL) erläutert, da dies ein komplexes Thema ist. Ausführliche Informationen zu den verschiedenen Authentifizierungs- und Verschlüsselungsoptionen für WebSphere finden Sie im WebSphere Information Center. Rufen Sie für weitere Informationen die Adresse
des WebSphere Information Center auf und suchen Sie nach
Anwendungen und ihre Umgebung sichern.
Für die Jazz-Webbenutzerschnittstelle ist es erforderlich, dass die Authentifizierung konfiguriert werden kann, damit eine Autorisierung durchgeführt werden und Anwendung angepasst werden kann.
Vorgehensweise
- Überprüfen und aktualisieren Sie die Datenbankposition 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 DB2-Beispielkonfiguration. Die Datei 'teamserver.properties' muss abhängig vom jeweiligen Datenbankanbieter (Oracle/MS-SQL) aktualisiert werden.
- Überprüfen oder aktualisieren Sie die Version von WebSphere Application Server.
Für den Jazz-Team-Server ist WebSphere Application Server Version 6.1 mit IBM Java SDK 1.5 SR5 oder einem späteren kumulativen Fix oder WebSphere Application Server Version 7.0 mit Version 7.0.0.7 oder aktueller erforderlich. Die Aktualisierung IBM Java SDK
1.5 SR6 SDK ist unter http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 verfügbar. Wenn WebSphere 6.1 und das allgemein verfügbare IBM Java SDK verwendet werden, werden von Jazz nach manchen Operationen 'Proxyfehler' gemeldet.
Sie müssen die entsprechenden i-Fixes von WebSphere Application Server für Korrekturen an IBM Java SDK 1.5 SR9 oder IBM Java SDK 1.6 SR4 beziehen, die für die ordnungsgemäße Ausführung von IBM Rational Team Concert erforderlich sind. Andernfalls kann es vorkommen, dass manche Services auf dem Server nicht ordnungsgemäß gestartet werden. Die i-fixes sind unter den entsprechenden WebSphere Application Server APAR-Nummern zu beziehen. Der APAR für IBM Java SDK 1.5/WebSphere Application Server 6.1 trägt die Bezeichnung PK85942; Sie können die Datein 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 das JRE i-fix installieren. Der APAR für IBM Java SDK 1.6/WebSphere Application Server 7.0 trägt die Bezeichnung 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 den Jazz-Team-Server sind mehrere besondere Einstellungen in derJava Virtual Machine erforderlich, in der die Ausführung erfolgt.
Die erste Eigenschaft, die
in den generischen JVM-Argumenten eingestellt werden muss, ist der Standardwert für die maximale Hauptspeicherzuordnung mithilfe der Einstellung '-Xmx'. Grundlage für die Einstellung dieses Werts sind das Team, das vom Server unterstützt wird und die Hauptspeicherkapazität des Servers, auf dem der Jazz-Team-Server ausgeführt wird. Für ein normales, mittelgroßes Team kann der Wert '-Xmx1536M' verwendet werden, durch den ein Heapspeicher von 1536 MB für den Jazz-Team-Server-Prozess bereitgestellt wird.
Eine zweite Eigenschaft, die
in den generischen JVM-Argumenten speziell für Rational Quality Manager eingestellt werden muss, ist die Größe des Thread-Stacks. Eine typische Stackgröße für Rational Quality Manager ist
-Xss786K.
Wenn Sie eine Verbindung zu einer Oracle- oder SQL Server-Datenbank herstellen, müssen Sie die Eigenschaft 'ORACLE_JDBC' bzw. 'SQLSERVER_JDBC' hinzufügen. Stellen Sie für die Eigenschaft den absoluten Dateipfad (nicht eine URL) zu den passenden JDBC-Treibern ein.
In den folgenden Beispielen werden die generischen JVM-Argumente
für die Herstellung von Verbindungen zu Oracle- und SQL Server-Datenbanken sowie die maximale Hauptspeicherzuordnung und die Größe des Thread-Stacks gezeigt. Ersetzen Sie jazz-installationsverzeichnis durch
das Jazz-Team-Server-Installationsverzeichnis.
-DORACLE_JDBC=jazz-installationsverzeichnis\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=jazz-installationsverzeichnis\server\sqlserver -Xmx1536M -Xss768k
Es gibt noch weitere Systemeigenschaften, die zur Steuerung bestimmter Serververhalten eingestellt werden müssen. Diese werden unten genannt. Im Folgenden werden die Besonderheiten bei der Einstellung dieser
JVM-Eigenschaften in der WebSphere-Administrationskonsole beschrieben. Ersetzen Sie jazz-installationsverzeichnis durch
das Jazz-Team-Server-Installationsverzeichnis:
- Klicken Sie auf .
- Klicken Sie auf server1.
- Klicken Sie auf .
- Klicken Sie auf Java Virtual Machine.
- Fügen Sie den Wert 100 für Größe des Heapspeichers hinzu.
- Geben Sie für Maximale Größe des Heapspeichers den Wert 1000 an.
- Klicken Sie auf Anwenden.
- Klicken Sie auf Protokollierung und Tracing. Klicken Sie auf Protokolldetailstufen
ändern. Jazz-Team-Server verwendet
die BIRT-Reporting-Engine. Um zu vermeiden, dass BIRT-Informationseinträge
in die WebSphere-Protokolldatei geschrieben werden, setzen Sie die Protokollstufe für die
org.eclipse.birt.*-Pakete auf
schwerwiegend. Klicken Sie auf Anwenden.
- Klicken Sie auf Anwendungsserver > {servername} > Prozessdefinition > Java Virtual Machine
> Benutzerdefinierte Eigenschaften. Eine der benutzerdefinierten Eigenschaften, die Sie hinzufügen müssen, ist
JAZZ_HOME. Diese Systemeigenschaft gibt an, wo sich bestimmte Konfigurationsdateien befinden. Da von dieser Eigenschaft eine URL und nicht ein einfacher Pfad verwendet wird, muss der Wert als URL mit dem Format 'datei://-style' angegeben werden.
- Fügen Sie die folgenden Eigenschaften hinzu: Klicken Sie auf Neu, geben Sie einen Namen und einen Wert ein und klicken Sie anschließend auf 'OK'.
- Name: 'java.awt.headless' Wert: 'true'
- Name: 'org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin' Wert: 'true'
- Name: JAZZ_HOME Wert: file:///jazz-installationsverzeichnis/server/conf
- Klicken Sie auf Sichern, um die Masterkonfiguration direkt zu speichern.
- Starten Sie WebSphere erneut, um die Anwendung Jazz zu installieren.
In den folgenden Befehlszeilenbeispielen steht '
was-installationsverzeichnis' für die Position, an der WebSphere Application Server auf dem Server installiert ist.
- Öffnen Sie die Administrationskonsole für WebSphere Application Server.
- Klicken Sie auf . (Für WebSphere Application Server
7.0.0.7 und höher klicken Sie auf .)
- Klicken Sie unter Pfad zur neuen Anwendung auf 'Lokales Dateisystem'.
- Geben Sie unter Vollständiger Pfad Folgendes ein:
jazz-installationsverzeichnis/server/tomcat/webapps/jazz.war
- Legen Sie Kontextstammverzeichnis auf '/jazz' fest und
klicken Sie anschließend auf Weiter.
Anmerkung: Dieser Schritt
steht fast am Ende der Installation in WebSphere Application Server 7.0.0.7 und
höher.
- Klicken Sie auf Weiter und fahren Sie mit den restlichen Schritten von Neue Anwendung installieren fort.
- Klicken Sie auf Fertig stellen.
- Prüfen Sie, ob die Anwendung 'jazz_war' installiert wurde, und klicken Sie dann auf Sichern, um die Änderungen direkt in der Hauptkonfigurationsdatei zu speichern.
- Klicken Sie auf .
- Wählen Sie das Kästchen neben 'jazz_war' aus und klicken Sie auf Starten.
Jetzt müsste ein grüner Pfeil angezeigt werden, dar angibt, dass die Anwendung erfolgreich gestartet wurde.
Anmerkung: Die restlichen Schritte betreffen nur Rational Quality Manager.
- Rufen Sie erneut die Seite Install New Application auf.
- Wechseln Sie in das Verzeichnis, in dem sich die Datei help.war auf dem lokalen Dateisystem befindet, und wählen Sie die Datei aus. Geben Sie als Kontextstammverzeichnis /help ein und klicken Sie anschließend auf Next.
Anmerkung: Die Datei help.war befindet sich im Pfad jazz-installationsverzeichnis\server\tomcat\webapps\help.war.
- Klicken Sie so oft auf Next, bis die Zusammenfassung angezeigt wird. Klicken Sie anschließend auf Finish, um die neue Anwendung zu installieren.
- Prüfen Sie, ob die Anwendung "help_war" installiert wurde, und klicken Sie dann auf Save, um die Änderungen an der Hauptkonfigurationsdatei zu sichern.
- Klicken Sie auf .
- Wählen Sie help_war aus und klicken Sie auf Start.
Nächste Schritte
Wenn Sie mit
Rational Team Concert arbeiten,
fahren Sie mit dem Abschnitt
Installationsassistenten ausführen fort. Im Falle von
Rational Quality Manager
fahren Sie mit dem Abschnitt zum Konfigurieren von LDAP in WebSphere Application Server und anschließend mit dem Abschnitt zum Ausführen des Jazz Team
Server-Konfigurationsassistenten fort.
Weitere Informationen
zu diesem Thema enthalten die folgenden Links:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ