专业化管理 > 配置您的 Windchill 环境 > Windchill 搜索管理 > 索引搜索管理 > 管理搜索索引 > 批索引工具
  
批索引工具
启用索引且操作正确后,可建立索引的对象将会在创建后立即建立索引。但是,您有时需要同时对大量数据建立索引。
您可以使用“批索引工具”来加载 Windchill Index Search 存储库及其对象:
根据索引策略构建索引中现有数据的索引。
启动和停止批索引建立进程。
对进程进行安排,以便在指定的时间内启动和停止进程。
检查整体批索引建立进程的状况。
尝试为在索引建立过程中已失败的对象重新建立索引。
维护索引建立进程的详细日志。
在完成对索引策略的更改后重新初始化 Windchill Index Search 存储库。
在已对发布策略进行更改后重新初始化 Windchill Index Search 存储库。
由于加载索引会占用大量时间,所以可能需要将操作停止一段时间。索引状态保存在 IndexStatus 表中。这使您能够在不重新对对象建立索引的情况下停止并重新启动批索引建立进程。
“成批索引工具”的基本过程如下:
1. 为所有适用对象查询 Windchill
2. 将这些对象与 IndexStatus 表格进行对比以确定其是否已建立索引。
3. 根据对象所属域的索引策略确定各个对象是否应归入某个集合。
4. 如果适用,请在适当的集合中为对象建立索引。
* 
Windchill 仅为任何版本的最新小版本建立索引。
如果用户搜索某一对象的最新小版本,而该对象是使用数据加载实用程序加载的,那么所有的小版本均会出现在搜索结果中。要更正这一问题,可以使用“成批索引工具”对加载后的数据重新建立索引。
先决条件和性能改进提示
要提高性能,请在成批加载数据时禁用索引。批加载操作完成后,重新启用“批索引工具”并用新数据填充索引。
如果计划修改内容索引的默认 MIME 文件类型,则在运行“成批索引工具”之前,请按 指定内容索引的 MIME 类型 中所述的流程进行操作。
如果正在对大量由内容载体对象 (例如文档) 所组成的数据进行索引,请考虑设置 wt.index.BulkIndexContentQueueList 特性。此特性将为内容载体对象建立单独的索引队列。有关详细信息,请参阅Windchill 搜索特性
* 
如果成批索引已在服务器上运行,则设置此特性前必须删除并重建现有的索引队列条目。要执行此操作,请从“成批索引工具”中选择选项 2 以停止成批索引。一段时间之后,请使用“队列管理”实用程序来验证是否已清除了所有索引队列条目。
Solr 提交频率
要降低 Solr 提交的频率,请增加自动提交事件的间隔时间。
1. 导航至以下文件:
<Index_Search_Home>\SolrServer\solr\solr-home\wblib\conf\solrconfig.xml
2. maxTime 值由 60000 ms 增加至 300000 ms:
<autoCommit>
<maxDocs>100000</maxDocs>
<maxTime>300000</maxTime>
</autoCommit>
3. 重新启动服务器并使用“成批索引工具”启动索引。
4. 成批索引完成后,将 maxTime 值恢复为 60000 ms:
<autoCommit>
<maxDocs>100000</maxDocs>
<maxTime>60000</maxTime>
</autoCommit>
有关详细信息,请参阅自动提交
使用“批索引工具”
要使用“批索引工具”,您必须以管理员的身份登录。
打开 Windchill shell,然后输入以下命令:
windchill wt.index.BulkIndexTool
如果正在已安装 Windchill Index SearchWindchill PartsLink 的服务器上执行批索引,则“批索引工具”将提示您选择一个核心存储库 (集合):默认存储库为 wblib
* 
可以并排打开两个命令提示符,以简化运行该工具的进程。使用一个命令提示符来运行“批索引工具”,而使用另一个命令提示符对 BulkIndexTool.log 文件进行 tail 操作。
tail 实用程序为标准的 UNIX 实用程序。该实用程序也适用于 Windows,可从以下 GNU 网站获取:
对于实时进度,可以在 BulkIndexTool.log 文件上运行 tail 实用程序。例如:
tail -f BulkIndexTool.log



批索引工具菜单选项
0
查看以下属性的当前值:
wt.index.enabled
com.ptc.windchill.partslink.index.enabled
wt.index.bulkIndexSize
wt.index.BulkIndexQueueList
wt.index.BulkIndexContentQueueList
wt.index.maxContentSize
wt.index.checkDocumentTypes
wt.index.filterFileTypes
wt.index.IndexAndSearchMetaDataOnly
wt.index.checkIndexingRulesBeforeQueue
wt.index.excludeAttributes
* 
仅当选择了符合联合存储库搜索条件的核心时,此选项才可用。
1
启动批索引建立进程
选择此选项以开始对数据建立索引。此选项也在 BulkIndexQueue 中创建一个条目,执行实际的批索引建立任务。
如果您先前启动了批索引建立进程,并且该进程在选择此选项时仍在运行,您将收到一条错误消息。
2
停止批索引建立进程。
选择此选项以停止批索引加载进程并移除任何剩余的批索引队列条目。
* 
如果未选择此选项,那么您应该监控队列以保证不会生成多个条目。
3
安排批索引建立进程。
选择此选项以设置用于重复批索引建立进程的常规排程。最好将时间安排在用户活动较少的时候。
请输入以下信息:
开始时间。使用 mm/dd/yyyy hh:mm am/pm 格式。
停止时间。使用 mm/dd/yyyy hh:mm am/pm 格式。
运行总次数 (希望安排任务重复执行的次数)。
希望批索引建立任务运行的频率 (以天为单位)。(例如,对于每日,输入 1;对于每周,输入 7。)
4
重置失败条目
选择此选项以重置建立索引期间失败的对象。您可以使用此选项再次处理失败的对象。
5
重置正在处理的条目。
如果您具有还未被标记为完整对象的对象,则可以选择此选项。如果索引引擎与 Windchill 发生通信且 Windchill 未更新对象,可能会出现这种情况。
6
重置无索引策略的条目。
如果您更改了索引规则,请选择此选项,并且先前尚未建立索引的对象此时应包括在内。
* 
创建新的索引策略规则不会对已建立索引的对象造成影响。
7
检查批索引建立进度:
选择此选项以查看索引状况。
以下状态示例显示在 3609 个对象中,已为 3588 个建立索引,为 15 个对象建立索引失败,另外 6 个正在等待为其建立索引。
Current status of Bulk Index:
Total Objects Handles: 3609
Objects processed: 3588
Objects processing: 0
Objects w/o indexing policies: 0
Objects remaining: 6
Objects failed: 15
处理完所有对象之后,批索引建立进程即完成。
* 
该进度取决于 wt.index.bulkIndexSize 特性。只有处理完所设置的对象数量后,状况才会发生更改。有关详细信息,请参阅Windchill 搜索特性
* 
您还可以使用“站点” > “实用程序” > “业务管理”中的“索引管理”实用程序。有关详细信息,请参阅索引管理实用程序
8
删除对象的批索引建立列表。
* 
执行此选项后,您需要在 Search Index Server 设置中手动删除该特定核心的索引数据目录。
9
验证索引数据。
选择此选项以验证在 Windchill 中已被标记为“已建立索引”的对象是否确实存在于已建立索引的数据中。在恢复 Windchill/index 文件夹时,此选项十分有用。
* 
定期使用此选项 (最好每 3 到 6 个月使用一次) 以确保 Windchill 对象的索引状况正确无误。
* 
选项 9 将不在索引服务器上的对象标记为失败对象。
如果想要检查已建立索引对象的状况,请使用选项 7
使用选项 4 以对所有失败的对象建立索引。
10
返回到核心选择菜单
使用此选项可从使用 Windchill 服务器进行索引搜索服务器配置时安装的可用核心列表中选择核心。
11
退出