Troubleshooting
Problem
You start the installation of an IBM Rational product. The installation hangs when the GSKit is installed.
Symptom
The Rational product installation fails or hangs at the time of GSKit installation. In Task Manager, the setup.exe process continues to run.
Cause
GSKit is installed when the Rational products are installed. In some cases, the GSKit installation does not complete successfully.
Resolving The Problem
This issue has been fixed in Team product installs in the release 7.1.1.6 and 7.1.2.3.
Use these instructions to work around this issue:
Follow the steps in Technote #1328890 Rational 7.0.x product installation hangs on Windows XP:
http://www-01.ibm.com/support/docview.wss?uid=swg21238890
If the steps in Technote #1238890 do not resolve the issue, try this procedure:
- Stop the installation of the Rational product
- Reboot the system.
- Uninstall GSKit if it is installed on the system. To uninstall, run the command:
isuninst -f"C:\Program Files\IBM\GSK7\gsk7BUI.isu" CQLDAP -a
NOTE: If gsk7BUI.isu file does not exist in yourC:\Program Files\IBM\GSK7
folder for any reason, you can copy the attached file intoC:\Program Files\IBM\GSK7
and then run the command mentioned in step 3 above.
- Delete the folder
C:\Program Files\IBM\GSK7
if it exists.
NOTE: Editing the Windows registry incorrectly can cause serious problems that may require you to reinstall your operating system. Edit the Windows registry at your own risk. Before proceeding, review the Microsoft article, 256986 - Description of the Microsoft Windows Registry.
- Open the Windows registry editor using the regedit command. Remove the HKEY_LOCAL_MACHINE\SOFTWARE\IBM\GSK7 key if it exists.
- Download
gsk7bas.exe
andibm.gskit7.ldap_1.0.0.00-7-1-D081104.zip
from this technote to a folder on your computer.
NOTE: In version 7.1.1 and later, the name of gskit zip file name isibm.gskit7.ldap_7.1.1000.0000-7-1-1-D091027.zip
.
- At a command prompt, navigate to the folder where you downloaded the files.
- Enter the command:
gsk7bas <drive>:\gskit
where <drive> is the drive location of the folder. This command extracts the GSKit files into the<drive>:\gskit
folder.
NOTE: If the gsk7bas.exe command fails (for example, this file will not execute on Vista systems), use the files in the gsk7.zip file that is attached to this technote. Extract contents from the gsk7.zip file to the<drive>:\gskit
folder and follow instructions from step 9 on.
- Go to the
<drive>:\gskit
folder and enter the following command:setup CQLDAP
. This command launches the GUI installation of GSKit.
- When prompted, select the default values. Click Install on the last screen to complete the GSKit installation.
- For versions 7.0.0.x and 7.0.1.x: use the section Installation of an MSI-based IBM Rational product to complete your product installation.
- For versions 7.1 and later: use the section Installation of IBM Rational product using Installation Manager to complete your product installation.
You must block the GSKit installation from within the Rational product installation after you have manually installed GSKit. Take the following steps to block the GSKit installation.
- Create a release area for the Rational product if a release area does not already exist. Refer to the Rational product documentation for information about creating a release area.
- In the release area, go to the SETUP folder.
- Locate the .msi file for the Rational product. For example, you select 1033_ClearQuest.msi when installing the IBM Rational ClearQuest US English version.
NOTE: Make the following changes for all .msi files for the Rational product.
- Create a backup of the .msi file.
- Right-click on the .msi file and select Edit with Orca. This opens the .msi file using Microsoft Orca.
- If Orca is not installed, you can obtain Orca from the Microsoft MSDN website: http://msdn.microsoft.com/en-us/library/aa370557(VS.85).aspx.
- Open the Component table and locate the following components:
ClearQuest_GSKitInstall70_3_30_ISFiles_15
ClearQuest_GSKitInstall70_3_30_ISDel_exe
ClearQuest_GSKitInstall70_3_30_setup_dll
ClearQuest_GSKitInstall70_3_30_setup_exe
- In the Condition column for each of these components enter:
1=0
- Save the .msi file.
- Install the Rational product from this release area.
Installation of an IBM Rational product using Installation Manager
After GSKit is manually installed, you must replace the original GSKit installation zip file that is included in the installation package.
1. If
C:\Program Files\IBM\IMShared
does not exist, you must start the installation of the Rational product. The installation fails. When prompted, choose Save downloaded files. Saving the downloaded files creates the IMShared folder and downloads the Rational product zip files to the IMShared folder. NOTE:
C:\Program Files\IBM\IMShared
is the default location for the shared resources directory. This directory might be different for your environment. 2. Go to
C:\Program Files\IBM\IMShared\native
. Create a backup copy of ibm.gskit7.ldap_1.0.0.00-7-1-D081104.zip
(for pre-7.1.1 releases) oribm.gskit7.ldap_7.1.1000.0000-7-1-1-D091027.zip
(for 7.1.1 and higher releases)3. Copy the downloaded GSKit zip file from step 6 of the top section above to
C:\Program Files\IBM\IMShared\native
. NOTE: The downloaded GSKit install.zip file contains a setup.exe file that looks as though it is installing GSKit, but GSKit is not installed. During the installation, Installation Manager continues as if the GSKit installation completed successfully.
4. Start the Rational product installation.
Product Synonym
CQ;ReqPro;PjC
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21395870