Deploying the Report Server for ClearQuest on WebSphere Application Server

This topic describes how to deploy the Report Server for ClearQuest on WebSphere Application Server.

Procedure

  1. Locate the file Deploy_RCQR _eWAS.py. By default, this is located in %RATIONAL_COMMON%/CM/Scripts. Specify the following set of parameters. If you are using a remote Change Management Server (CM Server), set a value for cqConnectionURL, specifying the IP address or host name for the value localhost. The default is shown. Values should be consistent with those in the file /RCQR/server/reportserver.properties. For example, the user.registry.cq.connectionURL value should match the cqConnectionURL in the reportserver.properties file.

    Also note that the admin user name is listed in three places in the Deploy_RCQR_eWAS.py, and the value must be consistent. The following example shows default values for this file. The three occurrences of the administrator user name appear in boldface type.

    # Set basic properties of custom security
    
    attrs = '[[useRegistryServerId false][primaryAdminId %s][customRegistryClassName %s]]' % ('admin', 'com.ibm.rational.cq.was.userregistry.CQUserRegistry')
    
    AdminConfig.modify(customUserRegistry, attrs)# Set custom properties
    customProps = {
    'autoCreateJazzGroups':'true',
    'jazzAdmins':'admin',
    'jazzProjectLeads':'lead',
    'cqDbSetName':'7.0.0',
    'cqUserDbName':'SAMPL',
    'cqConnectionURL':'http://localhost:12080/TeamWeb/services/Team',
    'cqConnectionUsername':'admin',
    'cqConnectionPassword':'admin',
    'cqConnectionPasswordEncrypted':'false',
    }
  2. Start the Report Server profile either by using the Windows Services dialog box or by running the following command:
    "%RATIONAL_COMMON%/CM/profiles/reportalprofile/bin/startServer" server1 -profileName reportalprofile 
  3. Navigate to the %RATIONAL_COMMON%/CM/profiles/reportalprofile/bin directory for the report server profile and run the following command:
    wsadmin.bat -lang jython -f  ..\..\..\Scripts\Deploy_RCQR_eWAS.py
  4. Update the wasservice with the user name and password by using the following command, where <user> and <password> match the values specified in Deploy_RCQR_eWAS.py.
    "%RATIONAL_COMMON%/eWAS/bin/wasservice" -add reportalprofile -serverName server1 -profilePath "%RATIONAL_COMMON%/CM/profiles/reportalprofile" -stopArgs "-username <user> -password <password>"
  5. Restart the Report Server for ClearQuest. See Starting and stopping the Report Server for ClearQuest.

Verifying the deployment

Procedure

  1. Restart the Report Server for ClearQuest. See Starting and stopping the Report Server for ClearQuest.
  2. Access the reporting interface using the following link, where machinename.domain is the host name and domain of the computer where the Report Server for ClearQuest is installed and portnumber is the port, typically 15443 for secure connections:
    https://machinename.domain:portnumber/jazz/reportal/projects/Vega
    For example, you would use the following URL to open the reporting interface from the Report Server for ClearQuest host:
    https://localhost:15443/jazz/reportal/projects/Vega
  3. At the login prompt, type your Rational ClearQuest user name and password and click Login.

Feedback