The official instructions are in this IBM page
Process:
- Download the appropriate package from the FTP link below to your ClearCase, CCRC or ClearQuest host.
- Decompress the archive to a temp location.
- Follow the instructions (extracted from the archive) outlined for ClearCase (CC_INSTRUCTIONS.txt) or ClearQuest (CQ_INSTRUCTIONS.txt) or ClearCase Remote Client (CCRC_INSTRUCTIONS.txt) to complete the steps to enable the feature integrations.
Extract: (ClearCase 32 bits)
In order to register ClearCase 7.0.1 with Visual Studio 2008, the following steps are required:
- Install Visual Studio 2008
- Install Rational ClearCase v7.0.1 or later
Note: Be sure to select the VS.NET integration when installing ClearCase.
- Download and extract the contents of
CC-CQ-VS2008.zip
to a temp location (for example C:\Temp
) on the ClearCase host with Visual Studio 2008 installed.
There will be 6 files extracted:
ccvsisearchtoolwin_VS2008.reg
,
ccvsiwanservice_VS2008.reg
,
reg_VS2008.bat
,
CCRC_INSTRUCTIONS.txt
,
CC_INSTRUCTIONS.txt
,
CQ_INSTRUCTIONS.txt
.
- Search for a file named
ccvsisearchtoolwin.DLL
on the ClearCase host to obtain the path where this file resides.
Note: The default location is C:\Program Files\Common Files\Rational\ClearCase\CCVSI\bin
- Edit the
ccvsisearchtoolwin_VS2008.reg
registry file you just downloaded using a text editor (for example Wordpad) and search for the following string:
"CodeBase"="C:\\Program Files\\Common Files\\Rational\\ClearCase\\CCVSI\\bin\\ccvsisearchtoolwin.DLL"
.
Verify that this path matches the installation path identified in step #4. If the path does not match, modify the path to match.
Note: Keep the double back slashes, this is expected.
- Next, search for the following string in the file
ccvsisearchtoolwin_VS2008.reg
:
"Path"="C:\\Program Files\\Common Files\\Rational\\ClearCase\\CCVSI\\bin"
.
Verify that this path matches the installation path identified in step #4. If the path does not match, modify the path to match. Save and close the file ccvsisearchtoolwin_VS2008.reg
.
- Next, search for a file named
ccvsiwanservice.DLL
on the ClearCase host to obtain the path where this file resides.
Note: The default location is C:\Program Files\IBM\Rational\CCRCVSI\WanPackage
.
- Edit the
ccvsiwanservice_VS2008.reg
registry file you just downloaded using a text editor and search for the following string:
"CodeBase"="C:\\Program Files\\IBM\\Rational\\CCRCVSI\\WanPackage\\ccvsiwanservice.DLL"
.
Verify that this path matches the installation path identified in step #7. If the path does not match, modify the path to match.
- Next, search for the following string in the file
ccvsiwanservice_VS2008.reg
:
"Path"="C:\\Program Files\\IBM\\Rational\\CCRCVSI\\WanPackage"
.
Verify that this path matches the installation path identified in step #7. If the path does not match, modify the path to match. Save and close the file ccvsiwanservice_VS2008.reg
.
- Next, edit the batch file named
reg_VS2008.bat
with a text editor and fill in the 8 different variables based on the selections provided. Save and close the file.
- Execute the batch file in its current location (double click the batch file) to register the dlls and configure the integration feature with Visual Studio 2008.
Note: be aware of:
ClearCase and Visual Studio 2008 integration missing ccvsiwanservice.dll
If CCRC has not been installed on the host, this file is unavailable.
Resolving the problem
If you are not going to use CCRC on the host, the workaround would be to edit the reg_VS2008.bat
file and set CCRC_for_VS in the bat file to 0, which means it won't set ccWAN
in that bat file.
Cause
The files that are required to setup the integration are missing if ClearCase has not been installed with the Visual Studio integration options.
The README indicated that Visual Studio 2008 could be installed before ClearCase and made no reference of the integration option when installing ClearCase.
Follow the instructions in technote 1259189 to integrate ClearCase and Visual Studio.
Note: You will need to select the Visual Studio 2005 integration option.
Once ClearCase is reinstalled with the Visual Studio integration files, the Visual Studio 2008 integration procedure for ClearCase 7.0.1 will work as expected.