Windchill Index Search 和 Windchill PartsLink 的执行步骤
 |
虽然以下所列的过程用于升级，但在更新时也可以执行这些步骤。
• 如果您要从 Windchill 11.1 F000 更新，请参阅此部分：从 Windchill 11.1 F000 更新。
|
在源发行版本中索引的对象必须在目标系统中重新索引。本节将说明如何对属于 Windchill Index Search 存储库的对象重新建立索引。
在按照安装目标系统一节中的步骤安装目标系统之前，应首先安装 Windchill Index Search 客户端和服务器。
在每次执行演练升级时运行批量索引工具，可显著提升生产升级期间对 Windchill Index Search 重新建立索引过程的性能。
下面是对该过程的高度概述：
1. 首次演练升级后，执行“批量索引工具”。
2. 导出并保存 IndexStatus 表格。
3. 每次后续演练升级后，完成以下步骤：
a. 将 IndexStatus 表格导入到升级后的数据库中。
b. 执行批量索引工具。
c. 导出并保存 IndexStatus 表格。
4. 生产升级后，完成以下步骤：
a. 将 IndexStatus 表格导入到升级后的数据库中。
b. 执行批量索引工具。
|
|
该过程非强制过程。您可以选取仅在升级后的生产服务器上运行批量索引工具，但该过程有助于减少执行最终批量索引所需的时间。索引搜索功能是否可用取决于执行批量索引所需的时间。
|
首次演练升级的步骤
请完成下列首次演练升级步骤：
1. 在生产系统的快照上完成演练升级后，请记录快照的拍摄日期 (例如，BIT_START_DATE)。
2. 验证在 Windchill“策略管理”实用程序中的索引策略规则内配置的集合名称与 Solr 数据文件夹中的名称是否相同 (均应为 "wblib")。
请执行以下步骤：
a. 以站点管理员身份登录到 Windchill。
b. 导航到 > > 。
c. 单击定义索引策略的根 (/) 域的域名。
d. 导航到“索引规则”选项卡并编辑现有的规则。
e. 根据索引策略，从“选定集合”中移除现有集合，并从“可用集合”中添加必需的集合。有关配置多重集合 (核心) 的信息，请参阅 《Windchill 自定义指南》。
3. 运行批量索引工具。执行以下步骤可完成此操作：
a. 启动 Windchill 解决方案。
b. 打开 Windchill shell。
c. 运行 windchill wt.index.BulkIndexTool。
d. 登录到“批量索引工具”。
e. 删除对象的批量索引列表。
f. 启动批量索引进程。
有关安装 Windchill Index Search 或“批量索引工具”的详细信息，请参阅《Windchill 安装和配置指南》。
4. 从演练 Windchill 目标数据库中导出 IndexStatus 表格并进行保存。该表格中包括有关重新建立索引的所有必要信息。
5. 复制并保存与 wblib 相关的索引数据文件夹。
要获取数据目录路径，请参阅索引搜索服务器中的 wt.index.server.datadir 特性值。
各个后续演练升级的步骤
请完成下列步骤以进行各个后续演练升级：
1. 在生产系统的快照上完成演练升级后，请记录快照的拍摄日期 (例如，BIT_START_DATE)。
2. 验证在 Windchill“策略管理”实用程序中的索引策略规则内配置的集合名称与 Solr 数据文件夹中的名称是否相同 (均应为 "wblib")。
请执行以下步骤：
a. 以站点管理员身份登录到 Windchill。
b. 导航到 > > 。
c. 单击定义索引策略的根 (/) 域的域名。
d. 导航到“索引规则”选项卡并编辑现有的规则。
e. 根据索引策略，从“选定集合”中移除现有集合，并从“可用集合”中添加必需的集合。有关配置多重集合 (核心) 的信息，请参阅 《Windchill 自定义指南》。
|
|
如果策略规则发生了任何更改，则不应使用来自早期演练的索引数据。
|
3. 在当前演练期间，从之前的演练复制索引数据文件夹，然后将其粘贴到相应的位置：
a. 停止 Windchill。
b. 根据所配置的集合复制索引数据目录。
要获取数据目录路径，请参阅索引搜索服务器中的 wt.index.server.datadir 特性值。
c. 将目录粘贴到当前的演练服务器文件系统中。
4. 将 IndexStatus 表格导入到升级后的演练 Windchill 目标数据库中。
5. 执行以下 SQL 命令：
update IndexStatus set modifyStampA2='BIT_START_DATE', createStampA2='BIT_START_DATE'; commit;
(其中 BIT_START_DATE 为执行“批量索引工具”的上一次演练快照的拍摄日期)。
6. 对升级后的演练系统重新建立索引，具体方法是运行“批量索引工具”以捕捉生产系统快照拍摄后经修改的数据。执行以下步骤可完成此操作：
a. 启动 Windchill 解决方案。
b. 打开 Windchill shell。
c. 运行 windchill wt.index.BulkIndexTool。
d. 登录到“批量索引工具”。
e. 删除对象的批量索引列表。
f. 启动批量索引进程。
有关安装 Windchill Index Search 或“批量索引工具”的详细信息，请参阅《Windchill 安装和配置指南》。
7. 从升级后的演练 Windchill 目标数据库中导出 IndexStatus 表格并进行保存。该表格中包括有关重新建立索引的所有必要信息。
8. 复制并保存与 wblib 相关的索引数据文件夹。
要获取数据目录路径，请参阅索引搜索服务器中的 wt.index.server.datadir 特性值。
生产升级的步骤
请完成下列生产升级步骤：
1. 验证在 Windchill“策略管理”实用程序中的索引策略规则内配置的集合名称与 Solr 数据文件夹中的名称是否相同 (均应为 "wblib")。
请执行以下步骤：
a. 以站点管理员身份登录到 Windchill。
b. 导航到 > > 。
c. 单击要定义索引策略的适用域根目录的域名。
d. 导航到“索引规则”选项卡并编辑现有的规则。
e. 根据索引策略，从“选定集合”中移除现有集合，并从“可用集合”中添加必需的集合。有关配置多重集合 (核心) 的信息，请参阅 《Windchill 自定义指南》。
|
|
如果策略规则发生了任何更改，则不应使用来自早期演练的索引数据。
|
2. 在当前生产升级期间，从之前的演练复制索引数据文件夹，然后将其粘贴到相应的位置：
a. 停止 Windchill
b. 根据所配置的集合复制索引数据目录。
要获取数据目录路径，请参阅索引搜索服务器中的 wt.index.server.datadir 特性值。
c. 将目录粘贴到当前的服务器文件系统中。
3. 将 IndexStatus 表格导入到升级后的生产 Windchill 目标数据库中。
4. 执行以下 SQL 命令：
update IndexStatus set modifyStampA2='BIT_START_DATE', createStampA2='BIT_START_DATE'; commit;
(其中 BIT_START_DATE 为执行“批量索引工具”的上一次演练快照的拍摄日期)。
5. 对升级后的生产系统重新建立索引，具体方法是运行“批量索引工具”以捕捉生产系统快照拍摄后经修改的数据。执行以下步骤可完成此操作：
a. 启动 Windchill 解决方案。
b. 打开 Windchill shell。
c. 运行 windchill wt.index.BulkIndexTool。
d. 登录到“批量索引工具”。
e. 删除对象的批量索引列表。
f. 启动批量索引进程。
有关安装 Windchill Index Search 或“批量索引工具”的详细信息，请参阅《Windchill 安装和配置指南》。
Windchill PartsLink 与分类结构
对升级后的生产系统重新构建分类结构索引，具体方法是运行“批量索引工具”以捕捉自生产系统快照拍摄后所修改的数据。
• windchill com.ptc.windchill.csm.struct.UpdateClassificationStructure -u adminUsername -p adminPassword -v
更新 Windchill 11.1 F000
更新 Windchill 时，必须在 wt.properties中为 Windchill Index Search 客户端设置以下特性：
• wt.index.enableIndexSearchHighAvailability
• wt.index.solrHost (仅当在独立模式下安装索引搜索服务器时设置)
• wt.index.solrPort (仅当在独立模式下安装索引搜索服务器时设置)
• wt.index.zookeeperHosts (仅当在高可用性/云模式下使用索引搜索时设置)
• wt.index.indexingLanguage
• wt.index.indexingLanguageList
• wt.index.solrEffectiveUid
• wt.auth.trustedHosts
在 codebase/WEB-INF/conf/index.solrAuth.properties 中设置以下特性：
• wt.index.solrAdminUser
• wt.index.solrAdminPassword
有关这些特性的详细信息，请参阅 Windchill 搜索特性。
由于更新操作应从 Windchill 移除 Solr Web 应用程序，因此需验证以下文件是否已被移除：
• Windows：
<Windchill>/Apache/app-Windchill-Solr.properties
<Windchill>/Apache/app-Windchill-Solr-AuthProvider.xml
<Windchill>/Apache/app-Windchill-Solr-AuthRes.xml
• Unix：
<Windchill>/HTTPServer/app-Windchill-Solr.properties
<Windchill>/HTTPServer/app-Windchill-Solr-AuthProvider.xml
<Windchill>/HTTPServer/app-Windchill-Solr-AuthRes.xml
如果这些文件仍存在，则执行以下脚本来从 Windchill 卸载 Solr Web 应用程序：
1. 打开 Windchill shell。
2. 导航至以下位置之一：
◦ Windows：
<Windchill>/Apache
◦ Unix：
<Windchill>/HTTPServer
3. 执行以下命令：
ant -f webAppConfig.xml uninstallWebApp -DappToUninstall=<Solr_WebApp_Name>
例如：
ant -f webAppConfig.xml uninstallWebApp -DappToUninstall=Windchill-Solr
您还应验证以下文件是否已被移除：
<Windchill>/tomcat/conf/Catalina/localhost/Windchill-Solr.xml
如果该文件仍然存在，则为其创建备份，然后将其删除。
更新 Windchill 11.1 F000 及更高版本
Windchill PSI 更新位于 Windchill 加载点范围外的安装时功能受限。在后续更新操作中，您必须执行 Windchill Index Search 服务器的全新安装。有关安装和配置 Windchill Index Search 服务器和客户端的信息，请参阅 Windchill Index Search 安装和安装后配置。
作为此过程的一部分，您需要手动删除或存档旧的安装。也可以将任意配置从较早版本安装手动复制到新安装。
|
|
此操作适用于所有 Solr 服务器安装。例如，如果您正在使用 Solr 云配置 (Solr 群集设置)，则必须执行所有 Solr 和 Zookeeper 节点的全新安装。
|