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)
- 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.
- a. Click Start > Control Panel > Administrative Tools > Services.
- Change the value of Startup type to disabled.
- Click Stop.
- Click OK.
b. Double click the IBM WebSphere Application Server v6.1 - cmprofile service.
c. On the General tab, perform the following tasks:
%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
cqrpc.exe -install_service -port port-number
net start CQRPC_Chart_Server
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):
- 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. 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:
- a. In a command window, change to the directory where the
wsadmin.sh
utility is installed. For example:cd /opt/rational/common/CM/scripts
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"
- 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.
Was this topic helpful?
Document Information
Modified date:
23 June 2018
UID
swg21408438