IBM Support

How to configure a UNIX/Linux Change Management Server (CM Server) to display charts on the ClearQuest Web server

Question & Answer


Question

How do you configure the Change Management Server (CM Server) to display charts on the IBM Rational ClearQuest Web server?

Answer

As a result of APAR PK82347, starting in IBM Rational ClearQuest (CQ) version 7.1.1, chart support is available on ClearQuest Web servers that run on the UNIX system and Linux.

You must install ClearQuest with the required CM Server components on a UNIX or Linux host, as well as on a Microsoft Windows host. Then configure the CM Server on UNIX or Linux to communicate with the CM Server on Windows to enable processing of chart requests on behalf of the UNIX or Linux server through the steps outlined below.

Windows system installation and configuration

This section describes how to configure the Change Management (CM) Server running on Windows to process chart requests on behalf of the CM Server running on the UNIX system or Linux. The Windows computer should have at least 2 GBytes of physical memory (refer to specific minimum memory requirements of the version of CQ in use):

1. Install IBM Rational ClearQuest with the required server components on the Windows computer. At a minimum, install the following ClearQuest components:

    • Client Components > Rational ClearQuest Client
    • Client Components > Administration Tools
    • Server Components > Web Server Components > ClearQuest Web Server
    • Server Components > Web Server Components > CM Server for ClearQuest Web (7.X versions)

2. Register the ClearQuest databases by using the Maintenance Tool:
    • On the Windows computer, you must register the same databases that you register on the UNIX or Linux computer.
    • The database set name on both the Windows computer and the UNIX or Linux computer must be identical.

3. Optional (7.X versions) : Stop and disable the IBM WebSphere Application Server v6.1 - cmprofile service if you want fewer processes running on this computer:
    a. Click Start > Control Panel > Administrative Tools > Services.
    b. Double click the IBM WebSphere Application Server v6.1 - cmprofile service.
    c. On the General tab, perform the following tasks:
      • Change the value of Startup type to disabled.
      • Click Stop.
      • Click OK.

4. On the Windows system, add %RATIONAL_HOME%\ClearQuest to the system path:
    a. First verify that %RATIONAL_HOME% is already defined correctly. If so, proceed.
    b. Click Start > Control Panel > System.
    c. Select the Advanced tab.
    d. Click Environment Variables.
    e. Select the PATH variable in the System Variables list and click Edit.
    f. Add %RATIONAL_HOME%\ClearQuest to the PATH value.


5. Deploy/start the cqrpc chart server Windows service:
    a. In a command window, change to the following directory:

        cd %RATIONAL_HOME%\common\CM\bin

    b. Run the following commands, replacing the variable port-number with an available TCP/IP port on the Windows system:

        cqrpc.exe -install_service -port port-number
        net start CQRPC_Chart_Server
    6. Ensure that your Windows firewall allows TCP/IP traffic for the port on which the ClearQuest chart server is running.





    UNIX system and Linux installation and configuration

    This section describes how to configure the CM Server running on the UNIX system or Linux to redirect chart requests to the Windows system.

    1. Install Rational ClearQuest with the required server components on the UNIX system or Linux. At a minimum, install the following ClearQuest components:

      • Client Components > Rational ClearQuest Client
      • Client Components > Administration Tools
      • Server Components > Web Server Components > CM Server for ClearQuest Web (in 7.1.x versions) , ClearQuest Web Server (in 8.X versions)

    2. Configure the CM Server running on the UNIX system or Linux to redirect chart requests to the CM Server running on Windows. You can use either the browser-based CM Server Administration utility or the wsadmin.sh command-line utility to configure the CM Server:
      • To use the CM Server Site Administration Console to configure the CM Server (preferred method):


      • a. From ClearQuest Web, login as a CQ administrator. Click Site Administration > Configuration and select the CM Server ClearQuest Options (ClearQuest Web Server Options in ClearQuest 8.X) tab.

        b. Fill in the following fields:
          • In the Windows ClearQuest chart and report server host name field, enter the host name for the Windows chart and report server.
          • In the Port for Windows ClearQuest chart and report server field, enter the port that the Windows chart and report server is configured to use.

      • To use the wsadmin.sh utility to configure the CM Server (if command line method is required):
        a. In a command window, change to the directory where the wsadmin.sh utility is installed. For example:
          cd /opt/rational/common/CM/scripts
        b. Run the wsadmin.sh utility, replacing host-name and port in the following example with the host name and port associated with the Windows server:


          /opt/rational/common/CM/profiles/cmprofile/bin/wsadmin.sh -profile teamAdminUtils.jacl -c "configureChartReportServer host-name port"


    Limitations for Crystal Reports data-push reports
    • For ClearQuest Web 7.1.0.x versions earlier than 7.1.1.0, running SAP Business Objects Crystal Reports data-push reports requires that the associated CM Server be hosted on Windows. Running Crystal Reports data-push reports initiated from a CM Server running on UNIX or Linux is not supported.
    • ClearQuest Web version 7.1.1.0 introduces the ability to run Crystal Reports data-push reports initiated from a CM Server running on UNIX or Linux. This is documented in Technote 1402865.

    Defect fix for Crystal Reports data-push reports

    • ClearQuest Web versions 7.1.1.4 and 7.1.2.1 fix a defect that displays the following error message:

    • Error from RPC server: Failed to create chart.

    [{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"CM Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.1.1;7.1.2;8.0;8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

    Document Information

    Modified date:
    23 June 2018

    UID

    swg21408438