Resetting login information in a ClearCase and ClearQuest, Base or UCM integration
Technote (FAQ)
Problem
IBM? Rational? ClearCase? and IBM? Rational? ClearQuest?, Base or UCM integration is displaying ClearQuest login errors or is not reflecting recent ClearQuest login changes.
Cause
These are the known causes of this issue:
Cause 1: ClearQuest login information is corrupt, or has changed.
Cause 2: ClearQuest caches login information within the Microsoft? Windows? profile.
Solution
To Cause 1:
--------------------------------------------------------------------------------
Demonstration for version 7.0
Clearing the cached information and restarting the integration often rectifies the situation. Follow the procedure below that corresponds to your platform and integration type:
For the UCM integration on Windows:
Close all IBM Rational products
Open Windows Task Manager and End Task the CQINTSRV~11 process
Close out the Task Manager
Open regedt32 using Start > Run and typing regedt32 and clicking OK.
Locate and remove the following registry key:
In Version 7.0
HKEY_CURRENT_USER\Software\Rational Software\ClearCase\UCMCQ_Integration\<CQ_Database>
In Versions 2003.06.xx:
HKEY_CURRENT_USER\Software\Rational Software\ClearQuest\2003.06.00\Common\CQIntSvr
In Versions 2002.05.xx:
HKEY_CURRENT_USER\Software\Rational Software\Clearquest\2.0\Common\CQIntSrv\UCM_SquidIntegration_yourusername\UserName
Additional workaround when using Version 7.0:
Access Start > Run and enter the following command:
crmregister remove –database crm-database-name | –all
For the UCM integration on UNIX:
Close all IBM Rational products
In the user's home directory:
cd to
.Rational/.Registry/ClearQuest/2002.05.00
-OR-
2003.06.00/CQIntSvr
Then remove the squid login
example: rm Login-UCM_SquidIntegration_<user account>
Kill -9 the CQIntSvr process by running ps -ef and kill -9 on the appropriate PID
For the V2 integration on Windows:
Close all IBM Rational products
Remove the .CQparams file from:
C:\Documents and Settings\<user account>\Application Data\Rational\CQCC
Open regedt32 using Start > Run and typing regedt32 and clicking OK.
Locate and remove the following registry key:
HKEY_CURRENT_USER\Software\Rational Software\ClearQuest\2003.06.00\Common\CQIntSvr
For the V2 integration on UNIX:
Close all IBM Rational products
In the user's home directory remove the .CQparams file by running ls -al to find all hidden files to make sure the file exists, then running rm .cqparams
After performing the above procedure for your environment, perform an action that will trigger the integration. You will be prompted to enter in your ClearQuest login information and the integration should now function as expected.
To Cause 2:
--------------------------------------------------------------------------------
How to reset the Windows Profile
Rename your Windows profile From:
C:\Documents and Settings\<username>
To:
C:\Documents and Settings\<usernameOLD>
Then log-off and login
This procedure will force Windows to rebuild your profile, which will allow you to enter the ClearQuest login again
Do you need more help?
For additional assistance, contact IBM Rational Client Support:
Submit an Electronic Service Request (ESR)
Cross Reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearQuest IBM integrations AIX, HP-UX, Linux, Solaris, Windows 7.0, 2003.06.16, 2003.06.15, 2003.06.14, 2003.06.13, 2003.06.12, 2003.06.10, 2003.06.01, 2003.06.00, 2002.05.20, 2002.05.00
Software Development Rational ClearCase Integration: ClearQuest AIX, HP-UX, Linux, Solaris, Windows 2002.05.00, 2003.06.00, 2003.06.01, 2003.06.10, 2003.06.12, 2003.06.13, 2003.06.14, 2003.06.15, 7.0
crmregister remove -database test