IBM Support

PI08729: ClearQuest Full-Text Search Administrator tool fails on MultiSite databases which have been deactivated

Fixes are available

Rational ClearQuest Fix Pack 10 (8.0.0.10) for 8.0
Rational ClearQuest Fix Pack 3 (8.0.1.3) for 8.0.1
Rational ClearQuest Fix Pack 11 (8.0.0.11) for 8.0
Rational ClearQuest Fix Pack 4 (8.0.1.4) for 8.0.1
Rational ClearQuest Fix Pack 5 (8.0.1.5) for 8.0.1
Rational ClearQuest Fix Pack 12 (8.0.0.12) for 8.0
Rational ClearQuest Fix Pack 6 (8.0.1.6) for 8.0.1
Rational ClearQuest Fix Pack 13 (8.0.0.13) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.0.14) for 8.0
Rational ClearQuest Fix Pack 7 (8.0.1.7) for 8.0.1
Rational ClearQuest Fix Pack 15 (8.0.0.15) for 8.0
Rational ClearQuest Fix Pack 8 (8.0.1.8) for 8.0.1
Rational ClearQuest Fix Pack 16 (8.0.0.16) for 8.0
Rational ClearQuest Fix Pack 9 (8.0.1.9) for 8.0.1
Rational ClearQuest Fix Pack 17 (8.0.0.17) for 8.0
Rational ClearQuest Fix Pack 10 (8.0.1.10) for 8.0.1
Rational ClearQuest Fix Pack 18 (8.0.0.18) for 8.0
Rational ClearQuest Fix Pack 11 (8.0.1.11) for 8.0.1
Rational ClearQuest Fix Pack 19 (8.0.0.19) for 8.0
Rational ClearQuest Fix Pack 12 (8.0.1.12) for 8.0.1
Rational ClearQuest Fix Pack 20 (8.0.0.20) for 8.0
Rational ClearQuest Fix Pack 13 (8.0.1.13) for 8.0.1
Rational ClearQuest Fix Pack 21 (8.0.0.21) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.1.14) for 8.0.1
Rational ClearQuest Fix Pack 15 (8.0.1.15) for 8.0.1
Rational ClearQuest Fix Pack 16 (8.0.1.16) for 8.0.1
Rational ClearQuest Fix Pack 17 (8.0.1.17) for 8.0.1
Rational ClearQuest Fix Pack 18 (8.0.1.18) for 8.0.1
Rational ClearQuest Fix Pack 19 (8.0.1.19) for 8.0.1
Rational ClearQuest Fix Pack 20 (8.0.1.20) for 8.0.1
Rational ClearQuest Fix Pack 21 (8.0.1.21) for 8.0.1
Rational ClearQuest Fix Pack 22 (8.0.1.22) for 8.0.1
Rational ClearQuest Fix Pack 23 (8.0.1.23) for 8.0.1
Rational ClearQuest Fix Pack 24 (8.0.1.24) for 8.0.1
Rational ClearQuest Fix Pack 25 (8.0.1.25) for 8.0.1

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When de-replicating an IBM Rational ClearQuest (CQ) MultiSite
    clan, following the last rmreplica, and deactivate, the
    site-name should be renamed to <local> as it would exist in a CQ
    database that had never been replicated.
    
    This further affects utilities that anticipate <local> and not
    an actual site-name for non-replicated CQ databases.  multiutil
    lsreplica also doesn't indicate that the remaining site is
    deactivated (which is confusing).
    
    Affect:
    This particular use case affects an environment in which the CQ
    clan had been deactivated and attempts were made to setup CQ
    Full-Text-Search (FTS) using the cqtsadmin.pl configuraiton
    utility.
    
    Specifically, when using the utility, the configuring was done
    with typical parameters --init_cq_fts followed by
    --setup_cq_fts.
    
    During the batch indexing phase (using cqtsdbcrawler.pl),
    because the environment was interpreted as non-replicated, it
    attempted to use <local> for the site-name, but in fact the site
    still had a name after it was deactivated.  This caused
    cqtsdbcrawler.pl to fail to find an XML tag matching <local>.
    

Local fix

  • Perform CQ FTS setup as if it were a MultiSite enabled clan in
    terms of the CQTSAdmin XML file configuraiton, requesting
    configuration of this site (which can be counterintuitive since
    MultiSite is not in use).
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * ClearQuest Full-Text Search (FTS) Administrators             *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * ClearQuest Full-Text Search (FTS) Administrator tool fails   *
    * on MultiSite databases which have been deactivated.  The     *
    * failure occurs during the batch indexing phase.              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    

Problem conclusion

  • A fix is available in ClearQuest 8.0.0.10 and  8.0.1.3.
    ClearQuest Full-Text Search (FTS) Administrator tool now
    functions correctly on ClearQuest Multsitie databases which have
    been deactivated .
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI08729

  • Reported component name

    CLEARQUEST WIN

  • Reported component ID

    5724G3600

  • Reported release

    801

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-12-26

  • Closed date

    2014-03-24

  • Last modified date

    2014-10-08

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    CLEARQUEST WIN

  • Fixed component ID

    5724G3600

Applicable component levels

  • R800 PSY

       UP

  • R801 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"801","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
17 October 2021