Windchill PSI 日志分析器实用程序
Windchill 提供的 Log Analyzer 实用程序可用于在 PSI 失败时生成失败分析文件。
先决条件
• 本机安装的 Windchill 支持的 Java 版本
• 运行该实用程序时需要特性文件位置
#Linux#
<Installation Location>/PSI/installer/PTCSolnInstaller-installer.properties
#Windows#
<Installation Location>\PSI\installer\PTCSolnInstaller-installer.properties
在 PSI 失败时运行该实用程序
仅当 PSI 安装失败时,才会触发该实用程序。运行该实用程序不需要手动干预。<Installation_Location> 构件的分析报告以文本格式生成,位于 <Installation_Location>。该报告包含以下项的基本信息:操作系统、Java 版本、Windchill 版本、选取的子安装程序以及日志中的异常/严重错误。报告文件的名称为 "logsToAnalyze",名称后缀为时间戳。该文件的扩展名为 ".log",例如:logsToAnalyze20230328_110245.233.log。以下是文件路径的示例:
<INSTALLATION_LOCATION>\PSI\installer\logs\logsToAnalyze20230328_110245.233.log
各种故障情景中的日志分析
• 如果在为全新安装创建加载点之前 PSI 失败,则会在以下示例中所示的 %temp% 位置创建一个新文件夹 LogAnalysis。其中,%temp% 是 Windows 和 Linux 平台的默认临时目录。
%temp%/LogAnalysis/LogAnalysis{Timestamp}.log#
• 如果加载点可用时更新模式下的安装失败,但失败发生在检查加载点之前,则会在临时位置创建一个新的文件夹 LogAnalysis。最新日志位于下面示例中所示的临时位置。如上所述,logAnalysis.log 可用。
#Windows
%temp%/PTCSOLNINSTALLER_PtcInstall.log
#Linux
$temp/$username/PTCSOLNINSTALLER_PtcInstall.log
◦ 在同样的情景中,如果 PSI 在更新模式下失败,那么要在独立模式下运行日志分析器,在加载点存在的情况下,应将 %temp% 目录中的日志复制到加载点日志位置 (如下面的示例所示)。
Loadpoint/PSI/installer/logs/PTCSOLNINSTALLER_PtcInstall.log
如果将 Windows 或 Linux 平台的临时目录设置为非标准位置或用户定义的位置,则 Log 和 LogAnalysis.log 的路径如下:
<Temp Directory Location>/LogAnalysis/LogAnalysis{Timestamp}.log
在独立模式下运行该实用程序
如果要在安装进程完成后执行日志分析,请使用以下命令运行该实用程序:
• 对于 Windows:
<INSTALLATION_LOCATION>\PSI\LogAnalyzerUtility\LogAnalyzer.bat
<INSTALLATION_LOCATION>/PSI/installer/PTCSolnInstaller-installer.properties
• 对于 Linux:
sh <INSTALLATION_LOCATION>/PSI/LogAnalyzerUtility/LogAnalyzer.sh
<INSTALLATION_LOCATION>/PSI/installer/PTCSolnInstaller-installer.properties
安装目录的构件报告以 zip 文件的形式提供。此 zip 文件包含从安装位置收集的日志文件、注册表文件和摘要文件等构件,并用于生成日志分析报告。例如:
INSTALLATION_LOCATION\PSI\installer\logs\logsToAnalyze20230404_134248.028.zip
限制
在以下情况下不会生成日志分析报告:
• 修补程序安装后。
• 如果在触发第一个子安装之前出现故障,即在启动实际安装过程之前单击 PSI 面板中的取消按钮。
• 如果在代码中处理了任何错误或异常,且 PSI 没有被终止,则在这种情况下,不会生成此报告。
• 如果发生诸如 Java 进程终止之类的错误,则不会执行日志分析实用程序。