Configuring Crystal Reports, version for Eclipse

To use the HCL Compass Report Server for Crystal Reports for Compass reporting, install and configure a supported version of the Crystal Reports, version for Eclipse on the WebSphere® Application Server.

Before you begin

If you have already installed the Java™ Reporting Component runtime, remove the existing version before performing these configuration steps. See Removing the Crystal Reports runtime.

About this task

These instructions include references to this variable:

%CLEARQUEST_HOME%\cqweb\cqwebprofile
On Windows™, this variable represents the default path for the WebSphere® profile directory where HCL Compass web applications are deployed. CLEARQUEST_HOME is the directory where Compass is installed.
$CQ_HOME/cqweb/cqwebprofile/
On Linux™, this variable represents the default path for the WebSphere® profile directory where HCL Compass web applications are deployed. CQ_HOME is the directory where Compass is installed.
Note: In these instructions, the installation directory for the JRC runtime is based on HCL Compass being installed in a new WebSphere® profile at this default location:
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
If HCL Compass was installed into an existing WebSphere® Application profile, this path might be different, and the path in the instructions must be updated before copying the JRC files. One other common location to check is this directory: 
cd /opt/ibm/clearquest/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war

Procedure

  1. Download the Crystal Reports, version for Eclipse archive file that meets your HCL Compass reporting requirements.
  2. Copy the Crystal Reports, version for Eclipse to the web application.
    On Windows™
    Run the batch file to copy the JRC to the web application.

    If you are using Crystal Reports, Version for Eclipse, run the configureJRC.bat. For JRC version 12.2.x, run configureJRC12.bat

    1. From a command prompt, go to the directory where the HCL Compass batch files were installed:
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. Copy the runtime archive file into this directory.
    3. Run one of the following commands depending on which version of the runtime you are deploying.
      configureJRC CR4ERL32_0-80004572.zip
configureJRC12 JRC_runtime_file.zip
    Note: The Crystal Reports .zip file name and version may vary depending on SAP release.
  3. Stop and restart IBM® WebSphere® Application Server to activate the changes.
    Note: The directory in these instructions might be different if HCL Compass was installed into an existing WebSphere® profile.
    On Windows™:
    1. Click Start > Control Panel > Administrative Tools > Services.
    2. In the Services pane, right-click IBM® WebSphere® Application Server v8.5 or 9.0 - %CLEARQUEST_HOME%\cqweb\cqwebprofile.
    3. Click Stop.
    4. After the service stops, right-click on the server name and click Start to restart the server.
  4. To verify that the HCL Compass Report Server for Crystal Reports is configured properly, open a browser window and go to this URL: http://localhost:<port>/cqwebreport/CRInvoker
    Where <port> is the port defined in the profile to deploy the application. The default HCL Compass profile uses port 12080. The default WebSphere® Application Server profile uses port 9080.
    If the server is configured properly, this message is displayed.
    The report document has expired.
  5. Additional configuration steps are required in these situations:
    • A database field name is changed in the HCL Compass schema.
    • HCL Compass display field names do not match database field names.
    • HCL Compass display field names exceed 30 characters.