配置 Crystal Reports Java Reporting Component (JRC) 运行时

要针对 ClearQuest 报告使用 ClearQuest Report Server for Crystal Reports,请在 WebSphere Application Server 上安装并配置受支持的 Crystal Reports Java Reporting Component (JRC) 版本。

开始之前

如果您已安装了 Java Reporting Component 运行时,请除去现有版本,然后再执行这些配置步骤。请参阅除去 Crystal Reports JRC 运行时

关于此任务

有关 ClearQuest 支持的 Crystal Reports Java Reporting Component (JRC) 运行时版本以及何处下载这些版本的信息,请参阅技术说明 1216371

这些指示信息包含对该变量的引用:

%CLEARQUEST_HOME%\cqweb\cqwebprofile
在 Windows 上,该变量表示部署 ClearQuest Web 应用程序的 WebSphere 概要文件目录的缺省路径。CLEARQUEST_HOME 是 ClearQuest 的安装目录。
$CLEARQUEST_HOME/cqweb/cqwebprofile/
在 Linux 和 UNIX 上,该变量表示部署 ClearQuest Web 应用程序的 WebSphere 概要文件目录的缺省路径。CLEARQUEST_HOME 是 ClearQuest 的安装目录。
注: 在这些指示信息中,JRC 运行时的安装目录基于在以下缺省位置的新 WebSphere 概要文件中安装的 ClearQuest:
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
如果 ClearQuest 已安装到现有 WebSphere Application Server 概要文件中,那么该路径可能会不同,必须先更新指示信息中的路径,然后再复制 JRC 文件。 另一个要检查的常见位置为以下目录:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
如果 ClearQuest 托管在 Solaris 平台上,那么缺省的 WebSphere Application Server 单元目录为 <srv>Node01Cell。 针对 Windows、Unix 和 Linux 平台,值 dfltCell 是缺省值。

过程

  1. 下载满足您的 ClearQuest 报告需求的 Crystal Reports Java Reporting Component (JRC) 归档文件。 请参阅技术说明 1216371
  2. 将 Crystal Reports JRC 复制到 Web 应用程序。
    在 Windows 上
    运行批处理文件,将 JRC 复制到 Web 应用程序。

    如果您正在使用 Crystal Reports JRC V11.8.x,请运行 configureJRC.bat。 对于 JRC V12.2.x,请运行 configureJRC12.bat

    1. 通过命令提示符,转至 ClearQuest 批处理文件的安装目录:
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. 将 Crystal Reports JRC 运行时归档文件复制到该目录中。
    3. 根据您正在部署的运行时版本,运行以下命令之一。
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    在 Unix 上
    如果您正在使用 Crystal Reports JRC V11.8.x,运行 shell 脚本 configureJRC.sh。如果您正在使用 Crystal Reports JRC V12.2.x,请运行 configureJRC12.sh 脚本。
    1. 打开 UNIX 控制台窗口,并转至 ClearQuest shell 脚本的安装目录。
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. 将 Crystal Reports JRC 运行时归档文件复制到该目录中。
    3. 针对要运行的脚本版本设置许可权:
      chmod u+x ./configureJRC.shchmod u+x ./configureJRC12.sh
    4. 针对正在复制的 JRC 版本运行命令:
      ./configureJRC.sh JRC_runtime_file.zip
      ./configureJRC12.sh JRC_runtime_file.zip
  3. 停止并重新启动 IBM WebSphere Application Server 以激活更改。
    注: 如果 ClearQuest 安装到现有 WebSphere 概要文件中,那么这些指示信息中的目录可能会不同。
    在 Windows 上:
    1. 单击开始>控制面板>管理工具>服务
    2. 在“服务”窗格中,右键单击 IBM WebSphere Application Server V7.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile。
    3. 单击停止
    4. 服务停止后,右键单击服务器名称,并单击启动以重新启动服务器。
    在 UNIX 系统和 Linux 上:
    1. 通过 UNIX 控制台窗口,转至安装 ClearQuest 服务器组件的 WebSphere 概要文件的 bin 目录。
      注: 如果 ClearQuest 安装到现有 WebSphere 概要文件中,那么这些指示信息中的目录可能会不同。
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. 运行以下命令以停止并启动缺省概要文件:
      ./stopServer.sh server1
      ./startServer.sh server1
  4. 要验证 ClearQuest Report Server for Crystal Reports 是否配置正确,请打开浏览器窗口并转至以下 URL:http://localhost:<port>/cqwebreport/CRInvoker 其中 <port> 是概要文件中定义的用于部署该应用程序的端口。缺省 ClearQuest 概要文件使用 port 12080。缺省 WebSphere Application Server 概要文件使用 port 9080
    如果服务器配置正确,那么会显示以下消息。
    The report document has expired.
  5. 在以下情况下,需要额外的配置步骤:
    • 在 ClearQuest 模式中更改了数据库的字段名称。
    • ClearQuest 的显示字段名称与数据库的字段名称不匹配。
    • ClearQuest 的显示字段名称超出 30 个字符。
    请参阅技术说明 1419660

反馈