WebSphere Application Server konfigurieren

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.

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, vom Jazz-Team-Server werden die Benutzersätze jedoch mit Benutzer-IDs und unter Beachtung der beim Import verwendeten Groß-/Kleinschreibung gespeichert. Wenn Sie sich am Jazz-Team-Server anmelden, wird der Benutzersatz aus der Liste der Benutzer abgefragt 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 des Jazz-Team-Servers fehl.
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 'JazzInstallDir' bezeichnet. Verwenden Sie in diesem Verzeichnis Folgendes:
- Die Datei 'JazzInstallDir/server/teamserver.properties'.
- Die Datei 'JazzInstallDir/server/log4j.properties'. Wenn Sie WebSphere Application Server verwenden, können Sie in dieser Datei den Pfad für die Datei 'jazz.log' ändern, in der nur Nachrichten vom Jazz-Team-Server protokolliert werden. Der Standardpfad lautet 'tomcat/logs/jazz.log'.
- Die Datei 'JazzInstallDir/server/tomcat/webapps/jazz.war'.
- Das Verzeichnis 'JazzInstallDir/server/provision_profiles'.
- Das Verzeichnis 'JazzInstallDir/server/update-site'.
- Die Standard-Repository-Datenbank in 'JazzInstallDir/repositoryDB'.
- Die Repository-Tools in 'JazzInstallDir/repotools'.

Tipp: Wenn IBM Installation Manager verwendet wird, können die Dateien vom Jazz-Team-Server 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 'JazzInstallDir'. 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.

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.

Ändern Sie die Dateien 'profile.ini' und 'license-profile.ini':
Bearbeiten Sie jedes Profil in 'JazzInstallDir/server/provision_profiles/' und stellen Sie für die URL-Eigenschaft einen absoluten Pfad ein.
Beispiel:
- Ändern Sie die folgende Zeile:
```
url=file:./update-site
```
- In ungefähr die folgende Zeile:
```
url=file:/opt/IBM/JazzTeamServer/server/update-site
```
Anmerkung: Das Verzeichnis 'JazzInstallDir/server/provision_profiles/' darf nur die eingeschlossenen '.ini'-Dateien enthalten und darf keine Sicherungsdateien enthalten. Von manchen Editoren werden automatisch Sicherungsdateien gespeichert, die entfernt werden müssen.

Ü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:fullyMaterializeLobData=false;user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin

Überprüfen oder aktualisieren Sie die Version von WebSphere Application Server.
Für den Jazz-Team-Server ist WebSphere Application Server 6.1 mit IBM Java SDK 1.5 SR5 oder einem späteren kumulativem Fix 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.
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.

Zunächst muss festgelegt werden, an welcher Position sich die Konfigurationsdateien für den Server und für 'log4j' (dem vom Server verwendeten Protokollierungsframework) befinden. Hierzu werden die Systemeigenschaften 'com.ibm.team.server.configURL' und 'log4j.configuration' eingestellt. Da von diesen Eigenschaften 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 der Jazz-Team-Server 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 Jazz-Team-Server-Prozess bereitgestellt wird.

Wenn Sie eine Verbindung zu einer Oracle-Datenbank herstellen, müssen Sie die Eigenschaft 'ORACLE_JDBC' hinzufügen. Stellen Sie für die Eigenschaft den absoluten Dateipfad (nicht eine URL) zu den Oracle-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 'JazzInstallDir' durch das Installationsverzeichnis für den Jazz-Team-Server:
1. Klicken Sie auf Server > Anwendungsserver.
2. Klicken Sie auf server1.
3. Klicken Sie auf Java- und Prozessverwaltung > Prozessdefinition.
4. Klicken Sie auf Java Virtual Machine.
5. Fügen Sie den Wert 100 für Größe des Heapspeichers hinzu.
6. Geben Sie für Maximale Größe des Heapspeichers den Wert 1000 an.
7. Klicken Sie auf Anwenden.
8. 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 auf schwerwiegend für die org.eclipse.birt.*-Pakete. Klicken Sie auf Anwenden.
9. Klicken Sie auf Angepasste Eigenschaften.
10. 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: 'com.ibm.team.repository.provision.profile' Wert: 'file:///JazzInstallDir/server/provision_profiles' (als Datei-URL)
    Anmerkung: Die Eigenschaft 'com.ibm.team.repository.provision.profile' muss auf das Verzeichnis 'provision_profiles' verweisen.
  - Name: 'com.ibm.team.server.configURL' Wert: 'file:///JazzInstallDir/server/teamserver.properties' (als Datei-URL)
  - Name: 'log4j.configuration' Wert: 'file:///JazzInstallDir/server/log4j.properties' (als Datei-URL)
  - Name: 'java.awt.headless' Wert: 'true'
  - Name: 'org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin' Wert: 'true'
11. 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 'WASInstallDir' für die Position, an der WebSphere Application Server auf dem Server installiert ist.
- Unter Windows ist der Standardwert für das WebSphere-Installationsverzeichnis:
```
c:\Programme\IBM\WebSphere\AppServer
```
  Mithilfe der folgenden Befehle können Sie den Server unter Windows erneut starten:
```
cd WASInstallDir\bin 
stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
startServer.bat server1
```
- Unter Linux ist der Standardwert für das WebSphere-Installationsverzeichnis:
```
/opt/IBM/WebSphere/AppServer
```
  Mithilfe der folgenden Befehle können Sie den Server unter Linux erneut starten:
```
cd WASInstallDir/bin 
./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
./startServer.sh server1
```
1. Öffnen Sie die Administrationskonsole für WebSphere Application Server.
2. Klicken Sie auf Anwendungen > Neue Anwendung installieren.
3. Klicken Sie unter Pfad zur neuen Anwendung auf 'Lokales Dateisystem'.
4. Geben Sie unter Vollständiger Pfad Folgendes ein:
```
JazzInstallDir/server/jazz.war
```
5. Stellen Sie unter Kontextstammverzeichnis den Wert '/jazz' ein.
6. Klicken sie auf Weiter und fahren Sie mit den restlichen Schritten von Neue Anwendung installieren fort.
7. Klicken Sie auf Fertig stellen.
8. Klicken Sie auf Speichern, um die Masterkonfiguration direkt zu speichern.
9. Klicken Sie auf Anwendungen > Unternehmensanwendungen.
10. 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.

Wenn der Server gestartet ist, fahren Sie mit Installationsassistenten ausführen fort.