cqtsdbcrawler 命令用于运行全文搜索记录抽取器。
摘要
- cqperl cqtsdbcrawler.pl { -batch | -update | -optimize | -repair repair_file } CQ-db_name-dbset_name.xml [ -site site_name ]
- cqperl cqtsdbcrawler.pl -encrypt -s dbset -d dbname -u user -p password -kf output_key_file_name -pf output_encrypted_password_file_name -jvmpar "jvm_options"
描述
尽管配置全文搜索后,会持续更新索引,但是在以下情况中必须使用
cqtsdbcrawler.pl 命令:
- 首次对记录建立索引。
- 显式更新索引。
- 对未正确处理的记录重新建立索引。
- 生成加密密码和密钥文件。
- 优化全文搜索索引文件以改善性能。
未正确处理的记录会记录到名为 record_type_time_stamp.xml 的修复文件中,并写入 ClearQuest 搜索属性文件 CQ-dbname-dbset-name.xml 所在的目录。您可以使用该文件作为 cqtsdbcrawler.pl–repair 的输入。
以批处理或更新方式运行时,cqtsdbcrawler.pl 会分别在文件 batch_recovery.properties 和 update_recovery.properties 中记录成功处理的最后一条记录。停止并重新启动命令执行时,这些文件可提供处理的起点。这些文件会写入当前用户的主目录中。
cqtsdbcrawler.pl 安装在缺省产品安装目录中。
选项和自变量
- –batch
- 以批处理方式运行抽取器。该选项用于读取已配置为进行全文搜索的所有记录,并将其传递给 Solr 以便由 Lucene 建立索引。处理会占用大量 CPU 和 IO 资源;因此,为避免降低性能,您可能要在系统使用率最低时运行批处理操作。
- –update
- 以更新方式运行抽取器。该选项用于监控数据库的添加、删除或修改记录的操作。它读取对数据库的任何此类更改,并将其传递给 Solr 以建立索引。(该选项是抽取器的 WebSphere Application Server Express 实例的缺省运行方式;提供该选项使用户可以从命令行执行相同的功能。)
- –optimize
- 优化搜索引擎索引以改善性能。
- –repair repair_file
- 以修复方式运行抽取器。repair_file 中列出的记录是在批处理方式或更新方式中未正确处理的记录。
- cq_search_properties_file
- ClearQuest 搜索属性文件,由命令 cqtssetup.pl ... –o CQ 生成。
- –site site
- 缺省站点是 <local>,这表示该数据库不是复制的。如果该数据库是复制的,那么此选项是必需的:用于指定站点(MultiSite)从何处收集配置参数以执行记录抽取。
- –s dbset
- 数据库集的名称。
- –d dbname
- 数据库的名称。
- -u user
- 用户名。
- -p password
- 密码。
- -encrypt
- 对密码加密。
- -kf key_file
- 写入密码加密密钥的文件。
- -pf password_file
- 写入加密密码的文件。
- -jvmpar "jvm_options"
- 用于设置 Java 虚拟机(JVM)选项。
示例
以批处理方式运行
cqtsdbcrawler.pl:
cqperl cqtsdbcrawler.pl -batch CQ_SAMPLE-TextSearch.xml -site "<local>"
以修复方式运行
cqtsdbcrawler.pl:
cqperl cqtsdbcrawler.pl -repair ~bert/Defect207294053937.xml ~bert/CQ_SAMPLE-TextSearch.xml
创建加密密码和密钥文件:
cqperl cqtsdbcrawler.pl -encrypt -s TextSearch -d SAMPL -u admin -p admin_password -kf key.txt -pf password.txt
优化全文搜索索引文件:
cqperl cqtsdbcrawler.pl -optimize CQ-SAMPL-TextSearch.xml
使用具有 JVM 选项的批处理方式运行
cqtsdbcrawler.pl:
cqperl cqtsdbcrawler.pl -jvmpar "-Xms512m -Xmx1024m" -batch CQ_SAMPLE-TextSearch.xml -site "<local>"