IBM Support

IBM Rational ClearQuest type-ahead feature: missing file "cqtacfg.pl"

Technote (troubleshooting)


Problem(Abstract)

Installing the "Full-Text Search Server" component of IBM Rational ClearQuest does not install everything needed to configure and maintain the type-ahead feature. Specifically, the cqtacfg.pl file will not be installed and as a result, attempts to set up or maintain type-ahead will fail.

Cause

This is a known defect of IBM Rational ClearQuest Installation Manager which does not install "cqtacfg.pl" if only the "Full-Text Search Server" component is selected. You must select the "ClearQuest Web Server" component to get "cqtacfg.pl" installed.

Diagnosing the problem

When you attempt to configure or maintain IBM Rational ClearQuest type-ahead, using the full-text search command with the "--typeahead_cmd" option, you may get this error:



    Info : Calling: Func_typeahead_cmd()
    Info : ====> Typeahead command ... START
    Info : Typeahead command: 'import c:\typeahead_data.txt'
    Info : chdir -> [C:/Program Files (x86)/IBM/RationalSDLC/ClearQuest/]
    Info : system -> ["C:/Program Files (x86)/IBM/RationalSDLC/ClearQuest/cqperl" "C:/Program Files (x86)/IBM/RationalSDLC/ClearQuest/cqtacfg.pl" import c:\typeahead_data.txt -dbset TypeAhead -userdb SAMPL -username admin -password ********]
    Can't open perl script "C:/Program Files (x86)/IBM/RationalSDLC/ClearQuest/cqtacfg.pl": No such file or directory
    Info : ====> Typeahead command ... DONE

Resolving the problem

There are two ways to resolve this issue:

  • Modify your existing installation and select the "ClearQuest Web Server" component.
  • Copy the missing file, "cqtacfg.pl", from another machine that has "ClearQuest Web Server" installed. The missing file is located in the %CLEARQUEST_HOME% directory. You need to copy it to your ClearQuest Full-Text Search server into the %CLEARQUEST_HOME% directory.

    Attention
    : If you choose this option, you must delete the copied file before you can upgrade ClearQuest.

Document information

More support for: Rational ClearQuest
Type-ahead

Software version: 8.0.1.4

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 1676321

Modified date: 23 June 2014