Windchill PSI Log Analyzer Utility
Windchill provides Log Analyzer utility that generates a failure analysis file in case of PSI failure.
Pre-requisites
• Java version supported by Windchill, installed on your machine
• Property file location is required to run the utility
#Linux#
<Installation Location>/PSI/installer/PTCSolnInstaller-installer.properties
#Windows#
<Installation Location>\PSI\installer\PTCSolnInstaller-installer.properties
Running the utility on PSI failure
The utility is triggered only when failure is encountered during PSI installation. No manual intervention is required to run the utility. An analysis report for <Installation_Location> artifacts is generated in text file format and is located at <Installation_Location>. The report contains basic information about the operating system, Java version, Windchill version, sub installer chosen, and exception/ fatal error in the logs. The name of the report file is “logsToAnalyze” and is appended with a timestamp. The extension of the file is “.log”, for example: logsToAnalyze20230328_110245.233.log. An example of the file path is given below:
<INSTALLATION_LOCATION>\PSI\installer\logs\logsToAnalyze20230328_110245.233.log
Running the Utility in Standalone Mode
If you want to perform log analysis after the installation process is complete, use the following commands to run the utility:
• For Windows:
<INSTALLATION_LOCATION>\PSI\LogAnalyzerUtility\LogAnalyzer.bat <INSTALLATION_LOCATION>/PSI /installer/PTCSolnInstaller-installer.properties
• For Linux:
sh <INSTALLATION_LOCATION>/PSI/LogAnalyzerUtility/LogAnalyzer.sh <INSTALLATION_LOCATION>/PSI /installer/PTCSolnInstaller-installer.properties
The artifacts report for installation directory is available as a zip file. This zip file contains artifacts like log files, registry files, and summary file collected from the installation location and used for generating log analysis report. For example:
INSTALLATION_LOCATION\PSI\installer\logs\logsToAnalyze20230404_134248.028.zip
Limitations
A log analysis report is not generated in the following cases:
• After patch installation.
• When there is a failure before first sub installation is triggered, that is when you hit the cancel button in the PSI panel before the actual installation process is started.
• If any error or exception is handled in code and PSI is not terminated in that case this report will not generated.
• If an error such as termination of Java process occurs, the log analysis utility does not execute.