cqtsadmin.pl 可用于自动完成设置、配置和管理 IBM® Rational® ClearQuest® 全文搜索。
摘要
- cqperl cqtsadmin.pl --username superusername --password password --dbset dbset --userdb connectionname --ftshome cqftshome [options]
描述
cqtsadmin.pl 脚本是全文搜索管理员工具的两个组件之一。另一个组件是 cqtsadmin-dbset-userdb.xml,它是由 cqtsadmin.pl 脚本生成的。cqtsadmin-dbset-userdb.xml 文件提供并保存有关全文搜索部署的数据。编辑 cqtsadmin-dbset-userdb.xml 以完成部署。所有命令行选项在 Windows、UNIX 或 Linux 上均以相同方式运作(UNIX 或 Linux 上不可用的 scrub_oplog 是一个例外)。
要点: 要运行
cqtsadmin.pl 命令,
CQFTS_AppServer_HOME 环境变量必须设置为 WebSphere® Application Server 的安装目录。
在某些情况下,如当您将 ClearQuest 安装到现有 WebSphere Application Server 概要文件中,或当您在远程访问 ClearQuest Web 服务器的单独系统上安装全文搜索功能时,未设置
CQFTS_AppServer_HOME 环境变量,并且会显示类似如下的错误:
Cannot
determine WebSphere’s AppServer home. See the ClearQuest Full-Text
Search Administrator Guide on how to set it via the CQFTS_AppServer_HOME
environment variable.
要解决该问题,请将 CQFTS_AppServer_HOME 变量设置为 WebSphere Application Server 的安装目录。
例如,如下所示设置变量:
- 在 Windows 操作系统上:
- set CQFTS_AppServer_HOME=C:\Program Files\IBM\WebSphere\AppServer
- 在 UNIX 系统和 Linux 操作系统上:
- setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer
要点: dbset、userdb 和 ftshome 自变量区分大小写。您必须在整个 cqtsadmin.pl 脚本使用期间保持全部大写或小写。否则,可能会重新配置全文搜索部署。
ftshome 选项
当您部署全文搜索或引用部署时,所需的命令行选项 ftshome、dbset 和 userdb 自变量定义部署数据所在的位置。以下示例显示了如何在 D 盘 CQ.Search 目录中创建新的 ClearQuest 全文搜索部署。
如果该目录不存在,那么会进行创建。将在前述的目录中创建 TextSearch_SAMPL 子目录。子目录名称是根据您的 ClearQuest 数据库集名称和 ClearQuest 逻辑用户数据库名称而生成的。子目录包含该部署的全文搜索数据。
- cqperl cqtsadmin.pl --username admin --password “” --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles
创建 D:\CQ.Search\TextSearch_SAMPL 目录后,它是 TextSearch 数据库集和 SAMPL 用户数据库的全文搜索部署的位置。与该部署相关的所有数据和设置都放置在该目录中。您发出的使用相同的 ftshome、dbset 和 userdb 自变量值的后续命令均适用于该目录。
要为第二个 ClearQuest 用户数据库部署全文搜索,请指定属于第二个 ClearQuest 用户数据库的所需命令行选项。其他 ClearQuest 用户数据库将部署基于指定的 ftshome 自变量和生成的子目录结构的全文搜索配置。
- cqperl cqtsadmin.pl --username admin --password “” --dbset
TextSearch --userdb PROD --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
manual --fts_was_profile_home D:\FTS.WASprofiles
表 1. 全文搜索部署目录结构目录或文件 |
描述 |
ftshome\dbset_userdb\logs\ |
该目录保存您针对该部署发出的每条命令的日志。参考此目录可获取有关您已使用的命令、使用时间及其状态的历史记录。当 IBM 软件支持部门与您协同处理一个问题时,可能会查看这些日志。密码在日志和屏幕输出中以星号 (*)(而非明文)显示。 |
ftshome\dbset_userdb\Solr\solr\conf\schema.xml |
该文件是配置文件之一,搜索引擎将其用于确定要建立索引和搜索的字段。当发出 cust_solr_files 命令时,会定制该文件中的字段,以便与您的实体文件所指定的记录类型中的字段相匹配。 如果您的 ClearQuest 数据库不是英文的,那么可能要编辑该文件以进一步定制。
请参阅对非英语数据库启用全文搜索以获取更多信息。
|
ftshome\dbset_userdb\Solr\solr\data\index\ |
该目录保存部署的实际索引。 注意: 请勿修改该目录的内容。修改目录可能会有损部署的完整性,可能需要重建索引或重新部署。
|
ftshome\dbset_userdb\AboutThisFTS.txt |
该文件是在全文搜索的初始部署期间一次生成的。它包含与您可能要引用的部署有关的信息。当 IBM 软件支持部门与您协同处理一个问题时,可能会查看该文件。 |
ftshome\dbset_userdb\CQ-dbset-userdb.xml |
该文件是 ClearQuest 全文搜索属性 XML 文件。该文件包含与批处理和更新方式建立索引、搜索服务器、连接概要文件和记录类型有关的数据以及要建立索引和搜索的字段。当 IBM 软件支持部门与您协同处理一个问题时,会查看该文件。 |
ftshome\dbset_userdb\cqtsadmin-dbset-userdb.xml |
该文件包含全文搜索管理员配置。它包含与您的部署有关的数据。大部分数据是在部署期间设置的,但您可能要编辑此文件以定制某些设置。当 IBM 软件支持部门与您协同处理一个问题时,会查看该文件。 |
ftshome\dbset_userdb\Entity-dbset-userdb.txt |
实体文件包含实体类型及其字段的列表,已为其启用搜索。部署期间,您可能要编辑此文件以除去不想搜索的记录类型或字段。完成部署后,请勿修改此文件。当 IBM 软件支持部门与您协同处理一个问题时,会查看该文件。 |
本地语言支持
要在非英语操作系统上使用 cqtsadmin.pl,请将 LANGUAGE 系统环境变量设置为以下某个受支持的值:
- en 英语(美国,缺省)
- de 德语(德国)
- fr 法语(法国)
- it 意大利语(意大利)
- br 葡萄牙语(巴西)
- es 西班牙语(西班牙)
- cn 简体中文(中国)
- hk 繁体中文(中国香港特别行政区)
- tw 繁体中文(中国台湾特别行政区)
- ja 日语(日本)
- ko 朝鲜语(韩国)
如果 LANGUAGE 指定了不受支持的值,cqtsadmin.pl 将失败,并发出错误消息。
选项和参数
cqtsadmin.pl 脚本具有必需的命令行选项和可选命令行选项。每次运行 cqtsadmin.pl 脚本时,您必须提供必需的命令行选项。如果必需选项的任何参数不正确,那么该工具会失败,并显示一条错误消息。
此工具会在采取操作之前针对 ClearQuest 数据库对用户进行认证。
当您运行 cqtsadmin.pl 脚本时,至少应提供一个可选命令行选项。
- 必需的命令行选项
- username superusername
- 具有超级用户特权的 ClearQuest 用户名
- password password
- ClearQuest 用户密码
- dbset dbset
- ClearQuest 数据库集名称。该值区分大小写。
- userdb connectionname
- ClearQuest 用户数据库名称。该值区分大小写。
- ftshome cqftshome
- ClearQuest 全文搜索主目录。该选项包含与该部署相关的所有配置文件以及 Solr 文件、设置和 Lucene 索引。该值区分大小写。
可选的命令行选项
可选命令行选项会对 ClearQuest 全文搜索部署采取特定操作。所有命令都可生成参考、进度、警告、错误和指示输出。指示输出有助于您从错误中恢复。显示的输出还记录在日志目录中。该日志数据在您尝试调试或跟踪对部署采取的操作时很有用,因为您不需要将屏幕输出重定向到文件。通常,命令不会失败。如果失败,大多数命令都会撤销所有更改。如果无法撤销某项更改,那么会显示一条错误消息并提供如何处理的指示信息。您可以多次发出一个可选命令行选项。
如果提供了多个可选的命令行选项,它们将按照在命令行上出现的顺序运行。如果某个选项失败,那么后续命令求值和执行将停止,此工具会退出并显示一条错误消息。可选的命令行选项可分为两类:常用的选项和很少使用的选项。
- add_record_type
- 摘要
- 将一个或多个新的记录类型添加到索引。该选项在命令正在运行时,暂时禁用 ClearQuest Web 用户的全文搜索功能。新记录类型及其相关字段的列表是通过全文搜索管理员配置文件中的 <addRecordType> 标记提供的。
- 用法
- 如果您在初始全文搜索部署期间省略了记录类型,或在初始部署后将新记录类型添加到 ClearQuest 模式并想要搜索新记录类型,那么使用此命令行选项来添加记录类型。如果重命名、添加或除去已建立索引的记录类型中的字段,请使用该命令。要反映索引中的更改情况,请发出 remove_record_type 命令以除去记录类型,然后发出该命令以再次添加。
要添加两个或以上记录类型,请使用分号作为分隔符。例如,以下代码可添加 Customer 和 Product 记录类型。
<newValue
required="no">Customer=CustomerNum,address,phone,product;Product=name,version</newValue>
如果您列出一个没有字段列表的记录类型,那么会添加该记录类型的所有字段。在以下示例中,添加了 Customer 和 Product 记录类型的所有字段。
<newValue required="no">Customer;Product</newValue>
- 效果
- 该命令会影响 ClearQuest 全文搜索索引、ClearQuest 全文搜索属性 XML 文件、实体文件和 Solr schema.xml 文件。
发出该命令之前,请备份您的部署。请在非高峰期运行此选项。该操作非常耗时,且会导致全文搜索短暂停止。
- “有状态”状态
- 该命令是有状态的。如果命令在某个执行点失败,那么您应该能够纠正问题并重新运行命令。操作会从它停止的位置继续。
如果失败,那么错误消息会告诉您如何做。
- 示例
- 您必须添加一个名为 Customer 的新记录类型。
- 编辑 cqtsadmin-TextSearch-SAMPL.xml 文件,并更改 <addRecordType> 标记。
<newValue required="no">Customer=CustomerNum,address,phone,product</newValue>
- 创建备份。
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--backup_fts E:\FTSBackup
- 添加新记录类型。
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--add_record_type
- 编辑 cqtsadmin-TextSearch-SAMPL.xml 文件,然后除去添加到 <addRecordType> 标记的内容。该步骤主要是清除任务。
- archive_fts
- 摘要
- 归档 ClearQuest 全文搜索部署。它禁用了活动的全文搜索部署,然后除去部署的 WebSphere Application
Server 概要文件。它保留所有配置数据和索引。
该选项可用来以新配置重新开始和引用旧配置。
- 用法
- 使用此命令行选项可启动一个新的部署,如果您不再需要部署的全文搜索功能,也可使用该选项。该命令行选项可停止全文搜索服务并归档所有相关资源,如服务和文件。您可以在归档部署后进行引用。
注: 如果您计划将来恢复,请勿使用此命令行选项。请改用 prep_upgd_was_profiles 命令行选项。
- 效果
- 此命令行选项可禁用全文搜索。它还除去和删除在 WebSphere Application
Server 下为该部署使用和设置的所有文件、资源和设置。ftshome 下的部署数据仍保持完整,但重命名为 dbset_userdb.Archived-time-stamp。
- “有状态”状态
- 该选项是无状态的。如果命令在某个执行点失败,那么您可能要手动完成归档。
进度报告和错误消息会指示您如何从错误中恢复。
- 示例
- 以下示例显示了如何归档部署。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --archive_fts
运行脚本后,归档的全文搜索部署称为 D:\CQ.Search\TextSearch_SAMPL.Archived-time-stamp。
- backup_fts destination
- 摘要
- 创建 ClearQuest 全文搜索部署的备份副本。创建备份后,您可以从备份或整个部署恢复数据。为了获得最佳结果,请在运行会显著改变现有部署的命令之前先创建备份。对部署进行备份之前,请确保您在备份位置具有 ftshome 处的部署所使用的相同磁盘空间量。
- 用法
- 使用此命令可在您添加或更新记录类型或者组织策略要求您保持定期备份时创建备份。
注: 请勿使用此命令代替 prep_upgd_was_profiles 命令行选项,该选项还处理每个用户数据库的备份 WebSphere Application Server 概要文件。
- 效果
- 该命令会在进行备份时暂时禁用更新方式索引器。全文搜索在备份期间可能不是最新的。如果您通过 LAN 或 WAN 备份,那么持续时间取决于索引的大小、硬盘驱动器的速度以及网络的速度。
- “有状态”状态
- 该选项是无状态的。如果命令在某个执行点失败,那么根据失败类型和您收到的错误消息,必须手动完成备份或重新开始。最有可能出现的故障是目标设备上没有足够的磁盘空间。备份期间不会更改任何部署数据。
- 示例
- 您要在添加新记录类型之前创建部署的备份。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts
E:\FTSBackup
运行脚本后,归档的全文搜索部署称为 E:\FTSBackup\TextSearch_SAMPL.Backup-time-stamp。
- clear_state
- 摘要
- 重置 cqtsadmin.pl 工具过程中的状态,以便无任何状态。实际上,将清除工具所处的任何状态(可能一直是未完成状态)。
- 用法
- 使用此命令行选项可清除有状态命令的状态,以便您可发出其他命令或重新发出有状态的命令。清除状态的时间取决于您计划清除的有状态命令、有状态命令最后所处的状态以及错误消息和提供的纠正指示信息。
- 效果
- 运行此命令行选项的效果取决于停止的有状态命令以及停止之前命令的完成程度。日志和错误消息指示您是否可以重置状态。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须清除有状态操作的状态,以便可以根据错误消息指示信息,从不可恢复的错误中恢复。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --clear_state
- copy_fts_template
- 摘要
- 复制并设置 ClearQuest 全文搜索缺省模板。当您对数据库(尚未针对全文搜索启用)部署全文搜索时,您必须从干净的缺省模板开始,然后将其复制到 ftshome 目录中。
如果尝试对现有部署使用该命令,那么该命令会失败并返回错误。
- 用法
- 一般来说,您不必直接使用此命令行选项,因为在您发出 init_cq_fts 命令行选项时会对其进行调用。提供此命令行选项,以防您需要调优或调试部署。
- 效果
- 该命令行选项会将全文搜索功能所需的缺省数据复制到指定的 ftshome 目录。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM Rational 客户支持部门已指示您发出此命令,以调试部署问题或定制部署。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --copy_fts_template
- create_fts_was_profile startup-type {
manual | automatic | disabled }
- 摘要
- 创建 ClearQuest 全文搜索 WebSphere Application
Server 概要文件。对于所有新部署都是必需的。
- 用法
每个 ClearQuest 全文搜索部署都必须具有自己的 WebSphere Application Server 概要文件,这是一个针对每个已启用 ClearQuest 全文搜索的用户数据库的 WebSphere Application Server 概要文件。
参数值只配置 Windows 操作系统部署的 Windows 服务状态。在您必须将 WebSphere Application
Server 概要文件配置为在引导时作为守护程序启动的 UNIX 和 Linux 操作系统上,会忽略该值。
WebSphere Application Server 概要文件名称是通过数据库集和用户数据库名称来确定的。但是,您可以使用 <ftsWASProfileName> 标记将其覆盖。
使用 fts_was_profile_home 命令行选项指定创建 WebSphere Application Server 概要文件的位置。如果您未指定该位置,那么使用 %CLEARQUEST_HOME%/cqweb/ 缺省位置。为获得最佳结果,请指定自己的位置。
注: 始终将此命令行选项与 init_cq_fts 命令行选项结合使用,以便根据 ClearQuest 全文搜索部署创建和定制 WebSphere Application
Server 概要文件。
否则,部署将失败,除非之前已使用该工具创建 WebSphere Application Server 概要文件并且正在复用该文件。
- 效果
- 该命令行选项会使用下一个可用端口在 WebSphere Application
Server 下创建一个新的 WebSphere Application Server 概要文件。当操作完成后,磁盘空间利用率大约为 200 MB。如果在 Windows 上该概要文件设置为“自动”,那么当 Windows 重新启动时会自动启动该服务。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您计划为第二个用户数据库部署全文搜索。
数据库集的名称为 MASTR,用户数据库名称为 SAMPL。
- 发出以下命令以设置初始部署。
cqperl
cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb
SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
automatic --fts_was_profile_home D:\FTS.WASprofiles
- 修改实体文件以仅包含您感兴趣的记录类型和字段。
- 发出以下命令以完成部署。
cqperl
cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb
SAMPL --ftshome D:\CQ.Search --setup_cq_fts
- cust_fts_files
- 摘要
- 根据您的用户数据库、实体文件和全文搜索管理员配置文件,定制 ClearQuest 全文搜索属性 XML 文件。当您首次部署 ClearQuest 全文搜索时,必须定制全文搜索属性文件 CQ-dbset-userdb.xml。
- 用法
- 缺省全文搜索模板包含您根据用户数据库定制的通用设置。您必须定制的一个文件是全文搜索属性 XML 文件。该文件基于您的实体文件中所指定的内容包含所有记录类型及其字段的列表。该文件还包含以下参数,如哪个字段用作显示字段,检查对 ClearQuest 用户数据库所做更改的频率以及如何与 ClearQuest 数据库和服务器进行通信。一般来说,您不必直接使用此命令行选项,因为在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令行选项,以防您需要调优或调试部署。
- 效果
- 如果您对部署使用此命令行选项,那么它会覆盖 CQ-dbset-userdb.xml 文件。
手动或通过发出命令对文件所做的所有更改都会丢失。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门要求您调试全文搜索部署问题或定制部署。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --cust_fts_files
- cust_solr_files
- 摘要
- 当您首次部署 ClearQuest 全文搜索时,必须定制基于当前 ClearQuest 实体文件的 Solr 模式文件。
- 用法
- 缺省全文搜索模板是通用的,包含您必须根据用户数据库定制的缺省设置。
您必须定制的一个文件是 Solr schema.xml 文件。
该文件包含您设置为通过使用实体文件进行搜索的所有记录类型的所有字段。一般来说,您不必直接使用此命令行选项,因为在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令行选项,以防您需要调优或调试部署。
- 效果
- 该命令行选项可读取实体文件中的数据,然后定制 Solr schema.xml 文件。如果您对现有部署使用该选项,那么它会重构 schema.xml 文件。
如果在初始部署后更改了实体文件,那么之前的值都会丢失。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门要求您调试全文搜索部署问题或定制部署。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --cust_solr_files
- delete_fts_was_profile
- 摘要
- 要删除 WebSphere Application Server 概要文件或重新开始,请运行此命令行选项。它会删除与该 ClearQuest 全文搜索部署相关的 ClearQuest 全文搜索 WebSphere Application Server 概要文件。
该选项与 archive_fts 的不同之处在于只会删除 WebSphere Application Server 概要文件。但是,不会除去全文搜索主目录和相关元数据。要完全除去 ClearQuest 全文搜索部署,请改用 archive_fts 选项。
- 用法
- 一般来说,请勿直接使用此命令,因为在您发出 archive_fts 命令行选项时会对其进行调用。
如果您需要调优或调试部署,那么会提供此命令。
- 效果
- 将释放 WebSphere 用于该 WebSphere Application
Server 概要文件的资源。如果未通过 disable_cqweb_fts 命令行选项禁用 ClearQuest Web 全文搜索,那么全文搜索会导致错误。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须重命名或更改 WebSphere Application Server 概要文件的位置,但不想完全重新部署全文搜索解决方案。
- 删除 WebSphere Application
Server 概要文件。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --delete_fts_was_profile
- 编辑 cqtsadmin-dbset-userdb.xml 文件,并将 <ftsWASProfileName> 标记从自动生成的缺省名称更改为 WebSphere Application Server 概要文件的新名称。此名称必须是唯一的。否则,命令将会失败。
- 重新创建 WebSphere Application
Server 概要文件。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --create_fts_was_profile
automatic --fts_was_profile_home D:\FTS.WASprofiles
- 如果您还计划更改该 WebSphere Application Server 概要文件的端口号,请编辑 cqtsadmin-dbset-userdb.xml 文件,然后在上述步骤 3 之前更新 <ftsWASProfilePort> 标记中的端口号。或者,发出以下命令来重新定义端口:
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --create_fts_was_profile automatic --fts_was_profile_home
D:\FTS.WASprofiles --was_profile_ports_file D:\CQ.Search\TextSearch_SAMPL\cqftsportdef.props
- disable_cqweb_fts
- 摘要
- 该命令行选项可禁用 ClearQuest Web 中的全文单选按钮,并停止非复制的 ClearQuest 用户数据库中的记录操作日志 (oplog)。
该命令行选项对于在复制环境中创建操作日志创建无效。
注意: 请慎重使用此命令行选项。如果未复制 ClearQuest 数据库,那么会禁用 oplog 记录。
如果在未生成 oplog 时更改 ClearQuest 记录,那么不会对更改的记录重建索引。您将必须对整个用户数据库重建索引。阻止用户访问 ClearQuest 或只允许只读操作,直至重新启用全文搜索功能。
- 用法
- 您不必使用此命令,除非您处于测试环境中,或 IBM 软件支持部门指示您这样做。
- 效果
- 如果未复制数据库,并且禁用“全文”单选按钮,那么会停止 oplog 生成。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM Rational 客户支持部门指示您禁用全文搜索以帮助解决问题。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --disable_cqweb_fts
- enable_cqweb_fts
- 摘要
- 启用 ClearQuest Web 中的全文单选按钮。如果 ClearQuest 数据库未复制并且处于功能级别 7,那么也会启用 oplog 生成。如果复制 ClearQuest 用户数据库,那么不会对 oplog 生成进行任何更改。如果未正确配置您的部署,那么尝试使用全文搜索的用户会收到错误消息。
- 用法
- 您不必使用此命令,除非您处于测试环境中,或 IBM 软件支持部门指示您使用该命令。
- 效果
- 如果数据库未复制并且处于功能级别 7,那么会启动 oplog 生成。将启用 ClearQuest Web 中的“全文”单选按钮。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门指示您启用全文搜索以帮助解决存在的问题。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --enable_cqweb_fts
- fresh_batch_idx
- 摘要
- 该命令行选项使您可在最初建立索引后以批处理方式强制执行完整的重建索引操作。批处理方式建立索引操作是读取为搜索而配置的所有 ClearQuest 记录并将这些记录的数据发送至搜索引擎 (Solr) 以建立索引的过程。批处理方式建立索引操作是作为运行 setup_cq_fts 命令行选项的一部分执行的。发出该命令之前,请发出 stop_update_idx 命令行选项来停止更新方式索引器。如果没有这样做,那么批处理方式索引器可能会替换由更新方式索引器建立索引的更新记录的数据。重建索引完成后,您的索引会分段。通常,该分段不会影响搜索性能。但是,索引大小最多可能增长到当前大小的两倍。要优化索引并减小其大小,请运行 optimize_idx 命令行选项。
- 用法
- 您不必使用此命令,除非您处于测试环境中,或 IBM 软件支持部门指示您这样做。
- 效果
- 将更新搜索索引。它的大小会增长到当前大小的两倍。因此,在使用该命令之前,请确保有足够的磁盘空间。重建索引时,由于禁用更新方式索引器,因此搜索结果可能不完整。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门指示您对可搜索记录完全重建索引。
- 停止更新方式索引器。
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
- 强制执行批处理方式重建索引操作。
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --fresh_batch_idx
- 运行索引优化。
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--optimize_idx
- 启用更新方式索引器。
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
注: 您可以将这些步骤组合成一条命令。您可能要这样做,其原因是对许多记录重建索引要花费很长时间。
cqperl cqtsadmin.pl
--username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome
D:\CQ.Search -- stop_update_idx --fresh_batch_idx --optimize_idx --start_update_id
- fresh_update_idx
- 摘要
- 强制通过更新方式索引器对所有记录的 oplog 记录更改完全重建索引。请小心使用此选项。
更新方式索引器是单线程的。此操作会花费很长时间,特别是在 ClearQuest 数据库包含很多 oplog 的情况下。
更新方式建立索引操作是监控 ClearQuest 数据库以获取为搜索而配置的记录类型的更改的过程。监控操作通过检查 ClearQuest 数据库中的 oplog 来完成。更新方式建立索引操作是作为 setup_cq_fts 命令行选项的一部分而启用的。与 fresh_batch_idx 命令行选项不同,该命令不需要停止更新方式索引器。针对已填充的索引完成该命令后,您的索引会分段。通常,该分段不会影响搜索性能。但是,索引大小最多可能增长到当前大小的两倍。要优化索引并减小其大小,请运行 optimize_idx 命令行选项。请慎重考虑是否从记录的第一个 oplog 启动更新方式索引器。随着时间的推移,您针对 ClearQuest 记录中采取的每个操作都积累了一个 oplog,您可能不想从记录的第一个 oplog 建立索引,特别是在一直未清除 oplog 的情况下。该命令旨在用于测试环境,并用于和 IBM Rational 客户支持部门一起调试全文搜索部署问题。
- 用法
- 您不必使用此命令,除非您处于测试环境中,或 IBM 软件支持部门指示您这样做。
- 效果
- 将更新搜索索引。它的大小最多可增长到当前大小的两倍。在使用此命令之前,请确保有足够的磁盘空间。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门指示您强制执行更新方式索引器的重建索引操作。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --fresh_update_idx
- fts_was_profile_home destination
- 摘要
- 将此命令行选项与 create_fts_was_profile 命令行选项结合使用,以指定将创建该 ClearQuest 全文搜索部署的 WebSphere Application Server 概要文件的位置。如果跳过该选项,那么使用缺省位置 ${CLEARQUEST_HOME}/cqweb/。由于 ClearQuest 安装目录中创建的其他文件可能会阻止 ClearQuest 安装(如卸载或升级),缺省位置不一定合适。该命令行选项还可以与 restore_was_profile 命令行选项结合使用。您可以指定一个与将创建全文搜索 WebSphere Application
Server 概要文件的原始位置不同的位置。
- 用法
- 您想为 ClearQuest 数据库部署 ClearQuest 全文搜索,并且不想使用缺省位置来创建和存储与部署相关的 WebSphere 文件。将此命令行选项与 create_fts_was_profile 命令行选项结合使用,以指定可创建全文搜索 WebSphere Application Server 概要文件的位置。如果您在该机器上具有多个全文搜索部署,请对所有部署使用相同的位置,以便所有 WebSphere Application Server 概要文件都位于相同位置。
- 效果
- 将在 fts_was_profile_home 位置创建一个目录(如果它不存在)。
它包含与 WebSphere Application Server 概要文件相关的数据。将在该目录内创建一个子目录。它表示 WebSphere Application Server 概要文件名称,即 cqsearchprofile_dbset_userdb 或 cqfts_dbset_userdb。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误或路径无效(如盘符不存在或者 Unix 或 Linux 安装路径不存在),否则该命令从不会失败。
- 示例
- 您需要部署 ClearQuest 全文搜索。您不想对 WebSphere Application Server 概要文件使用缺省位置。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
manual --fts_was_profile_home D:\FTS.WASprofiles
- gather_diagnostic_data
- 摘要
- 收集有助于 IBM 软件支持部门诊断潜在 ClearQuest 全文搜索问题的数据。如果您需要支持,请运行该诊断命令行选项,并发送通过该命令行选项收集的数据,以便于迅速获得帮助。该命令行选项收集与 ClearQuest 全文搜索部署相关的数据。将可能指示您发送给 IBM 软件支持部门的数据复制到目录中。发送数据之前,请验证其中是否包含隐私信息。通常,最敏感的数据是您为搜索而启用的记录类型名称以及您的组织提交的搜索项历史记录。历史记录是 WebSphere 针对 WebSphere Application Server 概要文件所维护的日志。在将输出发送至屏幕或日志文件时,会将密码转换为星号。密码不会以明文方式存储。
- 用法
- 使用此命令可收集诊断数据并将其发送给 IBM 软件支持部门,以帮助您诊断全文搜索相关问题。
- 效果
- 数据和配置设置都未更改。将使用您的部署的名称和时间戳记创建一个新目录。
诊断数据的累积大小会因部署中日志的总大小而异(通常为兆字节)。
实际索引不属于诊断数据。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门指示您发送诊断数据以帮助解决全文搜索相关问题。以下命令可创建诊断数据,并将其放置在 D:\CQ.Search\TextSearch_SAMPL.Diag-time-stamp 文件中。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --gather_diagnostic_data
- gen_entity_file
- 摘要
- 该命令行选项生成实体文件,其中包含提交至 ClearQuest 数据库的所有记录类型。缺省情况下,该实体文件包含 ClearQuest 模式的所有记录类型及其所有字段。它们是全文搜索的候选项。您可以定制文件以只选择计划建立索引的记录类型和相关字段。当您首次针对 ClearQuest 用户数据库部署全文搜索时,您必须具有包含 ClearQuest 用户数据库模式所引用的所有记录类型及其字段的实体文件。该实体文件用作输入,以生成全文搜索属性 XML 文件、Solr 中间 XML 文件以及 Solr schema.xml 文件。
- 用法
- 一般来说,您不必直接使用此命令。在您发出 init_cq_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 如果您对现有部署使用此命令,那么它会覆盖 Entity-dbset-userdb.txt 文件,您会丢失所做的编辑。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM Rational 软件支持部门已指示您调试全文搜索部署问题或定制部署。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gen_entity_file
- gen_fts_files
- 摘要
- 该命令行选项根据您的用户数据库、实体文件和全文搜索管理员配置文件,生成 ClearQuest 全文搜索设置文件。当您首次对用户数据库部署全文搜索时,必须生成全文搜索属性 XML 文件。该文件包含与您的部署设置有关的信息,如建立索引的频率、建立索引的批处理大小以及搜索服务器信息。
- 用法
- 一般来说,您无需直接使用此命令行选项。
在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令行选项,以防您需要调优或调试部署。
- 效果
- 如果您对现有部署使用此命令,那么它会覆盖 Entity-dbset-userdb.txt、Solr-dbset-userdb.txt 和 CQ-dbset-userdb.xml 文件,您会丢失对其所做的编辑。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM Rational 软件支持部门已指示您调试全文搜索部署问题或定制部署。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --gen_fts_file
- help
- 摘要
- 显示帮助文本,然后关闭。
- 用法
- 您熟悉 cqtsadmin.pl 脚本,但是要快速回顾可用命令。
- 效果
- 无。该命令不更改任何数据,无需认证即可运行。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您需要可用命令的列表。
cqperl cqtsadmin.pl --help
- init_cq_fts
- 摘要
复制 ClearQuest 全文搜索缺省模板,然后生成缺省实体文件。
实际上,它运行
copy_fts_template 和
gen_entity_file 选项。
该命令是您部署全文搜索时最先运行的命令之一。它会在
ftshome 目录中创建一个
dbset_userdb 目录。将与该部署相关的所有缺省数据和设置都放置在该目录中。
该选项创建的关键文件之一是
Entity-dbset-userdb.txt 实体文件。它放置在您的
ftshome 目录中。
定制部署时,您决定是使其保持不变,还是除去不想被搜索的记录类型和字段。创建的另一个文件为
cqftsadmin-dbset-userdb.xml 全文搜索管理员配置文件。该文件包含特定于您的部署和环境的其他缺省设置,如服务器名称、WebSphere Application Server 概要文件名称、建立索引的批处理大小以及建立索引的频率。
注: 该命令行选项通常与 create_fts_was_profile 和 fts_was_profile_home 命令行选项一起运行,以便为该部署创建新的 WebSphere Application
Server 概要文件。否则,ClearQuest 全文搜索部署会失败,除非您复用之前为全文搜索部署的 WebSphere Application Server 概要文件。
- 用法
- 使用此命令可预配置全文搜索部署。
它会创建 ftshome 目录、将缺省文件复制到该目录以及设置缺省值。在完成部署之前,通常可以定制实体文件。
- 效果
- 该命令会创建一个新的 ftshome 目录(如果它不存在),并将您的部署的缺省数据和设置复制到该目录中。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您想针对一个用户数据库启动新的全文搜索部署。
- 运行该命令以预配置您的部署。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile
Automatic --fts_was_profile_home D:\CQFTS.WASprofiles
- 编辑该部署实体文件,以除去用户不能够搜索的记录类型或字段。另外,在每个记录类型的字段前添加 & 符号。这将是全文搜索的匹配项结果集中的显示字段。
D:\CQ.Search\TextSerch_SAMPL\Entity-TextSearch-SAMPL.txt
- 通过运行以下命令完成部署:
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --setup_cq_fts
- lock_cq_fts
- 摘要
该命令行选项可锁定此 ClearQuest 全文搜索部署,以便只有非破坏性的 cqtsadmin.pl 命令可以运行。除 gather_diagnostic_data 和 help 之外的其他所有命令都将被禁用。使用 unlock_cq_fts 选项以再次启用命令。
- 用法
- 部署全文搜索后,发出该命令以锁定部署,防止无意的修改。此锁定功能较弱。具有正确文件系统访问权或 ClearQuest 特权的任何人都可以解锁部署。
该命令的目的是使管理员可发出信号,表明部署已完成。必须小心谨慎地沟通和发出进一步的修改。
- 效果
- 无。全文搜索部署数据和设置不受影响。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您已完成部署,想要确保部署未被修改。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --lock_cq_fts
- optimize_idx
- 摘要
该命令行选项对索引进行重组。优化需要的可用磁盘空间至少是您当前索引大小的 1.5 倍。例如,如果索引使用 2 GB 磁盘空间,那么您必须具有 3 GB 的可用磁盘空间来运行此命令。
- 用法
在搜索索引中添加或修改记录时,索引可能会分段。分段的索引会比未分段的索引更大。可能还会造成性能略有下降。要减小索引大小并恢复性能,您每年至少对索引进行一次优化。如果 ClearQuest 数据库经历修改、添加或删除记录方面的大量活动,请更频繁地对其进行优化。
发出此命令之前,请确保您具有足够的可用磁盘空间。
否则,优化将失败,但您的原始索引仍将保持完整。由于优化期间会重写初始索引,因此需要可用磁盘空间。旧的索引将一直保存到重新生成新索引之时。
优化索引所需的时间取决于索引的大小以及硬盘驱动器和 I/O 的速度。针对 2 GB 索引,优化会花费几小时时间。
当优化正在进行时,所有全文搜索服务都可用,包括更新方式索引器。但是,可能会造成性能略有下降。请在非高峰期计划索引优化。
- 效果
- 将重写您的搜索索引。如果优化期间出现 I/O 错误,那么极有可能是因为磁盘空间不足。
原始索引仍然是完整的。原始索引可能更大,但在其优化完成后,它将恢复为其原始大小。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须优化搜索索引。
cqperl cqtsadmin.pl
--username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome
D:\CQ.Search --optimize_idx
- prep_upgd_was_profiles destination
- 摘要
- 计划停机期间,该命令行选项为 ClearQuest 修改或重新安装做准备。使用该命令创建的备份将全文搜索部署(包括 WebSphere Application Server 概要文件)恢复至原始状态。
- 用法
部署了全文搜索的所有用户数据库都需要相应的 WebSphere Application
Server 概要文件。当您升级、修改或重新安装 ClearQuest 时,可能不会保留这些概要文件。
通过该准备和恢复过程,只能将 ClearQuest 修订包中提供的更新纳入到 ClearQuest 全文搜索部署中。当您将该命令行选项与 restore_was_profiles 命令行选项一起使用时,它会创建备份数据、选择性删除 WebSphere Application Server 概要文件,然后从备份数据路径(在完成升级或重新安装 ClearQuest 之后调用时指定的)中恢复删除的 WebSphere Application Server 概要文件。
要删除 ClearQuest WebSphere Application Server 概要文件,您必须针对一个 cqtsadmin-dbset-userdb.xml 全文搜索管理员配置文件将 <deleteFtsWASProfiles> 标记值从 FALSE 更改为 TRUE。确保您运行命令时引用该已修改的部署。否则,将不能正确除去 WebSphere Application Server 概要文件,为恢复和升级做准备。
可对任何 dbset、userdb 或 ftshome 运行该命令行选项。该选项与特定全文搜索部署没有关联。它会评估和影响主机上任何
ftshome 目录中的所有 ClearQuest 全文搜索部署。
注: 如果在当前机器上具有多个全文搜索部署,那么该命令行选项和 restore_was_profiles 命令行选项只能运行一次。这两条命令会对当前机器上的所有全文搜索部署起作用。
注意: 当升级 ClearQuest 时,必须运行此命令行选项并将 <deleteFtsWASProfiles> 标记设置为 TRUE。否则,可能会导致未完成全文搜索部署升级。升级完成及运行 restore_was_profiles 命令行选项之后,将该选项更改为 FALSE
- 效果
- 如果针对一个 cqtsadmin-dbset-userdb.xml 全文搜索管理员配置文件将 <deleteFtsWASProfiles> 标记设置为 TRUE,那么会创建 ClearQuest 全文搜索 WebSphere Application Server 概要文件的备份数据,并删除这些 WebSphere Application Server 概要文件。所有全文搜索请求都将失败,直至恢复这些概要文件为止。但是,单选按钮仍启用,并且继续针对非复制功能级别 7 用户数据库创建操作日志。此类型失败是可接受的,因为您只能在升级、修改或重新安装 ClearQuest 时使用该命令行选项。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您将要升级、修改或重新安装 ClearQuest。开始安装之前,您必须备份该主机上的所有 WebSphere Application Server 概要文件。
- 编辑单个全文搜索部署的 cqtsadmin-dbset-userdb.xml 文件,并如下所示更改 <deleteFtsWASProfiles> XML 标记,以允许备份和删除 WebSphere Application
Server 概要文件。
<newValue
required="no">true</newValue>
保存更改。在该示例中,使用 cqtsadmin-TextSearch-SAMPL.xml 文件。
- 发出以下命令行选项以创建备份数据和删除 WebSphere Application
Server 概要文件:
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --prep_upgd_was_profiles
E:\FTSBackupWASProfiles
- 将 <deleteFtsWASProfiles> XML 标记值更改为 FALSE 或除去 TRUE 值。
- 完成 ClearQuest 升级、全文搜索功能修改或重新安装。
- 发出以下命令行选项,以从备份数据恢复所有全文搜索部署和删除的 WebSphere Application Server 概要文件。有以下两种可能的方案:
- 如果您遇到问题,请对相同 dbset、userdb 和 ftshome 运行 gather_diagnostic_data 命令行选项,以向 IBM Rational 支持部门提供数据。
注意: 如果您定制了 Solr schema.xml 文件以支持除英语以外的语言,或对 Solr 分析器或记号化器进行更改,那么这些更改将丢失。要保存更改,请记录您的更改,并在完成升级后再次引入这些更改。对 schema.xml 文件进行更改后,停止并启动全文搜索 WebSphere Application Server 概要文件以使更改生效。
- remove_lucene_idx_lock
- 摘要
- 使用此命令可除去对搜索索引的 Lucene 锁定。
Lucene 搜索引擎使用锁定来同步更新。在极少数情况下,如果在获取锁定时 Lucene 或服务器遇到错误并且 Lucene 无法恢复,那么锁定仍处于活动状态。当锁定处于活动状态时,无法更新搜索索引。因此,无任何 ClearQuest 记录可添加或更新。针对索引的全文搜索将继续工作,除非索引存在完整性问题。要从此类型锁定中恢复,请通过发出 stop_fts_was_profile 和 start_fts_was_profile 命令行选项重新启动 WebSphere Application Server 概要文件。当重新启动服务时,会中断全文搜索。
- 用法
- 您注意到新添加的 ClearQuest 记录未包含在搜索结果中。您检查 WebSphere Application Server 概要文件日志,发现 Lucene 正在报告错误,表明已锁定索引。
您使用该命令清除锁定。
- 效果
- 无。全文搜索部署数据和设置不受影响。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您想要除去 Lucene 索引锁定。一步即可停止、启动和解锁索引:
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--stop_fts_was_profile --remove_lucene_idx_lock --start_fts_was_profile
- remove_record_type
- 摘要
- 该命令可从搜索索引中除去一个或多个 ClearQuest 记录类型。随后的搜索将找不到所除去记录类型的匹配项。该命令用于您必须通过 cqtsadmin-dbset-userdb.xml 全文搜索管理员配置文件提供的数据。在配置文件的 <removeRecordType> XML 标记中,列出要除去的记录类型的名称。要除去多个记录类型,请使用分号分隔名称。
该命令在状态中运行。如果在其中某个状态期间出错,那么错误消息会解释如何纠正错误。
重新启动命令时,它会从出错的位置继续。
在发出该命令之前创建部署的备份。除去记录类型只会从搜索索引中除去与该记录类型相关的数据。ClearQuest 本身不受该命令影响。
- 用法
- 部署全文搜索后,会要求您不再允许对某些记录类型进行搜索。该命令会从索引中除去这些记录类型,使这些记录类型不可搜索。
在 ClearQuest 模式中更改已建立索引的记录类型时,也可使用此命令。
也许您会添加新的字段或重命名字段。要在搜索索引中反映此更改,请使用 remove_record_type 和 add_record_type 命令行选项。
- 效果
- 您的搜索索引会改变,导致对所除去记录类型的任何引用都不再存在。因此,除去的记录类型不可搜索。从全文搜索属性 XML 文件和实体文件中除去了对这些记录类型的引用。在运行该命令时,搜索服务会在重新启动 WebSphere Application
Server 概要文件时暂时中断。在服务器宕机时,用户可能会收到错误。另外,在该命令完成后打开 ClearQuest 会话的用户仍会在 ClearQuest Web 的搜索范围中看到除去的记录类型。
如果他们尝试搜索这些记录类型,那么将不会有匹配项。
为了使搜索范围反映搜索索引,这些用户必须再次登录。该命令将导致索引分段。在运行该命令后优化索引,以使索引大小和性能都处于最佳状态。
- “有状态”状态
- 该命令是有状态的。如果命令在某个执行点失败,那么通常您可以纠正问题并重新运行命令。它将从停止的位置继续。如果失败,那么错误消息会说明要执行的操作。
- 示例
- 您必须从搜索索引中除去两个记录类型。
- 在 cqtsadmin-TextSearch-SAMPL.xml 文件的 <removeRecordType> XML 标记中,指定要除去的记录类型。使用分号分隔记录类型。
<newValue
required="no">Email_Rule;Customer</newValue>
- 运行以下命令以除去两个记录类型。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --remove_record_type
- 在 cqtsadmin-TextSearch-SAMPL.xml 文件中,除去您添加到 <removeRecordType>
XML 标记的两个记录类型。如果您随后添加这些除去的记录类型,那么该内务处理任务可防止意外除去操作。
- repair_records
- 摘要
- 如果批处理方式或更新方式建立索引过程出现了一些问题,这些问题阻止读取记录或将记录发送至服务器以建立索引,那么会创建一个修复文件。该修复文件列出了失败记录的 ClearQuest 记录标识。
该命令将读取修复文件并一次对一条记录重建索引,以减少出现其他故障的机率。
- 用法
- 作为全文搜索部署的一部分,在批处理方式建立索引操作完成时运行此命令,以对尚未建立索引的记录建立索引。您应该定期检查 ftshome 目录,以获取在更新方式建立索引操作期间未建立索引的记录。如果未对记录建立索引,那么您会看到使用命名约定 record-type-nametime-stamp.xml 的文件。
以下示例显示了未建立索引的文件:Defect1222923990646.xml。
如果您看到这些类型的文件,请运行此命令以对记录建立索引。
- 效果
- 您的搜索索引包含来自新建立索引的记录中的数据。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须对在批处理方式建立索引操作或更新方式建立索引操作期间未建立索引的记录建立索引。
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--repair_records
- restore_was_profiles path-to-backup
- 摘要
- 使用该命令行选项,以从通过 prep_upgd_was_profiles 命令行选项创建的备份数据中恢复 ClearQuest 全文搜索 WebSphere Application Server 概要文件。
- 用法
- 当您升级、修改或卸载 ClearQuest 时,可能不会保留 WebSphere Application Server 概要文件。
当您应用 ClearQuest 修订包后,全文搜索修订必须纳入当前 WebSphere Application Server 概要文件中,所有这些都由准备/恢复过程来处理。
在升级、修改或重新安装 ClearQuest 之后,该命令行选项会恢复通过 prep_upgd_was_profiles 命令行选项创建的所有 ClearQuest 全文搜索 WebSphere Application Server 概要文件。
如果您尝试恢复已存在或未使用 prep_upgd_was_profiles 命令行选项先备份并删除的 ClearQuest 全文搜索 WebSphere Application
Server 概要文件,那么该命令行选项会失败。
您可以对任何 dbset、userdb 或 ftshome 运行该命令行选项。这将影响该主机上任何 WebSphere Application Server 概要文件主目录中的所有全文搜索部署和 WebSphere Application Server 概要文件。
注: 您可以将该命令行选项与 fts_was_profile_home 命令行选项结合使用,以指定 WebSphere Application Server 概要文件相对其原始目标的合并后的新目标。当您从 ClearQuest 7.0(所有发行版)升级时使用此切换操作,以确保使用新的 WebSphere Application
Server 概要文件主目录。
- 效果
- 将重新创建全文搜索 WebSphere Application Server 概要文件并将其恢复至原始设置和位置,或者将它们合并到指定的 fts_was_profile_home 目录路径中。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 为准备升级 ClearQuest,您运行了 prep_upgd_was_profiles命令行选项,并将 <deleteFtsWASProfiles> 标记设置为 TRUE。
升级了 ClearQuest 之后,您必须从备份数据中恢复所有 ClearQuest 全文搜索 WebSphere Application
Server 概要文件。并且,您想要使用 fts_was_profile_home 命令行选项将 WebSphere Application Server 概要文件合并到一个新目录中。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles
E:\FTSBackupWASProfiles [ --fts_was_profile_home D:\FTS.WASprofiles
]
注意: 如果您定制了 Solr schema.xml 文件以支持除英语以外的语言,或对 Solr 分析器或记号化器进行更改,那么这些更改将丢失。要保存更改,请记录您的更改,并在完成升级后再次引入这些更改。对 schema.xml 文件进行更改后,停止并启动全文搜索 WebSphere Application Server 概要文件以使更改生效。
- run_batch_idx
- 摘要
- 此命令启动批处理方式索引器。它会对为搜索而配置的所有 ClearQuest 记录建立索引。
如果批处理大小或线程数设置太高,或 ClearQuest 记录包含大量数据,那么该命令可能失败。最常见的故障是内存不足错误。在此情况下,请减小批处理大小或所使用的线程数。这会导致建立索引的时间增加。或者,您可以针对批处理方式索引器(使用 <batchIndexJVMParm> XML 标记)和搜索服务器的内存(使用 <ftsWASProfileMaxHeapSize> XML 标记)增加 Java™ 虚拟机 (JVM) 内存。如果必须增加内存,那么这是在批处理索引器完成前的临时需求。IBM Rational 客户支持部门可帮助您确定这些环境中的最佳操作。如果命令在完成之前停止,那么可以再次启动。它将从停止的位置恢复运行。
- 用法
- 您不必直接使用此命令。在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 该命令会针对您的 ClearQuest 数据库运行 ClearQuest SQL 查询。
然后,它会将找到的记录发送至 Solr 搜索服务器以建立索引。实际上,在运行该命令时,ClearQuest 数据库服务器正忙于将数据发送至 ClearQuest 全文搜索,并且会更新搜索索引。如果您需要运行该命令,请在非高峰期运行,以减轻负载或对数据库服务器的性能产生的影响。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误、内存不足错误或意外配置错误,否则该命令从不会失败。
- 示例
- 您必须对所有 ClearQuest 记录建立索引。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --run_batch_idx
- scrub_oplog before-date
- 摘要
- 该命令用于擦除来自非复制 ClearQuest 用户数据库的 oplog。ClearQuest 生成 oplog 以跟踪您对记录所做的更改。ClearQuest 全文搜索在更新方式建立索引操作期间监控 oplog,以使搜索索引与这些更改同步。
oplog 是临时数据。您不必无限期保存。为防止非复制数据库中的 oplog 持续增长,可不定期擦除旧的 oplog,但尽可能降低频率。根据 oplog 创建速度执行擦除操作。
如果复制了 ClearQuest 用户数据库,请使用复制工具和策略来擦除 oplog。如果尝试对复制的数据库使用该命令,那么该命令会失败,并返回一条错误消息,指示您使用复制工具。
从不擦除所有 oplog,特别是在有些 oplog 尚未由更新方式索引器处理的情况下。否则,您的搜索索引将不会与 ClearQuest 记录同步。
搜索可能不准确或不完整。该方案需要以批处理方式重建索引。
积极地擦除 oplog(其中更新方式索引器吞吐量不足)可能会导致索引不正确和缺少匹配项。确保更新方式索引器处于最新状态,只擦除一个月以上的 oplog,否则请勿擦除 oplog。
- 用法
- 为节省数据库空间和清除未使用的数据,您可能必须擦除非复制的 ClearQuest 用户数据库中的 oplog。如果复制了 ClearQuest 数据库,请勿使用此命令。
- 效果
- 将删除在指定日期之前创建的 oplog 表中的 ClearQuest oplog。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 作为 ClearQuest 管理员,您计划定期擦除旧的 oplog。有关受支持日期格式的信息,请参阅 scruboplog 命令参考信息。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --scrub_oplog "31-Oct-2009"
- setup_cq_fts
- 摘要
- 该命令用于完成全文搜索部署。
首先,该选项根据您的全文搜索管理员配置文件、ClearQuest 数据库和操作系统来定制和配置以下文件:
- 实体文件
- 全文搜索属性 XML 文件
- Solr schema.xml 文件
- 第二,通过启用全文单选按钮,启用 ClearQuest Web 中的 ClearQuest 全文搜索。如果 ClearQuest 数据库处于功能级别 7 并且未复制,那么会开始生成 oplog。第三,它针对为在实体文件中进行搜索而设置的记录类型,通过对所有 ClearQuest 记录建立索引来启动批处理方式建立索引操作。
最后,它启用更新方式索引建立操作,以完成部署。
该命令会保持其状态。如果在完成之前出错,那么会设置状态,您必须先纠正错误,然后才可继续。
错误消息和日志包含有关如何从错误恢复的指示信息。恢复步骤取决于错误和发生错误时所处的状态。
- 用法
- 使用此命令可完成全文搜索部署。
通常,在定制实体文件后运行此命令。
运行该命令时,启用 ClearQuest Web 中的全文单选按钮。
再次登录的用户能够进行搜索。直到完成部署,搜索结果才是完整的。尤其是在未复制 ClearQuest 数据库的情况下,必须启用该单选按钮,因为必须生成 oplog,以捕获批处理方式建立索引操作期间和之后出现的所有记录更改。
如果您增加了缺省 JVM 内存设置,那么部署了全文搜索的计算机会由于批处理方式建立索引操作严重依赖于处理器、I/O 和内存而经历高利用率。根据您通过增加批处理大小和线程数来设置批处理方式索引器的程度,在批处理方式建立索引操作期间,ClearQuest 数据库的利用率可能会很高。
- 效果
- 将在 ftshome 目录中创建一些文件。会创建索引。将启用 WebSphere Application
Server 下的搜索服务。并且,会更新 ClearQuest 数据库以包含全文搜索属性 XML 文件。如果未复制 ClearQuest 数据库,那么将启用操作日志创建。所复制的 ClearQuest 用户数据库将继续创建操作日志。
- “有状态”状态
- 该命令是有状态的。如果命令在某个执行点失败,那么您应该能够纠正问题并重新运行命令。该命令从它停止的位置继续。如果失败,那么错误消息会告诉您如何做。如果在完成之前出错,那么会设置状态,您必须先纠正错误,然后才可继续。
错误消息和日志包含有关如何从错误恢复的指示信息。恢复步骤取决于错误和发生错误时所处的状态。
- 示例
- 您已运行 init_cq_fts 命令行选项,并编辑了实体文件。现在,必须完成部署。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --setup_cq_fts
- set_was_max_mem
- 摘要
- 该命令用于设置 WebSphere Application Server 概要文件可以使用的最大 JVM 内存。缺省值为 300 MB,在以下情况下,这对于批处理方式建立索引操作可能太小:
- 已增加批处理大小
- 已增加线程数
- ClearQuest 记录类型很复杂
该命令可从配置文件中的 <ftsWASProfileMaxHeapSize>
XML 标记读取内存设置。然后,将 JVM 内存设置为该值。
- 用法
- 如果批处理方式建立索引操作由于 WebSphere Application Server 概要文件服务器报告内存不足错误而失败,那么内存设置可能太低。
采取以下某个操作,以从内存不足错误中恢复:
- 减小批处理大小和线程数,以增加完成建立索引操作所需的时间。
- 临时增加 JVM 内存。通常应将 JVM 最大内存设置高一些,直至完成批处理方式建立索引操作。
- 效果
- WebSphere Application Server 概要文件的 JVM 最大内存设置更改为新值。实际上,会将更多系统内存分配给 WebSphere Application Server 概要文件。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 当建立索引时,您从 WebSphere Application Server 概要文件收到内存不足错误。必须先解决该问题,然后才可继续。
- 在 cqtsadmin-TextSearch-SAMPL.xml 文件的 <ftsWASProfileMaxHeapSize> XML 标记中,将 JVM 内存设置为 1.5 GB。
<newValue
required="no">1536</newValue>
- 运行该命令,以设置新的 JVM 内存设置:
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --set_was_max_mem
- set_solr_home
- 摘要
- 该命令用于设置 WebSphere Application Server 下的 Solr 主目录。
每个部署都有自己的 schema.xml 配置文件和索引。如果未正确指定 Solr 主目录或指定错误的位置,那么可能无法启动 WebSphere Application Server 全文搜索概要文件。如果无法启动 WebSphere Application Server 全文搜索概要文件,那么会将错误记录到 %your-WAS-profile-home%/<cqfts>_<dbset>_<userdb>/logs/server1/logs/ 路径中相应的全文搜索 WebSphere Application Server 概要文件日志目录中。
- 用法
- 您不必直接使用此命令。在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 部署的 WebSphere Application Server 概要文件的 JVM 属性已更改,以便设置 Solr 主目录环境变量。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM Rational 软件支持部门已指示您使用该命令来调试全文搜索部署问题或定制部署。
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--set_solr_home
- show_scenarios [ID | all]
- 摘要
- 该命令用于显示方案列表,包含有关如何使用 cqtsadmin.pl 工具的示例。这些方案是信息中心内所列方案的简略形式,可能不是完整的列表或一对一匹配。
- 用法
- 使用此命令行选项可显示 cqtsadmin.pl 工具的最常用方案列表。发出该命令时不使用参数以查看方案标识和标题。使用方案标识参数发出该命令,可查看方案的全文。使用 all 参数发出该命令,可查看方案的完整列表,每个方案都包含标识、标题和全文描述。
- 效果
- 全文搜索部署数据和设置不受影响。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您将要使用 cqtsadmn.pl 工具来完成任务,但不记得如何使用。可使用该命令行选项列出方案标题及其标识。然后,再次运行该命令,并传递您感兴趣的方案的标识,以查看其全文。
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--show_scenarios
- start_fts_was_profile
- 摘要
- 该命令用于启动全文搜索 WebSphere Application Server 概要文件服务。
必须为需要服务的搜索请求启动全文搜索 WebSphere Application
Server 概要文件。
同时还必须为更新方式索引器启动概要文件,以开始检查新记录或已更新的记录,并将其发送至搜索引擎以建立索引。
- 用法
- 您不必直接使用此命令。在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 如果全文搜索 WebSphere Application
Server 概要文件已停止,那么该命令将启动,这会导致暂时利用内存和处理器资源。如果启用搜索服务和更新方式索引器,那么它们开始运行。如果已启动 WebSphere Application Server 概要文件,那么不做任何更改。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误、Solr 服务器故障或 WebSphere Application Server 概要文件启动失败(通常是由于设置问题),否则该命令从不会失败。
- 示例
- IBM 软件支持部门指示您启动搜索 WebSphere Application
Server 概要文件。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_fts_was_profile
- start_update_idx
- 摘要
- 该命令用于启用和启动更新方式索引器,它是在 WebSphere Application
Server 概要文件下运行的。更新方式索引器会将搜索索引与对 ClearQuest 数据库所做的更改进行同步。
索引器会监控 oplog 以获取要建立索引的新值。通过使用全文搜索管理员配置文件中的 <updateIndexDelay>
XML 标记,配置同步索引的频率。
- 用法
- 您不必直接使用此命令。在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 更新方式索引器已启用并已启动。现在,对 ClearQuest 记录的修改、添加和除去操作建立索引,并将其显示在搜索结果中。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误、Solr 服务器故障或 WebSphere Application Server 概要文件启动失败(通常是由于设置问题),否则该命令从不会失败。
- 示例
- IBM 软件支持部门指示您启用更新方式索引器。
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
- stop_fts_was_profile
- 摘要
- 该命令用于停止全文搜索 WebSphere Application Server 概要文件服务。
如果 WebSphere Application
Server 概要文件停止,那么搜索服务不可用,并且更新方式索引器会停止同步搜索索引与对 ClearQuest 记录所做的更改。
- 用法
- 您不必直接使用此命令。在您发出 setup_cq_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 全文搜索 WebSphere Application
Server 概要文件停止,这还会停止搜索服务和更新方式建立索引操作。会释放 WebSphere Application Server 概要文件使用的内存和处理器能力。搜索会导致一个错误。
只要 ClearQuest Web 中的全文单选按钮仍然启用,oplog 就会继续接收消息。
这使更新方式索引器能够在再次运行 WebSphere Application Server 概要文件后实现同步。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门指示您停止搜索 WebSphere Application Server 概要文件。
cqperl cqtsadmin.pl --username admin --password
"" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_fts_was_profile
- stop_update_idx
- 摘要
- 该命令用于禁用和停止更新方式索引器。
当更新方式索引器停止时,搜索服务可以使用,但对 ClearQuest 记录所做的更改不会反映在索引中,直至重新启用或恢复更新方式建立索引操作。因此,搜索产生的结果可能不是最新的或不准确。
- 用法
- 您不必直接使用此命令。在您发出 setup_cq_fts 和 backup_fts 命令行选项时会对其进行调用。提供此命令,以防您需要调优或调试部署。
- 效果
- 会禁用在 WebSphere Application Server 概要文件下运行的更新方式索引器。新的和修改的 ClearQuest 记录不会反映在搜索结果中。oplog 继续接收消息。在更新方式记录索引器重新启用后以及它与当前 oplog 同步后,ClearQuest 记录更改会反映在全文搜索中。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- IBM 软件支持部门指示您禁用更新方式索引器。
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
- unlock_cq_fts
- 摘要
- 该命令用于解锁全文搜索的已锁定部署。在命令完成后,您可以运行所有可用的全文搜索管理员命令。
- 用法
- 使用此命令可解锁全文搜索的已锁定部署,以便您可以运行所有可用命令。该命令取消了 lock_cq_fts 命令行选项设置的锁定。
- 效果
- 无。全文搜索部署数据和设置不受影响,并且可以运行所有命令。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须优化索引,但是部署已锁定。
您必须将其解锁,优化索引,然后再将其锁定。
cqperl
cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb
SAMPL --ftshome D:\CQ.Search --unlock_cq_fts --optimize_idx --lock_cq_fts
- update_fts_prop_files
- 摘要
- 传播您在 cqtsadmin-dbset-userdb.xml 全文搜索管理员配置文件中所做的更改。在更改配置文件中的以下任何 XML 标记后,必须传播这些更改以使其生效:
- <batchIndexBatchSize>
- <batchIndexDelay>
- <batchIndexThreads>
- <ftsServerName>
- <ftsWASProfileName>
- <ftsWASProfilePort>
- <updateIndexBatchSize>
- <updateIndexDelay>
- <updateIndexLoginInterval>
例如,如果您更改批处理方式索引器的批处理大小,那么必须在对要使用的新值运行 run_batch_idx 命令行选项之前发出该命令。
注: 无论何时更改管理用户的密码,请使用
update_fts_prop_files(指定新密码),以确保可以更新密码文 (
pwd.txt) 和恢复新纪录的批量索引;例如
cqperl cqtsadmin.pl --username admin --password new_password --dbset 7.0.0 --userdb SAMPL --ftshome C:\CQ.Search --fresh_batch_idx
- 用法
- 在部署全文搜索时,您可能要更改缺省设置。对配置文件进行更改后,必须将更改传播至相应的全文搜索组件。
- 效果
- 受影响的组件取决于您更改的 XML 标记值。
请参阅cqtsadmin-dbset-userdb.xml 以获取更多信息。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须通过增加批处理大小和线程数来加速批处理方式建立索引操作。更改配置文件后,发出此命令。
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--update_fts_prop_files --run_batch_idx
- upgrade_solr_app
- 摘要
- 该命令行选项可检查您当前全文搜索部署的 Apache Solr 是否为 ClearQuest 版本随附的最新版本。
如果不是,该选项会升级 Apache Solr。
- 用法
- 较新的 ClearQuest 版本可能会支持比您当前全文搜索部署所使用版本更新的 Apache Solr 版本。在使用 prep_upgd_was_profiles 和 restore_was_profiles 命令行选项升级 ClearQuest 和全文搜索部署时,Apache Solr 应用程序不会自动升级。
该升级方法是故意为之,因为索引格式可能已更改,这将需要完全重建索引。使用此命令可将 Apache Solr 升级至最新的受支持版本。
在使用该命令行选项之前,您应该通过使用 backup_fts 命令行选项来备份全文搜索部署。
此外,请参阅 IBM Rational ClearQuest 发行说明,以了解在升级 Apache Solr 后,是否必须对 ClearQuest 数据库重建索引。如果 Apache Solr 的索引格式已更改,那么可能要重建索引。
运行该命令行选项后,您必须运行
stop_fts_was_profile 命令行选项,然后运行
start_fts_was_profile 命令行选项以使升级生效。
要点: 通过使用 prep_upgd_was_profiles 和 restore_was_profiles 命令行选项升级 ClearQuest 以及升级全文搜索部署后,您必须运行此命令行选项。否则,可能会出现未知问题。
- 效果
- 现有的 Apache Solr 已升级至支持的最新版本。ClearQuest 全文搜索不可用,直至升级完成。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误或 WebSphere Application
Server 问题,否则该命令从不会失败。
- 示例
- 您要升级某个全文搜索部署的 Apache Solr。通过使用 backup_fts 选项运行 cqtsadmin.pl 命令,备份全文搜索部署。
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTS.Backup
通过使用 upgrade_solr_app 命令行选项再次运行 cqtsadmin.pl 命令来升级 Solr 应用程序:
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --upgrade_solr_app
如果显示的消息指示您对用户数据库重建索引,那么分别使用 stop_update_idx、run_batch_idx、optimize_idx 和 start_update_idx 命令行选项运行 cqtsadmin.pl 命令四次:
cqperl
cqtsadmin.pl --username admin --password secret --dbset TextSearch
--userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
cqperl cqtsadmin.pl --username admin --password
secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --run_batch_idx
cqperl cqtsadmin.pl --username admin --password
secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx
cqperl cqtsadmin.pl --username admin --password
secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
如果您具有针对其他 ClearQuest 数据库的额外全文搜索部署,那么对每个数据库运行前面的命令。
- was_profile_ports_file
- 摘要
- 该命令行选项使您可选择提供自己的 WebSphere Application
Server 概要文件端口文件,在创建全文搜索概要文件时,这会与 create_fts_was_profile 命令行选项一起使用。
- 用法
- 在创建新的全文搜索部署时,缺省情况下会创建一个新的 WebSphere Application
Server 概要文件。全文搜索管理员工具可确定要在系统上使用的下一个可用端口。如果您必须调优部署并指定要使用的自己的端口,必须创建自己的端口文件。然后,使用 was_profile_ports_file 选项指示全文搜索管理员工具使用您的端口文件。在 WebSphere 安装的 portdef.props 文件中,有一个可以使用的模板。
portdef.props 文件通常位于 \IBM\WebSphere\AppServer\profileTemplates\default\actions\portsUpdate\ 目录中。
要了解有关 WebSphere Application Server 概要文件端口文件的更多信息,请参阅 WebSphere Application Server 信息中心内的“manageprofiles 命令 - 示例:使用预定义端口号”部分。http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=%2Fcom.ibm.websphere.base.doc%2Finfo%2Faes%2Fae%2Frxml_manageprofiles.html
该命令行选项与
create_fts_was_profile 选项一起使用。
注: 如果您使用自己的端口,请确保您的端口未被其他应用程序使用。否则,您可能会遇到与全文搜索和其他应用程序有关的问题。
- 效果
- 使用您通过该命令指定的端口来代替全文搜索管理员工具指定的端口。
- “有状态”状态
- 该选项是无状态的。除非发生 I/O 错误,否则该命令不应该失败。
- 示例
- 您必须指定要使用的自己的端口集。
- 制作 portdef.props 文件的副本,然后指定自己的端口值。
- 运行此命令来创建新的全文搜索部署,使用 was_profile_ports_file 选项指定自己的端口。
cqperl cqtsadmin.pl --username admin --password
"" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts
--create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles
--was_profile_ports_file D:\my-portdef.props
- 继续使用全文搜索部署。