Troubleshooting user tasks

Use this guidance to troubleshoot issues with user tasks for the Report Server for ClearQuest.
Problem Probable cause Possible solution
Log-in problem (CRRER0002E: Invalid User name or Password) The Rational ClearQuest Super User account user name and password may not be correct in the Deploy_RCQR_eWAS.py and reportserver.properties file Ensure that the Deploy_RCQR_eWAS.py file has the correct user name and password of the Rational ClearQuest Super User account (see the following snippet):
# 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',
}
Ensure that the reportserver.properties file has the correct user name and password of the Rational ClearQuest Super User account (see the following snippet):
 user.registry.cq.dbSet=7.0.0
      user.registry.cq.userDb=SAMPL
      user.registry.cq.connectionUrl=http://localhost:12080/TeamWeb/services/Team
      user.registry.cq.connectionUsername=admin
      user.registry.cq.connectionPassword=admin
      user.registry.cq.connectionPassword.encrypted=false
Incorrect contents in reportalprofile/classes directory Ensure that: the reportalprofile/classes directory has the correct versions of the following files:
  • cqregistry.jar
  • stpcmmn.jar
  • stpwvcm.jar
  • stpcq.jar

The stp*.jar files must be the same as the ones present in the Rational ClearQuest installation directory. The default location for the Rational ClearQuest installation directory is \RationalSDLC\ClearQuest\cqecUpdateSite\plugins\com.ibm.rational.stp_7.1000.0.v.jar.

The \RationalSDLC\ClearQuest\RCQR\server\rcqr-update-site\plugins\com.ibm.rational.stp_7.1000.0.v.jar folder has the same jar files. For the administrative tasks associated with updating the jar files, see Manually updating an RCQR jar file.

Missing file: cqrpc.exe in Windows, cqrpc.sh on Linux The log file may have an entry: CRVAP0237E Resource 'cq.dbset:7.0.0': not found. Look for the missing file (cqrpc.exe in Windows, cqrpc.sh on Linux) in the \RationalSDLC\common\CM\bin\ directory. If the file is missing, copy the file from the Rational ClearQuest install jar files.
The Rational ClearQuest server may not be reachable or may be stopped Verify that the Rational ClearQuest server is reachable and running. To do so, open a web browser and access http://localhost:12080/TeamWeb/services/Team. The following text must be returned: http://stp.rational.ibm.com/ws/teamservice}Team Hi there, this is a Web service!
Report Server for ClearQuest Server cannot be stopped The user name and password needed to stop the server cannot be validated because the credentials provided are incorrect, or the correct credentials are not known
  1. Disable administrative security. For details, see WebSphere Application Server Information Centre.
  2. Make corrections in the configuration files.
  3. Run Deploy_RCQR_eWAS.py again to enable security.
The Rational ClearQuest server may not be reachable or may be stopped Verify that the Rational ClearQuest server is reachable and running. To do so, open a web browser and access http://localhost:12080/TeamWeb/services/Team. The following text must be returned: http://stp.rational.ibm.com/ws/teamservice}Team Hi there, this is a Web service!
There may be errors in stopping the WAS service for the reportal profile. Run the following command to provide the credentials to stop the service: %RATIONAL_COMMON%/eWAS/bin/wasservice -add reportalprofile -serverName server1 -profilePath "%RATIONAL_COMMON%/CM/profiles/reportalprofile" -stopArgs "-username -password where username and password are same as the ones provided in the configuration files for the reportal.
The left-side navigation pane is not visible after logging in Insufficient system memory Increase the system memory or shut down some open applications.
No users are listed on the user admin page   Ensure that:
  • The reportserver.properties file contains the correct credentials
  • The \RationalSDLC\ClearQuest\RCQR\server\rcqr-update-site\plugins\com.ibm.rational.stp_7.1000.0.v.jar folder contains the correct jar files

Feedback