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

Fixes are available

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 & Data Platform"},"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"801","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 October 2021

Tips

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

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

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

Fixed component ID

Applicable component levels

R800 PSY

R801 PSY

Document Information

Share your feedback

Need support?