Configuring the ClearQuest Report Server for Crystal Reports

This topic explains how to configure the ClearQuest Report Server for Crystal Reports.
The following variables are used in path names in this topic:
RATIONAL_COMMON
Directory where Rational common files are installed
JRC-archive
Crystal Reports Java Reporting Component (JRC) runtime archive
After installing the ClearQuest Report Server for Crystal Reports, you must update this Web component to include the required Crystal Reports JRC runtime support.
  1. Download the Crystal Reports JRC 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. On Windows, run the batch file configureJRC.bat to copy the Crystal Reports JRC to the Web application.
    1. Open a command prompt window and navigate to the directory where configureJRC.bat is installed:
      cd drive:%RATIONAL_COMMON%\CM\profiles\cmprofile\installedApps\profile\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Run the following command:
      configureJRC JRC-archive

    On the UNIX system and Linux, run the shell script configureJRC.sh to copy the Crystal Reports JRC to the Web application.

    1. Open a UNIX console window and navigate to the directory where configureJRC.sh is installed:
      cd $RATIONAL_COMMON/cmprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. Run the following command:
      ./configureJRC.sh JRC-archive
  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.

Feedback