PeopleSoft Plug-in Diagnostics Utility

With the PSFT Plug-in diagnostics utility, you can troubleshoot issues to:

• CapturesPSFT Plug-in run-time environment.

• Capture important PSFT domain configuration files to get an idea about any customization on them.

• Ascertain diagnostic hints in the diagnostic log files as to what environment related settings might be missing.

• Capture the output of any PSFT admin commands.

PeopleSoft Plug‐in has a built‐in feature on EM Agent diagnosing issues related to environment set up. For more information, see E-PSEM: Diagnostic Utility to troubleshoot issues with PeopleSoft Plug-in for Enterprise Manager (Doc ID 1614036.1) to troubleshoot issues with PeopleSoft Plug‐in for Enterprise Manager.

1. 2. r 3. Additionally it is recommended to set the generic logging also to "DEBUG" mode when enabling diagnostics because we can correlate actions better between generic log messages and diagnostics log messages. AGENT_HOME/plugins/oracle.apps.psft.agent.plugin_12.1.0.2.0/config/psemagentlogging.properties AGENT_HOME/plugins/oracle.apps.psft.agent.plugin_12.1.0.2.0/config/psemmetricslogging.properties AGENT_HOME/plugins/oracle.apps.psft.discovery.plugin_12.1.0.2.0/config/psemdiscoverylogging.properties log4j.rootCategory=DEBUG, emagentlogAppender, emagenttrcAppender Note: It would be better to turn-on diagnostics only when needed as it generates too many log messages into diagnostic log files. Also before starting to diagnose an issue, it is better to clean up all old logs from under "$HOME/psft/pt/emplugin/log" and "$HOME/psft/pt/emplugin/log/diag" locations. To search for Diagnostic Hints thrown by the PSFT Plug-in into the diagnostic log files - psemdiscoverydiag.trc, psemagentdiag.trc & psemmetricsdiag.trc search for the string pattern - "XXX DIAGNOSTIC HINT XXX" Note: Enabling Diagnostic utility creates a "diag" folder under the Agent logging location - $HOME/psft/pt/emplugin/log/diag - only upon first discovery of a target. However if you are investigating diagnostics for Monitoring or Target Management issue, then you can manually create this "diag" folder - $HOME/psft/pt/emplugin/log/diag - to avoid seeing exceptions related to this folder not being found.