Troubleshooting
Problem
If you used ClearQuest 7.1.x Full-Text Search Administrator tool from DCF download website to deploy ClearQuest 7.1.x Full-Text Search, and you attempt to upgrade to ClearQuest 8.0, your upgrade may fail with the error message that states, "Update failed" and "Failed to extract zip CQ.Full.Text.Search.Admin.Tool.Files".
Cause
The reason for the upgrade failure is due to the fact that ClearQuest 8.0 now includes the Full-Text Search Administrator tool. If you already have a copy of this tool from DCF download website, the Install Manager will not proceed with the upgrade.
Resolving The Problem
To resolve this issue, take the following steps:
- When the Installation Manger reports the error message, make sure the "Keep fetched files" option is selected, click "OK," then click "Finish".
- In your existing ClearQuest 7.1.x home directory, locate a file called cqtsadmin.pl and a directory called CQTsAdmin. The file and directory default location is in "C:\Program Files\IBM\RationalSDLC\ClearQuest\" on Windows and in "/opt/ibm/RationalSDLC/clearquest/" on UNIX.
- Delete or rename the file cqtsadmin.pl and the directory CQTsAdmin. This is the ClearQuest 7.1.x's Full-Text Search Administrator tool that you downloaded from DCF download website.
- In the Installation Manager, re-start the upgrade process by clicking "Update" and the upgrade should now work correctly.
[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21516572