調整 WebSphere Application Server 設定以最佳化 ClearQuest Web Server 效能

您必須檢閱 ClearQuest® Web 伺服器之應用程式伺服器設定檔中的 WebSphere® Application Server 設定。如果您已將 ClearQuest 安裝至新的設定檔,則在安裝期間建立的設定檔中的設定已進行最佳化,以取得最佳效能。 如果您是安裝到現有的設定檔,或伺服器有效能問題,則參數值可能需要調整。

開始之前

如需指定 WebSphere Application Server 應用程式伺服器設定檔之設定的相關資訊,請參閱下列資源。
  • 請參閱 Tuning performance WebSphere Application Server 資訊中心:8.0 版8.5 版
  • IBM® DeveloperWorks 上,搜尋 WebSphere Application Server 調整,以尋找調整 WebSphere Application Server 設定檔設定來改善效能的相關文章。

當您將 Rational Web 元件升級為 8.0.1 版時,可以選擇是否要在 WebSphere Application Server 8.5.x 版上部署這些元件。在部署升級後的 Rational Web 元件之前,必須先將 WebSphere Application Server 升級為新版,或是使用個別的 8.5.x 版實例。

ClearCase 與 ClearQuest 8.0.1 版 Web 元件可以部署在 WebSphere Application Server 8.0.0.x 版及 8.5.x 版上。升級為 ClearCase CCRC WAN Server 或 ClearQuest Web 伺服器 8.0.1 版可能會需要安裝新的 WebSphere Application Server 與 IBM HTTP Server 實例或升級現有的版本,視安裝的 Rational 產品版本與部署所在的 WebSphere Application Server 版本而定。

若要安裝或升級 WebSphere Application Server 8.5.x 版,以支援 ClearCase CCRC WAN Server 及 ClearQuest Web 伺服器 8.0.1 版:
  • 下列情況下必須安裝新的 WebSphere Application Server 8.5.x 實例:
    • 從 ClearCase 或 ClearQuest 7.1.1.x、7.1.2.x 版升級為 8.0.1 版
    • 從部署在 WebSphere Application Server 7.0.x 版上的 ClearCase 或 ClearQuest 8.0 版或 8.0.0.1 版安裝升級
  • 若要將部署在 WebSphere Application Server 8.0.0.x 版上的 ClearCase 或 ClearQuest 8.0.0 版升級為 8.0.1 版,可以選擇將現有的 WebSphere Application Server 升級為 8.5.x 版,或是繼續使用 WebSphere Application Server 8.0.0.x 版。
註: 如需下列安裝及升級作業的相關詳細資訊,請參閱此 IBM支援中心文章
  • 支援的安裝、升級與回復案例對照表
  • 升級現有的 WebSphere Application Server 安裝及 IBM HTTP Server 元件的相關資訊
  • 升級 ClearCase 與 ClearQuest Web 元件,以及將這些元件部署或重新部署到 WebSphere Application Server 上的指示

關於這項作業

表 1 列出部署 Rational® ClearQuest Web Server 的 WebSphere Application Server 設定檔的建議設定。將 ClearQuest Web Server 部署到 ClearQuest 安裝或升級處理程序期間建立的新設定檔時,預設會套用這些值。

為了取得最佳的效能,請確定 JVM 資料堆大小執行緒儲存區參數是在 ClearQuest Web Server 設定檔的建議設定。
表 1. WebSphere Application Server 預設值,ClearQuest Web Server 的建議設定
WAS 設定 參數名稱 最佳化的值 說明
JVM 資料堆大小 setJvmMaxHeapSize 1536 MB 控制 Java™ VM 記憶體耗用。此值的設定過低時,會導致經常發生記憶體不足的錯誤。
執行緒儲存區 setMaxSizesOfThreadPools 200 指定預設執行緒儲存區所要維護的執行緒數目上限。變更此值會影響伺服器的啟動及處理時間。
效能監視基礎架構 (PMI) disablePMIenablePMI disablePMI 停用 PMI 資料收集處理程序,它會收集資訊以便診斷問題及調整應用程式效能。停用資料收集可改善伺服器效能。您可以在必要時啟用 PMI 以進行疑難排解。
JVM 日誌檔大小 setSystemOutErr 20 MB 設定 JVM SystemOut.logSystemErr.log 的檔案大小。這些日誌的預設位置如下:
Windows
C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\cqwebprofile\logs\server1
Linux 及 UNIX
/opt/IBM/RationalSDLC/ClearQuest/cqweb/cqwebprofile
追蹤日誌 setTraceLog 20 MB  
HTTP 入埠通道的寫入逾時設定 setDefaultInboundHttpChannelWriteTimeouts 300 秒 指定 HTTP 傳輸通道等待 Socket 上每一個部分的回應資料都被傳輸的時間量(秒)。此值的設定過低時,會導致中斷連線及下載失敗。在此情況下,伺服器日誌檔可能會顯示例如 IOErrorAsyncTimeoutException 的錯誤。
註:
若選擇讓 Installation Manager 將 ClearQuest Web 部署到新的 WebSphere 設定檔 'cqwebprofile',Installation Manager 會預先預設值設為最佳設定。 若選擇將 ClearQuest Web 部署到現有的 WebSphere 設定檔,將無法設定最佳設定。 您必須自行設定。

使用 wsadmin 工具修改 WebSphere Application Server 應用程式伺服器設定檔設定

使用 teamAdminUtils.jacl 工具修改 ClearQuest Web 伺服器設定檔的 WebSphere Application Server 設定檔設定。

關於這項作業

您可以使用 teamAdminUtils.jacl 工具為 ClearQuest Web 設定檔設定建議的預設設定。 您也可以執行此指令變更特定的值。例如,若要設定預設值,可使用 setCMRecommendedDefaults。 若只要變更 JVM 資料堆大小,可使用 setJvmMaxHeapSize

如需「Wsadmin 工具」的相關資訊,請參閱「WebSphere Application Server 資訊中心」:8.5 版8.0 版

程序

將 ClearQuest Web 伺服器應用程式設定檔的 WebSphere Application Server 設定設為建議值

  1. 啟動「WebSphere Application Server 管理主控台」,再開啟指令視窗或 Shell,然後移至 WebSphere Application Server bin 目錄。
    • Windows:
      cd C:\Program Files\IBM\WebSphere\bin\
    • UNIX 或 Linux:
      cd /opt/IBM/WebSphere/bin/
  2. 執行 setCMRecommendedDefaults 指令,將預設值套用至管理 ClearQuest Web Server 的設定檔。
    • Windows:
      wsadmin.bat -profile -profileName cqwebprofile "C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\scripts\teamAdminUtils.jacl" -c "setCMRecommendedDefaults"
    • UNIX 或 Linux:
      ./wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setCMRecommendedDefaults"
  3. 重新啟動 WebSphere Application Server 設定檔,讓變更生效。
    • Windows:
      stopServer.bat server1 -profileName cqwebprofile
      startServer.bat server1 -profileName cqwebprofile
    • UNIX 或 Linux:
      ./stopServer.sh server1 -profileName cqwebprofile
      ./startServer.sh server1 -profileName cqwebprofile
    註: 若是 32 位元版的 WebSphere Application Server,最大可有 1536 MB 的 JVM 資料堆大小。若超過此值,將無法啟動您的 ClearQuest Web 設定檔。 若是 64 位元版,此值最大可到 2 GB,但整體效能將會因為 Java GC 的例行負荷而變差。
    註: 此程序中的範例是假設 ClearQuest Web 伺服器部署到預設設定檔 cqwebprofile。若將 ClearQuest Web 伺服器部署到不同的設定檔名稱,請以該設定檔名稱取代 cqwebprofile。此範例假設您將 WebSphere 及 ClearQuest 安裝到預設目錄。
  4. IBM Installation Manager 並不會在安裝或升級為 Rational ClearQuest Web 伺服器 8.0 版或 8.0.0.x 版時,設定 WebSphere Application Server 設定檔的 JVM 資料堆大小值。 當建立新的 WebSphere Application Server 設定檔時,會將 JVM 預設值設為 256 MB。此值對於 ClearQuest Web 伺服器 8.0 版與 8.0.0.x 版而言太低,必須增加到 1 GB。若要增加此值:
    1. 在 Windows 命令提示字元視窗中,或在 UNIX 或 Linux 的指令 Shell 中,瀏覽至您的 ClearQuest Script 目錄。例如:
      • Windows:
        cd C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\scripts\
      • UNIX 或 Linux:
        /opt/ibm/RationalSDLC/clearquest/cqweb/scripts/
    2. 執行下列 WebSphere 指令,以設定 WebSphere Application Server 設定檔的 JVM 資料堆大小,其中 ClearQuest Web 伺服器應部署為 1024。例如:
      • Windows:
        C:\Program Files\IBM\WebSphere\AppServer\bin\wsadmin.bat -profile -profileName cqwebprofile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"
      • UNIX 或 Linux:
        /opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setJvmMaxHeapSize 1024"
    3. 重新啟動 WebSphere Application Server 設定檔,以使變更生效。例如:
      • Windows:
        C:\Program Files\IBM\WebSphere\AppServer\bin\stopServer.bat server1 -profileName cqwebprofile
        C:\Program Files\IBM\WebSphere\AppServer\bin\startServer.bat server1 -profileName cqwebprofile
      • UNIX 或 Linux:
        /opt/IBM/WebSphere/AppServer/bin/stopServer.sh server1 -profileName cqwebprofile
        /opt/IBM/WebSphere/AppServer/bin/startServer.sh server1 -profileName cqwebprofile

意見