更新至新维护版本
Windchill PDM Essentials 采用与
Windchill PDMLink 相同的方式进行更新,即使用“PTC 解决方案安装程序 (PSI)”,而非
“Windchill 安装助手” (仅用于全新安装或作为升级至新版本的一部分)。为将平台维护版本更新应用到您的
Windchill PDM Essentials 部署中,您必须从 PTC 支持网站 (
http://www.ptc.com/support/support.htm) 的
Windchill PDM Essentials 文件下载专区下载
Windchill 服务包。
下载所需图像后,请按照以下步骤应用维护版本更新:
|
PTC 建议您始终使用测试 (预生产) 系统,以确保 Windchill 产品在部署到生产环境之前可按预期运行。这样,您就可以在不干扰生产系统活动的情况下确定测试系统中的任何潜在问题。在测试系统上安装了维护版本并对结果感到满意后,您即可在生产系统上重复维护版本的安装过程。由于您已在测试系统上进行了工作,因此,在生产系统上安装维护版本所需的时间应更少。
如果选择直接更新生产服务器,应确保备份服务器和数据库或者拍下快照 (如果已在虚拟环境中部署)。如果存在更新问题,借此可以恢复系统。有关备份的详细信息,请参阅下列三个步骤。
|
更新之前,请确定是否已将源系统设置为使用“简单数字”(也称为“哈佛序列”) 版本方案。任何现有文档或 CAD 文档都具有版本和小版本指示符。如果文档和 CAD 文档的版本显示为 1.1, 1.2,....2.1, 2.2,... 等,则版本方案为“简单数字”(哈佛序列)。如果您的系统使用的是“简单数字”(哈佛系列) 版本方案,请在开始之前进行记录;更新过程需要额外进行一个步骤。有关详细信息,请参阅“简单数字”(哈佛序列) 版本方案的更新后步骤。
1. 在目标系统上,为下载的图像创建暂存目录。将介质文件置于新建暂存目录中:
a. 单击“复制到暂存区域”。
b. 单击“浏览”,浏览至包含 CD zip 文件的目录,或浏览至含产品 CD 的 CD 驱动器。
c. 单击“确定”。
|
暂存目录是您在开始安装之前用于复制产品介质的目录。这允许“PTC 解决方案安装程序”访问每个 CD 映像,而不在安装期间停下来提示您。
使用暂存区域可以拥有更快的安装体验,而且不必在安装期间插入介质。
|
2. 如果您所在站点的 Windchill 实施涉及到修改由 PTC 提供的文件,则了解以下点非常重要:维护安装过程会覆盖 PTC 所提供的任何文件 (site.xconf 文件除外)。这包括您已修改的文件。
如果您已经进行了站点修改并且将要更新至维护版本或修补版本,PTC 建议您遵照帮助中心的
设置用于管理自定义文件和定制显示文本的目录结构主题中建立的最佳做法。特别需要确保所有站点修改文件均位于
<Windchill>/wtSafeArea/siteMod 目录中。
使用测试系统允许您将来自 PTC 的更新合并到任何站点修改文件中,并根据您自己的自定义验证维护版本或修补版,而不中断正在生产系统上执行的工作。PTC 建议您将所有站点修改文件的副本存储在 Windchill 安装目录下的安全区域目录结构中。然后,请遵照以下说明,将服务包安装类型选项选为“将站点修改文件更新至安全区域”,进而运行 PTC 解决方案安装程序。您将可以访问 PTC 为维护版本更改的文件,并可相应地更新站点修改文件。更新站点修改文件后,可以再次遵照以下说明,在测试系统上运行“完整的”服务包安装程序,以验证包含站点修改的已更新系统是否能够根据您的要求进行工作。
在测试系统上安装了维护版本或修补版并对结果感到满意后,可以将您已更新的站点修改文件复制到生产系统上的安全区域目录 (<Windchill>/wtSafeArea/siteMod) 中。然后,便可在生产系统上重复维护版本或修补版的安装过程。
3. 通过执行以下步骤使系统做好更新准备:
a. 确保测试系统与生产系统同步。
b. 停止所有可与 Windchill 产品文件进行交互的 Web 服务器、servlet 引擎或 Windchill 服务器,以使生产系统脱机。这包括停止 Windchill 和 Apache 服务 (services.msc),并关闭可能尚有 Windchill 文件 (如文本编辑器、Windchill shell 或 Windchill 日志文件) 打开的所有应用程序。
c. 删除 <Windchill>\Tomcat\instances\ 文件夹中的内容。
d. 当您的系统处于脱机状态,但尚未安装维护版本时,请执行所有必要的备份。备份文件是本过程中的一个重要步骤。如果您未备份文件,则在出错后可能无法恢复文件。至少应备份以下内容:
▪ Windchill 数据库 - 使用适合于 SQL Server 环境的数据库备份步骤。该备份应跟随站点数据恢复过程。
▪ Windchill 解决方案安装目录 - 默认情况下为 C:\ptc。通过创建副本对其备份并将其存储在跟随站点数据恢复过程的某个位置。
▪ Windchill 解决方案 LDAP 目录内容 (LDIF 文件) - 执行
将条目导出到 LDIF 文件中所述的 LDAP 导出程序。将 LDIF 文件存储在符合站点数据恢复过程的位置。
▪ PTC 解决方案安装程序全局注册表 - 创建名为 "installer" 的“PTC 解决方案安装程序全局注册表”目录的副本,该目录位于 <Installation_Location>/PSI 目录中。将该“PTC 解决方案安装程序全局注册表”目录存储在跟随站点数据恢复过程的某个位置。
4. 如果正在更新的系统中包括 Windchill Workgroup Manager,请确保客户端 JAR 文件为最新的。Windchill Service Pack 安装会自动地重新构建客户端 JAR 文件。在 PTC 解决方案安装程序中选择选项时,请确保在可选产品下选择 Windchill Workgroup Manager (请参阅步骤 13)。
5. 启动 PSI:
a. 请插入“PTC 解决方案安装程序”CD。
b. 在命令提示符窗口中,导航至 CD 驱动器,然后输入以下命令:setup.vbs
PSI 随即打开。
6. 为此安装会话选取语言,然后单击“确定”。
|
“事前准备”面板提供了指向安装 Windchill 解决方案时所必需的文档的链接。
|
7. 接受 PTC 客户许可协议。
8. 选择“更新现有安装”,然后单击“下一步”。
9. 选择要更新的安装,然后单击“下一步”。
10. 在“选择产品”页面中,选择“安装维护版本”,然后单击“下一步”
◦ 如果您的解决方案不在指定目录中,安装程序会显示“要更新的产品”面板,以供您指定产品的位置。
◦ 如果您已完成了站点修改,安装程序会检查是否存在可存储这些修改的目录:<Windchill>/wtSafeArea/siteMod (其中 <Windchill> 为 Windchill 服务安装目录)。安装程序假定该目录下包含所有站点修改文件的副本。如果未找到该目录,则会显示““确认无站点修改目录”消息,以便您可确认不存在任何站点修改文件。单击“是”继续安装,或者单击“否”然后再单击“取消”退出安装。
11. 指定包含介质的暂存目录,然后单击“下一步”。
12. 选择是否要保留现有的 web 配置,然后单击“下一步”。
13. 如果更新 Windchill Workgroup Manager 过程中需要安装 Windchill 的更新,请选择您要安装的所有适用的 Windchill Workgroup Manager 创作应用程序旁边的复选框。
|
除了在 Windchill Workgroup Manager 服务器上安装 Windchill 以外,用户还必须安装 Windchill Workgroup Manager 客户端软件。这些说明位于指南和 Windchill Workgroup Manager 帮助中心中针对适用 CAD 或创作工具的“安装和配置”部分之下。
|
14. 在“选择安装类型”面板中,选择“完成”,然后单击“下一步”。
15. PSI 会列出必须进行更新的产品和组件。此外,PSI 还列出需要重新安装的所有产品,以完成更新。
单击“下一步”。
16. 如果 Apache Web 服务器和 Tomcat 需要更新,此面板会提供保留配置文件的选项。如果清除此复选框,则现有 httpd.conf 文件会由 Apache 提供的默认 httpd.conf 文件覆盖。如果选择此复选框,则现有 httpd.conf 文件将不会被覆盖。
单击“下一步”。
17. 在“安装概述”页面中,查看相关信息并单击“安装”。
18. 安装成功完成后,“安装完毕”面板会显示受安装影响的目录。根据所执行的安装类型,这些目录可能包括进行安装的选定目录、选定目录以及 <Windchill>/wtSafeArea/ptcCurrent 目录,或者仅包括 <Windchill>/wtSafeArea/ptcCurrent 目录。
安装日志文件位于 <Windchill>/installer/logs 目录。安装日志文件的名称为:
WSP_InstallLog.xml
WSP_PtcInstall.log
|
如果安装失败,则会显示一个包含错误消息和相关日志文件名称的面板。日志文件可帮助您确定失败的原因。
有关 Windchill Service Pack 安装故障排除的其他信息,请参阅 维护安装故障排除主题。
|
如果您提交了安装支持请求,请确保其中包含日志文件。您所执行的每个 Windchill Service Pack 安装都会具有单独的日志文件。每一组日志文件都位于安装目录下的 installer/logs 目录中。
20. 通过 Windchill Service Pack 选项完成更新为现有安装后 (例如维护版本更新),方可运行更新工具。
|
在运行“更新”工具之前,Web 服务器、Windchill Directory Server 和数据库应已启动且正在运行。
|
要执行更新工具,Windchill 管理员 (wcadmin) 必须从 Windchill shell 执行以下命令:
Update_Tool.bat -username <username> -password <password> -noui
|
如果服务器在更新工具完成运行之前被关闭,则在 Windchill 服务尝试自动启动时,会在启动期间出现一条错误消息:The Windchill service on Local Computer started and then stopped. Some services stop automatically if they are not in use by other services or programs。
要解决此问题:
a. 在安全模式下启动计算机。
b. 在“开始”菜单中访问 Windows 服务: > 。
c. 将 Windchill PDM Essentials Windows 服务的“启动类型”特性值由“自动”更改为“手动”。
d. 重新启动计算机。
e. 运行更新工具。
|
如果出现以下消息,则说明“更新”工具已成功完成:"Marking phase Load New Data as completed in database."
21. 对于用于更新 Windchill 解决方案安装目录的 Windchill Service Pack 安装程序,需导航至 > > ,以验证 Windchill产品更新后的版本是否正确。
“版本”和“日期代码”字段应当反映正确的更新版本。
也可以运行 windchill version 命令来验证 Windchill 的版本是否正确。
如果 Windchill 版本显示有任何未完成的组件安装,请选择“恢复”安装类型选项来进行重新安装。
|
如果您是首次安装到测试系统中,则必须在生产系统中重复安装。
|
此 URL 可将您定向到“PTC 联机支持 Web”页面,以供您查看参考文档。在选择文档搜索条件时,从“产品”下拉列表选择产品,从“版本”下拉列表选择当前版本,从“文档类型”下拉列表选择“使用前须知”,再从“用户角色”下拉列表选择“管理员”。
23. 如果已建模表的表空间在更新过程中从 WCAUDIT 更改为其他表空间,系统会检测到这一更改,并在“升级数据库架构”阶段生成以下脚本:
<windchill>\Upgrade\UpgradeReports\UpgradeDatabaseSchema\MoveTablesSql-<date>.sql
如果脚本存在于列出的位置,则需要手动运行此脚本以将表移至 WCAUDIT 表空间,进而与出厂设置数据库架构相匹配。
24. 通过重启 Apache Web 服务器和 Windchill 服务器的 Windows 服务,将系统重新联机。
有关
Windchill Service Pack 更新的详细信息,请参阅
更新现有安装。
“简单数字”(哈佛序列) 版本方案的更新后步骤
成功完成更新后,如果源系统已设置为使用“简单数字”(哈佛序列) 版本方案,请执行以下附加步骤:
|
任何现有文档或 CAD 文档都具有版本和小版本指示符。如果文档和 CAD 文档的版本显示为 1.1, 1.2,....2.1, 2.2,... 等,则版本方案为“简单数字”(哈佛序列)。
|
在 Windchill shell 中,键入以下命令以添加正确的特性:
• xconfmanager -s wt.series.HarvardSeries.Number.delimiter=. -s wt.series.HarvardSeries.Number.depth=16 -s wt.series.HarvardSeries.Number.level.1=wt.series.IntegerSeries -t codebase/wt.properties -p
• xconfmanager --add wt.series.HarvardSeries.seriesNames=MilSpec,Number -t codebase/wt.properties -p
有关 xconfmanager 实用程序的详细信息,请参阅
使用 xconfmanager 实用程序
如果未执行这些步骤,则会出现以下错误:
ERROR [ajp-bio-8010-exec-1] com.ptc.core.htmlcomp.jstable.JSPersistableDataUtility cadauth
- JSPersistableDataUtility.getValue :: wt.util.WTRuntimeException:
Unable to construct version identifier for series: wt.series.HarvardSeries.Number;
nested exception is:
java.lang.reflect.InvocationTargetException
wt.util.WTRuntimeException: Unable to construct version