Feinanpassung der WebSphere Application Server-Einstellungen zur Optimierung der ClearQuest Web-Serverleistung

Sie müssen die WebSphere Application Server-Einstellungen für das Anwendungsserverprofil für ClearQuest Web Server prüfen. Wenn Sie ClearQuest in einem neuen Profil installiert haben, werden die Einstellungen in dem während der Installation erstellten Profil für beste Leistung optimiert. Wenn Sie in ein vorhandenes Profil installiert haben oder wenn der Server Leistungsprobleme aufweist, müssen die Parameterwerte möglicherweise angepasst werden.

Vorbereitende Schritte

Die nachfolgend aufgeführten Ressourcen enthalten Informationen zur Angabe von Einstellungen für WebSphere Application Server-Anwendungsserverprofile:
  • Siehe Leistungsoptimierung im WebSphere Application Server Information Center, Version 8.0, Version 8.5.
  • Suchen Sie auf IBM® DeveloperWorks nach WebSphere Application Server tuning, um Artikel zur Optimierung der WebSphere Application Server-Profileinstellungen zwecks Leistungsverbesserung zu finden.

Wenn Sie ein Upgrade von Rational-Webkomponenten auf Version 8.0.1 durchführen, haben Sie die Möglichkeit, die Komponenten auf WebSphere Application Server Version 8.5.x zu implementieren. Bevor Sie die aktualisierten Rational-Webkomponenten implementieren können, müssen Sie entweder ein Upgrade für die vorhandene WebSphere Application Server-Version auf die neue Version oder auf eine separate Instanz der Version 8.5.x durchführen.

Webkomponenten von ClearCase und ClearQuest Version 8.0.1 unterstützen die Implementierung in WebSphere Application Server Version 8.0.0.x und 8.5.x. Abhängig von der installierten Rational-Produktversion und der für die Implementierung verwendeten WebSphere Application Server-Version ist bei einem Upgrade auf ClearCase CCRC WAN Server oder ClearQuest Web Server Version 8.0.1 möglicherweise die Installation einer neuen Instanz von WebSphere Application Server und IBM HTTP Server oder ein Upgrade für die vorhandene Version erforderlich.

Gehen Sie wie folgt vor, um WebSphere Application Server Version 8.5.x für die Unterstützung von ClearCase CCRC WAN Server und ClearQuest Web Server Version 8.0.1 zu installieren oder ein entsprechendes Upgrade durchzuführen:
  • Installieren Sie in folgenden Fällen eine neue Instanz von WebSphere Application Server 8.5.x:
    • Wenn Sie ein Upgrade von ClearCase oder ClearQuest Version 7.1.1.x oder Version 7.1.2.x auf Version 8.0.1 durchführen
    • Wenn Sie ein Upgrade für eine ClearCase- oder ClearQuest-Installation der Version 8.0 oder 8.0.0.1, die auf WebSphere Application Server Version 7.0.x implementiert ist, durchführen
  • Wenn Sie für eine Installation der Version 8.0.0.x, die auf WebSphere Application Server Version 8.0.0.x implementiert ist, ein Upgrade auf ClearCase oder ClearQuest Version 8.0.1 durchführen, haben Sie die Möglichkeit, ein Upgrade für die vorhandene WebSphere Application Server-Instanz auf Version 8.5.x durchzuführen oder weiterhin WebSphere Application Server Version 8.0.0.x zu verwenden.
Anmerkung: Dieser IBM Support-Artikel enthält Detailinformationen zu den folgenden Installations- und Upgradetasks:
  • Übersicht über die unterstützten Installations-, Upgrade- und Rollbackszenarios
  • Informationen zur Durchführung eines Upgrades für eine vorhandene Installation von WebSphere Application Server- und IBM HTTP Server-Komponenten
  • Anweisungen zur Durchführung eines Upgrades für ClearCase- und ClearQuest-Webkomponenten und zu deren Implementierung oder erneuten Implementierung für WebSphere Application Server

Informationen zu diesem Vorgang

In Tabelle 1 sind die empfohlenen Einstellungen für das WebSphere Application Server-Profil aufgelistet, in dem der Rational ClearQuest Web-Server implementiert ist. Diese Werte werden standardmäßig angewendet, wenn der ClearQuest Web-Server in einem neuen Profil implementiert wird, das während des ClearQuest-Installations- oder Upgradeprozesses erstellt wird.

Stellen Sie sicher, dass die Parameter für die JVM-Heapspeichergröße und für Thread-Pools auf die für das ClearQuest Web-Serverprofil empfohlenen Einstellungen gesetzt sind, um eine optimale Leistung zu erreichen.
Tabelle 1. Empfohlene WebSphere Application Server-Standardeinstellungen für den ClearQuest Web-Server
WAS-Einstellung Parametername Optimierter Wert Beschreibung
JVM-Heapspeichergröße setJvmMaxHeapSize 1536 MB Steuert die Speicherbelegung der Java™ Virtual Machine. Wird dieser Wert zu niedrig gesetzt, kann es zu häufig auftretenden Fehlern aufgrund abnormaler Speicherbedingungen kommen.
Thread-Pools setMaxSizesOfThreadPools 200 Gibt die maximale Anzahl Threads an, die im Standard-Thread-Pool aufrecht erhalten werden sollen. Das Ändern dieses Werts kann Auswirkungen auf den Serverstart und die Verarbeitungszeit haben.
Performance Monitoring Infrastructure (PMI) disablePMI oder enablePMI disablePMI Inaktiviert den PMI-Datenerfassungsprozess, der Informationen zum Diagnostizieren von Problemen und zum Optimieren der Anwendungsleistung sammelt. Durch Inaktivierung der Datenerfassung wird die Serverleistung verbessert. Sie können PMI bei Bedarf für die Fehlerbehebung aktivieren.
Größe der JVM-Protokolldatei setSystemOutErr 20 MB Legt die Dateigröße für die JVM-Dateien SystemOut.log und SystemErr.log fest. Standardposition für diese Protokolle:
Windows
C:\Programme\IBM\RationalSDLC\ClearQuest\cqweb\cqwebprofile\logs\server1
Linux und UNIX
/opt/IBM/RationalSDLC/ClearQuest/cqweb/cqwebprofile
Traceprotokoll setTraceLog 20 MB  
Einstellung für das Schreibzeitlimit für den eingehenden HTTP-Kanal setDefaultInboundHttpChannelWriteTimeouts 300 Sekunden Gibt an, wie lange (in Sekunden) der HTTP-Transportkanal auf einem Socket auf jeden zu übertragenden Abschnitt mit Antwortdaten wartet. Wird der Wert zu niedrig gesetzt, kann dies zum Trennen von Verbindungen und zu Downloadfehlern führen. In diesem Fall enthalten die Serverprotokolldateien möglicherweise Fehler wie beispielsweise IOError oder AsyncTimeoutException.
Anmerkung:
Wenn Sie Installation Manager auswählen, um ClearQuest Web in einem neuen WebSphere-Profil mit der Bezeichnung 'cqwebprofile' zu implementieren, setzt Installation Manager diese Standardwerte vorab auf die optimale Einstellung. Wenn Sie auswählen, dass ClearQuest Web in einem vorhandenen WebSphere-Profil implementiert werden soll, können diese optimalen Einstellungen nicht festgelegt werden. Sie selbst müssen die Einstellungen festlegen.

Einstellungen des WebSphere Application Server-Anwendungsserverprofils mit dem Tool 'wsadmin' ändern

WebSphere Application Server-Profileinstellungen des ClearQuest Web Server-Profils mithilfe des Tools teamAdminUtils.jacl ändern.

Informationen zu diesem Vorgang

Mit dem Tool teamAdminUtils.jacl können Sie die empfohlenen Standardeinstellungen für ein ClearQuest Web-Profil festlegen. Sie können diesen Befehl aber auch ausführen, um bestimmte Werte zu ändern. Verwenden Sie beispielsweise setCMRecommendedDefaults, um die Standardwerte festzulegen. Soll lediglich die Größe des JVM-Heapspeichers geändert werden, können Sie setJvmMaxHeapSize verwenden.

Weitere Informationen zum Tool wsadmin finden Sie im WebSphere Application Server Information Center: Version 8.5, Version 8.0

Vorgehensweise

Setzen Sie die WebSphere Application Server-Einstellungen für das ClearQuest Web-Serveranwendungsprofil auf die empfohlenen Werte.

  1. Starten Sie die WebSphere Application Server-Administrationskonsole, öffnen Sie das Befehlsfenster oder die Shell und wechseln Sie in das WebSphere Application Server-Verzeichnis bin.
    • Windows:
      cd C:\Programme\IBM\WebSphere\bin\
    • UNIX oder Linux:
      cd /opt/IBM/WebSphere/bin/
  2. Führen Sie den Befehl setCMRecommendedDefaults aus, um die Standardwerte auf das Profil anzuwenden, das den ClearQuest Web Server hostet.
    • Windows:
      wsadmin.bat -profile -profileName cqwebprofile "C:\Programme\IBM\RationalSDLC\ClearQuest\cqweb\scripts\teamAdminUtils.jacl" -c "setCMRecommendedDefaults"
    • UNIX oder Linux:
      ./wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setCMRecommendedDefaults"
  3. Starten Sie das WebSphere Application Server-Profil erneut, damit die Änderung wirksam wird.
    • Windows:
      stopServer.bat server1 -profileName cqwebprofile
      startServer.bat server1 -profileName cqwebprofile
    • UNIX oder Linux:
      ./stopServer.sh server1 -profileName cqwebprofile
      ./startServer.sh server1 -profileName cqwebprofile
    Anmerkung: Wenn es sich bei Ihrer WebSphere Application Server-Instanz um die 32-Bit-Edition handelt, kann die maximale JVM-Heapspeichergröße 1536 MB betragen. Wenn Sie diesen Wert überschreiten, können Sie Ihr ClearQuest Web-Profil nicht starten. Bei der 64-Bit-Edition können Sie diesen Wert auf über 2 GB erhöhen, was jedoch wegen des Java-GC-Aufwands eine schlechte Leistung zur Folge haben kann.
    Anmerkung: Bei den Beispielen in dieser Prozedur wird davon ausgegangen, dass der ClearQuest Web-Server im Standardprofil cqwebprofile installiert ist. Wenn Sie den ClearQuest Web-Server in einem Profil mit anderem Namen implementieren, müssen Sie den betreffenden Profilnamen anstelle von cqwebprofile verwenden. Bei diesem Beispiel wird davon ausgegangen, dass Sie WebSphere und ClearQuest im Standardverzeichnis installiert haben.
  4. Während einer Installation von (oder eines Upgrades auf) Rational ClearQuest Web Server Version 8.0 oder 8.0.0.x legt IBM Installation Manager nicht den Wert für die JVM-Heapspeichergröße für das WebSphere Application Server-Profil fest. Bei der Erstellung eines neuen WebSphere Application Server-Profils wird der JVM-Wert standardmäßig auf 256 MB gesetzt. Dieser Wert ist für ClearQuest Web Server Version 8.0 und Version 8.0.0.x zu niedrig und muss deshalb auf 1 GB erhöht werden. Gehen Sie wie folgt vor, um den Wert zu erhöhen:
    1. Navigieren Sie in einem Windows-Fenster mit Eingabeaufforderung oder in einer UNIX- oder Linux-Shell zum ClearQuest-Verzeichnis 'scripts'. Beispiel:
      • Windows:
        cd C:\Programme\IBM\RationalSDLC\ClearQuest\cqweb\scripts\
      • UNIX oder Linux:
        /opt/ibm/RationalSDLC/clearquest/cqweb/scripts/
    2. Führen Sie den folgenden WebSphere-Befehl aus, um die JVM-Heapspeichergröße für das WebSphere Application Server-Profil, in dem der ClearQuest Web-Server implementiert ist, auf 1024 zu setzen. Beispiel:
      • Windows:
        C:\Programme\IBM\WebSphere\AppServer\bin\wsadmin.bat -profile -profileName cqwebprofile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"
      • UNIX oder Linux:
        /opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setJvmMaxHeapSize 1024"
    3. Starten Sie das WebSphere Application Server-Profil erneut, damit die Änderung wirksam wird. Beispiel:
      • Windows:
        C:\Programme\IBM\WebSphere\AppServer\bin\stopServer.bat server1 -profileName cqwebprofile
        C:\Programme\IBM\WebSphere\AppServer\bin\startServer.bat server1 -profileName cqwebprofile
      • UNIX oder Linux:
        /opt/IBM/WebSphere/AppServer/bin/stopServer.sh server1 -profileName cqwebprofile
        /opt/IBM/WebSphere/AppServer/bin/startServer.sh server1 -profileName cqwebprofile

Feedback