Configuring the ClearQuest Report Server for Crystal Reports

This topic explains how to configure the ClearQuest Report Server for Crystal Reports.

About this task

Attention: In the current release, the ClearQuest Report Server for Crystal Reports is supported only on a subset of the platforms supported by Rational ClearQuest Web for running traditional data push reports. See technical note http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21216371.
The following variable is used in path names in this topic:
RATIONAL_COMMON
Directory where Rational common files are installed
After installing the ClearQuest Report Server for Crystal Reports, you must update this Web component to include the required Crystal Reports Java Reporting Component (JRC) runtime support.

Procedure

  1. Download the Crystal Reports Java Reporting Component (JRC) archive file, CrystalReports_CQ_JRC.zip, from the Business Objects Web site at http://www.businessobjects.com/ibmrational. The JRC is available to licensed IBM Rational ClearQuest users as a free download.
  2. Copy the Crystal Reports JRC to the Web application.
    On Windows:
    Run the batch file configureJRC.bat.
    1. Open a command prompt window and navigate to the directory where configureJRC.bat is installed:
      cd %RATIONAL_COMMON%\CM\profiles\cmprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Copy the CrystalReports_CQ_JRC.zip file into this directory.
    3. Run the following command:
      configureJRC CrystalReports_CQ_JRC.zip

    On the UNIX system and Linux:
    Run the shell script configureJRC.sh.
    1. Open a UNIX console window and navigate to the directory where configureJRC.sh is installed:
      cd $RATIONAL_COMMON/CM/profiles/cmprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Copy the CrystalReports_CQ_JRC.zip file into this directory.
    3. Run the following command:
      ./configureJRC.sh CrystalReports_CQ_JRC.zip
  3. Stop and restart IBM WebSphere Application Server to activate the changes.
    On Windows:
    1. Click Start > Control Panel > Administrative Tools > Services.
    2. In the Services pane, right-click IBM WebSphere Application Server v6.1 - cmprofile and select Stop.
    3. After the service stops, restart it by right-clicking and selecting Start.
    On the UNIX system and Linux:
    1. From a UNIX console window, navigate to the following directory:
      cd $RATIONAL_COMMON/eWAS/bin
    2. Type the following commands to stop and start the default profile:
      ./stopServer.sh WebSphere-host
      ./startServer.sh WebSphere-host

    If you are using more than one profile in the WebSphere Application Server instance (for example, one for Rational ClearQuest Web and another for RequisitePro Web), you must also specify the profile on the command line. For example:

    ./stopServer.sh WebSphere-host -profileName cmprofile
    ./startServer.sh WebSphere-host -profileName cmprofile
  4. Verify that the Report Server for Crystal Reports is configured properly by opening a Web browser window and entering the following URL:

    http://localhost:12080/cqwebreport/CRInvoker

    The server is configured properly if you see this message:

    The report document has expired.
  5. Additional configuration steps will be required in the following situations:
    • A database field name is changed in the ClearQuest schema
    • ClearQuest display field names do not match database field names
    • ClearQuest display field names exceed 30 characters

    See tech note http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21419660.


Feedback