Windchill PSI Log Analyzer 公用程式
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 在更新模式下失敗時在獨立模式下執行 Log Analyser，當載入點存在時，應將 %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
安裝目錄的產出物報告可以壓縮檔的形式提供。此壓縮檔包含從安裝位置收集並用於產生記錄檔分析報告的產出物，例如記錄檔、登錄檔與摘要檔。例如：
INSTALLATION_LOCATION\PSI\installer\logs\logsToAnalyze20230404_134248.028.zip
限制
在下列情況下，不會產生記錄檔分析報告：
• 安裝修正檔之後。
• 在觸發第一次子安裝之前發生失敗時，即當您在開始實際安裝流程之前點擊 PSI 面板中的取消按鈕時。
• 如果在程式碼中處理任何錯誤或例外，且未終止 PSI，在該情況下，不會產生此報告。
• 如果發生 Java 流程終止之類的錯誤，則不會執行記錄檔分析公用程式。