Troubleshooting XPS issues with xTrace

Products

• CA Single Sign On Federation (SiteMinder)

Issue/Introduction

xTrace is an XPSConfig option that captures XPS errors in Policy Store.

Use xTrace to diagnose failed XPS transactions in Policy Store.

With xTrace enabled, you can review the logs to identify when and why an XPS error occurred in Policy Store.

Environment

Siteminder release: 12.8.X
component: SMPLC 
OS: ALL 

 

Resolution

Ensure that Profiling is enabled in Policy Server Management Console:

• Open Policy Server Management Console.
• Click the Profiler tab.
• Ensure that the Enable Profiling option is selected and an output file is specified in the Output section.
• Click Configure Settings.
• Move the components whose transactions you want to monitor into Selected Components.
• Click Data.
  (NOTE: For a better tracing, it is a good practice to select the Date, Precise Time, PID, TID, SRC File, Function, and Message data fields.)
• Save the changes.
  
  

Enable the xTrace option in XPSConfig:

• Navigate to the bin folder in the siteminder_home directory.
• Type ./XPSConfig and press Enter.
• Type x and press Enter.
• All the attributes of xTrace are listed. By default, none of the attributes are selected.
• Type the option number that you want to trace and press Enter.
• Enable the attributes recommended by support.
• Synchronize the changes with Policy server, if running, to get the transaction logs.
• (Optional) Use the update option to preserve settings between Policy Server restarts.
• xTrace is enabled and the XPS Policy Store transactions and audit files are logged.

Review the xTrace enabled logs:

• Gather the smps.log, and the smtrace log (located in the path selected in Enabling Profiling step #3)

Additional Information

Reference: How to Use xTrace