WebSphere Application Server konfigurieren

Vor der Implementierung von WAR-Dateien der CLM-Anwendungen müssen Sie Ihren WebSphere Application Server einrichten.

Vorbereitende Schritte

Stellen Sie sicher, dass die folgenden Aufgaben ausgeführt wurden:

Für die Jazz-Webschnittstelle ist es erforderlich, dass die Authentifizierung konfiguriert werden kann, damit eine Autorisierung durchgeführt und die Anwendung angepasst werden kann.

Informationen zu diesem Vorgang

Dieses Dokument enthält keine Details zur Konfiguration der WebSphere-Authentifizierung oder von Secure Sockets Layer (SSL), da dies ein komplexes Thema ist. Ausführliche Informationen zu den verschiedenen Authentifizierungs- und Verschlüsselungsoptionen finden Sie im WebSphere Application Server Information Center. Rufen Sie für weitere Informationen das WebSphere Information Center auf und verwenden Sie Anwendungen und ihre Umgebung sichern als Suchbegriff.

Vorgehensweise

  1. Überprüfen oder aktualisieren Sie die Version von WebSphere Application Server. Eine Liste der unterstützten Versionen und Fixpacks finden Sie auf der Seite Detailed System Requirements.
  2. Für Jazz Team Server sind mehrere bestimmte Einstellungen in der Java Virtual Machine erforderlich, in der der Server ausgeführt wird. Klicken Sie in der WebSphere Integrated Solutions Console auf Server > Servertypen > WebSphere-Anwendungsserver > Server1, um diese Einstellungen festzulegen.
  3. Klicken Sie unter 'Serverinfrastruktur' auf Java- und Prozessverwaltung > Prozessdefinition.
  4. Klicken Sie unter 'Weitere Eigenschaften' auf Java Virtual Machine.
  5. Geben Sie als Anfangsgröße des Heap-Speichers den Wert 4096 ein.
  6. Geben Sie als Maximale Größe des Heap-Speichers den Wert 4096 ein.
    Tipp: Diese Zahl ist nur ein Vorschlag. Sie müssen den Wert entsprechend Ihrer Umgebung setzen. Für ein normales, mittelgroßes Team kann der Wert '4096 MB' verwendet werden, durch den auf einem 64-Bit-Computer ein Heap-Speicher von 4 GB für den Prozess von Jazz Team Server bereitgestellt wird. Es ist wichtig, dass Sie für die Anfangsgröße und die maximale Größe des Heap-Speichers denselben Wert angeben.

    Außerdem ist es wichtig, dass mehr physischer Hauptspeicher verfügbar ist, als alle Prozesse der Maschine zusammen benötigen, damit Seitenwechsel und Auslagerungen vermieden werden. Seitenwechsel verringern die Leistung des Systems und wirken sich nachteilig auf das Java-Speicherverwaltungssystem aus.

    Vergewissern Sie sich beim Vergrößern des Java-Heap-Speichers, dass auf der Maschine genug ungenutzter physischer Hauptspeicher verfügbar ist. Sollte kein ausreichender physischer Hauptspeicher zur Verfügung stehen, installieren Sie zusätzlichen Speicher oder stellen Sie sich auf die Beeinträchtigung der Gesamtleistung ein.

  7. Geben Sie im Feld Generische JVM-Argumente die folgende Zeile ein:
    For AIX operating system
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xnocompressedrefs
    For Solaris operating system
    -Xmx4g -Xms4g -Xmn512m
    -XX:MaxPermSize=768M -XX:ReservedCodeCacheSize=512M -XX:CodeCacheMinimumFreeSpace=2M
    Anmerkung: Mac OS X wird nicht unterstützt.
    -Xmx4g -Xms4g -Xmn512m
    -XX:MaxPermSize=768M -XX:ReservedCodeCacheSize=512M -XX:CodeCacheMinimumFreeSpace=2M
    For Windows operating system
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    For Linux operating system
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Tipp: Falls Sie einen größeren Heap-Speicher benötigen, können Sie die folgende Einstellung verwenden. Ersetzen Sie dabei {N} durch die gewünschte Speicherkapazität und {N/8} durch 1/8 des Gesamtspeichers. Wenn -Xmx beispielsweise auf 8g gesetzt ist, sollte -Xmn auf 1g gesetzt sein.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  8. Klicken Sie auf Anwenden und dann auf Speichern, um die Masterkonfiguration direkt zu speichern.
  9. Zu den angepassten Eigenschaften, die Sie hinzufügen müssen, gehört JAZZ_HOME. Diese Systemeigenschaft gibt an, wo sich bestimmte Konfigurationsdateien befinden. Da von dieser Eigenschaft ein URL und nicht ein einfacher Pfad verwendet wird, geben Sie den Wert als URL mit dem Format file:///Dateipfad an. Klicken Sie unter Java Virtual Machine > Weitere Eigenschaften auf Angepasste Eigenschaften.
    Hinweis: Nach file: müssen Sie drei Schrägstriche (///) angeben.
    Wichtig: Wenn Sie in einer dezentralen Umgebung für jede Webanwendung einen gesonderten Anwendungsserver verwenden, müssen Sie diese angepassten Eigenschaften zu jeder Instanz von WebSphere Application Server hinzufügen.
  10. Klicken Sie auf Neu und geben Sie im Feld Name JAZZ_HOME und im Feld Wert file:///Jazz-Installationsverzeichnis/server/conf ein. Ersetzen Sie Jazz-Installationsverzeichnis durch die Position des Installationsverzeichnisses für Jazz Team Server. Geben Sie beispielsweise file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf unter Windows und file:///home/Benutzer/IBM/JazzTeamServer/server/conf auf UNIX-Systemen ein.
    Anmerkung: Vermeiden Sie Probleme, indem Sie in Dateipfaden keine Leerzeichen verwenden. Für das Verzeichnis Program Files können Sie PROGRA~1 verwenden und für das Verzeichnis Program Files (x86) PROGRA~2.
  11. Klicken Sie auf OK.
  12. Wiederholen Sie Schritt 10 und fügen Sie folgende angepasste Eigenschaften hinzu:
    • Name: java.awt.headless Wert: true
    • Name: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Wert: true
    • Falls Sie eine Verbindung zu einer Oracle-Datenbank herstellen: Name: ORACLE_JDBC_DRIVER_FILE Wert: Pfad zum JDBC-Treiber/ojdbc6.jar
      Anmerkung: Bei dem Pfad muss es sich um einen absoluten Pfad handeln. Verwenden Sie keinen URL-Pfad (file:///). Weitere Informationen zu Oracle-JDBC-Verbindungen (Java Database Connectivity) enthält der Abschnitt Konfiguration, Oracle-Datenbank.
    • Falls Sie eine Verbindung zu einer SQL-Server-Datenbank herstellen: Name: SQLSERVER_JDBC_DRIVER_FILE Wert: Pfad zum JDBC-Treiber/sqljdbc4.jar
      Anmerkung: Bei dem Pfad muss es sich um einen absoluten Pfad handeln. Verwenden Sie keinen URL-Pfad (file:///). Weitere Informationen zu SQL-Server-JDBC-Verbindungen enthält der Abschnitt SQL-Server-Datenbank konfigurieren.
    • Name: log4j.configuration Wert: file:///Jazz-Installationsverzeichnis/server/conf/startup_log4j.properties
      Anmerkung: Die in der Datei startup_log4j.properties enthaltenen Einstellungen werden in den frühen Phasen des Startprozesses verwendet, um Nachrichten an die Datei SystemOut.log von WebSphere Application Server zu übergeben. Nach diesen frühen Phasen schalten alle Jazz-Anwendungen auf die anwendungsspezifischen Einstellungen in der Datei Jazz-Installationsverzeichnis/server/conf/Anwendungskontext/log4j.properties um.
  13. Wählen Sie Speichern aus, um die Masterkonfiguration direkt zu speichern.
  14. Starten Sie den Anwendungsserver neu, damit die Änderungen wirksam werden.

Feedback