调整 WebSphere Application Server 设置以优化 ClearQuest Web 服务器性能

必须查看 WebSphere® Application Server,以了解 ClearQuest® Web 服务器的应用程序服务器概要文件设置。如果已将 ClearQuest 安装到新概要文件,那么已为获取最佳性能优化了在安装期间创建的概要文件中的设置。 如果已安装到现有概要文件中或者服务器存在性能问题,那么参数值可能需要调整。

开始之前

有关指定 WebSphere Application Server 应用程序服务器概要文件设置的信息,请参阅以下资源。
  • 请参阅调优性能 WebSphere Application Server 信息中心 V8.0V8.5
  • IBM® DeveloperWorks 上,搜索 WebSphere Application Server 调优,以查找有关调优 WebSphere Application Server 概要文件设置以改善性能的文章。

将 Rational Web 组件升级到 V8.0.1 时,可以选择在 WebSphere Application Server V8.5.x 上部署这些组件。首先需要将现有 WebSphere Application Server 升级到新版本或升级为单独的 V8.5.x 实例,然后才能部署升级之后的 Rational Web 组件。

ClearCase 和 ClearQuest V8.0.1 Web 组件支持在 WebSphere Application Server V8.0.0.x 和 8.5.x 上进行部署。根据安装的 Rational 产品版本以及用于部署的 WebSphere Application Server 版本,升级到 ClearCase CCRC WAN 服务器或 ClearQuest Web 服务器 V8.0.1 可能需要安装新的 WebSphere Application Server 实例和 IBM HTTP Server 或升级现有版本。

要安装或升级 WebSphere Application Server V8.5.x 以支持 ClearCase CCRC WAN 服务器和 ClearQuest Web 服务器 V8.0.1:
  • 针对以下任何一种情况,安装新的 WebSphere Application Server 8.5.x 实例:
    • 从 ClearCase 或 ClearQuest V7.1.1.x、V7.1.2.x 升级到 V8.0.1 时
    • 从部署到 WebSphere Application Server V7.0.x 的 ClearCase 或 ClearQuest V8.0 或 V8.0.0.1 安装进行升级时
  • 如果要从部署到 WebSphere Application Server V8.0.0.x 的 V8.0.0.x 安装升级到 ClearCase 或 ClearQuest V8.0.1,可以选择将现有的 WebSphere Application Server 升级到 V8.5.x,也可以选择继续使用 WebSphere Application Server V8.0.0.x。
注:IBM 支持文章中提供有关以下安装和更新任务的更加详细的信息:
  • 所支持的安装、升级和回滚方案的矩阵
  • 关于升级现有 WebSphere Application Server 安装和 IBM HTTP Server 组件的信息
  • 关于升级 ClearCase 和 ClearQuest Web 组件以及将其部署或重新部署到 WebSphere Application Server 的指示信息

关于此任务

表 1 列出了部署 Rational® ClearQuest Web 服务器的 WebSphere Application Server 概要文件的建议设置。当 ClearQuest Web 服务器部署到在 ClearQuest 安装或升级过程中创建的新概要文件中时,缺省情况下会应用这些值。

为获取最佳性能,请确保在 ClearQuest Web 服务器概要文件的建议设置中包含 JVM 堆大小线程池参数。
表 1. 针对 ClearQuest Web 服务器的 WebSphere Application 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 传输通道为传输响应数据的各部分而在套接字上等待的时间量(以秒为单位)。如果将该值设置为过小的值,可能会导致断开连接和下载失败。在此情况下,服务器日志文件可能会显示诸如 IOErrorAsyncTimeoutException 之类的错误。
注:
如果选择使用 Installation Manager 将 ClearQuest Web 部署到名为“cqwebprofile”的新 WebSphere 概要文件中,那么 Installation Manager 会将这些缺省值预设置为最佳设置。如果选择在现有的 WebSphere 概要文件中部署 ClearQuest Web,那么不会设置这些最佳设置。您必须对最佳设置进行设置。

使用 wsadmin 工具修改 WebSphere Application Server 应用程序服务器概要文件设置

使用 teamAdminUtils.jacl 工具修改 ClearQuest Web 服务器概要文件的 WebSphere Application Server 概要文件设置。

关于此任务

可以使用 teamAdminUtils.jacl 工具设置 ClearQuest Web 概要文件的缺省推荐设置。 此外,还可以运行此命令以更改特定值。例如,要设置缺省值,请使用 setCMRecommendedDefaults。 如果仅更改 JVM 堆大小,请使用 setJvmMaxHeapSize

有关 wsadmin 工具的更多信息,请参阅 WebSphere Application Server 信息中心:V8.5V8.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 服务器的概要文件应用缺省值。
    • 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
    注: 如果您的 WebSphere Application Server 是 32 位版本,那么可拥有的 JVM 最大堆大小为 1536 MB。如果超出该值,将无法启动 ClearQuest Web 概要文件。对于 64 位版本,您可以将该值增至 2 GB 以上,但这样可能会 Java GC 开销而导致性能变差。
    注: 该过程中的示例假设 ClearQuest Web 服务器部署在缺省概要文件 cqwebprofile 中。如果以其他概要文件名称中部署 ClearQuest Web 服务器,请使用该概要文件名称,而不要使用 cqwebprofile。此示例假设您已在缺省目录中安装 WebSphere 和 ClearQuest。
  4. 在安装或升级到 Rational ClearQuest Web 服务器 V8.0 或 V8.0.0.x 期间,IBM Installation Manager 不会针对 WebSphere Application Server 概要文件设置 JVM 堆大小。 缺省情况下,创建新 WebSphere Application Server 概要文件时,JVM 值将会设置为 256 MB。该值对 ClearQuest Web 服务器 V8.0 和 V8.0.0.x 而言过低,必须增加到 1 GB。要增加该值:
    1. 在 Windows 命令提示符窗口中,或在 UNIX 或 Linux 命令 shell中,浏览到 ClearQuest 脚本目录。例如:
      • Windows:
        cd C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\scripts\
      • UNIX 或 Linux:
        /opt/ibm/RationalSDLC/clearquest/cqweb/scripts/
    2. 运行以下 WebSphere 命令,以将 ClearQuest Web 服务器部署所在的 WebSphere Application Server 概要文件的 JVM 堆大小设置为 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

反馈