In diesem Abschnitt wird beschrieben, wie
Jazz Team Server for System z für die Arbeit mit
WebSphere Application
Server konfiguriert wird.
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.
- Lesen Sie die WebSphere-Dokumentation zur Sicherheitskonfiguration und inaktivieren Sie die Eigenschaft für die Nichtbeachtung der Groß-/Kleinschreibung.
Anmerkung: WebSphere und
viele LDAP-Verzeichnisse lassen zwar eine Anmeldung unter Nichtbeachtung der Groß-/Kleinschreibung zu, aber Jazz Team Server for System z
speichert die Benutzersätze mit Benutzer-IDs und unter Beachtung der beim Import verwendeten Groß-/Kleinschreibung. Wenn Sie sich bei
Jazz Team Server for System z anmelden, wird der Benutzersatz aus der Liste der Benutzer abgerufen,
und die Groß-/Kleinschreibung muss exakt übereinstimmen.
- Die Option für die Java™ 2-Sicherheit muss inaktiviert sein. Wenn diese Option in WebSphere Application Server aktiviert ist, schlägt der Start der .war-Datei von
Jazz Team Server for System z fehlt.
- Stellen Sie sicher, dass die WAS-Sicherheitseinstellung 'Verfügbare Authentifizierungsdaten beim Zugriff auf eine ungeschützte URI verwenden' ausgewählt ist. Wenn Sie die WAS Integrated Solutions Console verwenden,
können Sie hierzu wie folgt vorgehen:
- Navigieren Sie zu 'Sicherheit' -> 'Sichere Verwaltung, Anwendungen und Infrastruktur' -> 'Websicherheit - Allgemeine Einstellungen'.
- Wählen Sie das Markierungsfeld für 'Verfügbare Authentifizierungsdaten beim Zugriff auf eine ungeschützte URI verwenden' aus.
- Im Lieferumfang von
Jazz Team Server for System z 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 von Jazz Team Server for System z erforderlich; diese Dateien müssen Sie in ein Verzeichnis auf der
WebSphere-Servermaschine stellen.
In den weiteren Anweisungen wird dieses Verzeichnis als Installationsverzeichnis von Jazz Team Server
for System z oder kurz 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-Installationsverzeichnis/license-update-site.
- Das Verzeichnis Jazz-Installationsverzeichnis/server/nl1-update-site.
- Das Verzeichnis Jazz-Installationsverzeichnis/server/nl2-update-site.
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.
- Ü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. Lesen Sie die Informationen in
Detailed System Requirements for the Rational Team
Concert for System z server environments.
- Aktualisieren Sie die JVM-Argumente.
Für Jazz Team Server
for System z sind
mehrere spezielle Einstellungen in der
Java Virtual
Machine erforderlich, in der das Produkt ausgeführt wird.
Zunächst muss festgelegt werden, an welcher Position sich manche Konfigurationsdateien befinden. Hierzu muss die Systemeigenschaft JAZZ_HOME eingestellt werden. 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.
Die zweite Eigenschaft, die für die Java Virtual Machine (JVM) von Jazz erforderlich ist, ist die Angabe eines höheren Werts als den 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 Jazz Team Server for System z
ausgeführt wird. Für ein normales, mittelgroßes Team kann der Wert '-Xmx1000M' verwendet werden,
durch den ein Heapspeicher von 1000 MB für den Prozess von Jazz Team Server for System z
bereitgestellt wird.
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.
Zur Steuerung des Serververhaltens müssen noch die nachfolgend erläuterten Systemeigenschaften eingestellt werden. Stellen Sie diese Eigenschaften der Java Virtual Machine (JVM) in der
WebSphere-Administrationskonsole ein und
ersetzen Sie
Jazz-Installationsverzeichnis durch das Installationsverzeichnis für
Jazz Team Server for System z:
- 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 for System z verwendet die Berichtsengine
BIRT. 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 Angepasste Eigenschaften.
- 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 Speichern, 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 .
- Klicken Sie unter Pfad zur neuen Anwendung auf 'Lokales Dateisystem'.
- Geben Sie unter Vollständiger Pfad Folgendes ein:
Jazz-Installationsverzeichnis/server/jazz.war
- Stellen Sie unter Kontextstammverzeichnis den Wert '/jazz' ein.
- Klicken Sie auf Weiter und fahren Sie mit den restlichen Schritten von Neue Anwendung installieren fort.
- Klicken Sie auf Fertig stellen.
- Klicken Sie auf Speichern, um die Masterkonfiguration direkt 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, der angibt, dass die Anwendung erfolgreich gestartet wurde.