How to enable Spectrum debug for the CA Performance Management integration

Document ID : KB000107963
Last Modified Date : 26/07/2018
Show Technical Document Details
Introduction:
When standard logging doesn't provide enough information to determine the root cause for a problem, enabling debug may be necessary.

This will detail the steps necessary to enable, manage and disable the Spectrum OneClick Tomcat web server debug for the CA Performance Management integration.
Background:
Helps to determine possible causes for various issues related to the product integration
Environment:
All supported Spectrum releases integrated with all supported CA Performance Management releases
Instructions:
Enable Debug
  1. Launch the Spectrum OneClick tomcat web servers administration page in web browser. Default is <OC_HostName>:80.
  2. Log in as the Spectrum administrative user.
  3. Go to the Administration page.
  4. Just below the Administration option, in the horizontal grey bar, select the Debugging option.
  5. From the grey bar on the left side select the "Web Server Debug Page (Runtime)" option.
  6. There are three debug options for the CA Performance Management to CA Spectrum integration listed in the Debug Controller list.
    1. Performance Center Integration
    2. Performance Center Integration Alarm Sync Tracking
    3. Performance Center Integration Sync
  7. If the problems with the integration are related to Alarm and Event synchronization enable all three options.
  8. If the problems with the integration are related to synchronization issues enable the "Performance Center Integration" & "Performance Center Integration Sync" options.
  9. At the bottom of the page ensure the Current Debug Level is set to MAX.
  10. Select the Apply button.

Managing Debug
  • This will generate logging in the Spectrum OneClick tomcat web servers log files. In Unix review the catalina.out file, in Windows review the stdout.log file.
  • If leaving this enabled long term, monitor log file growth to ensure unexpected disk full outages aren't encountered.
  • If necessary, to reset the log file and have it rotated, restart the tomcat web server service.
  • Note that that step will disable the debug. Ensure it's enabled again after the web server is restarted.
Disabling Debug

Option A: Disable debug
  1. Launch the Spectrum OneClick tomcat web servers administration page in web browser. Default is <OC_HostName>:80.
  2. Log in as the Spectrum administrative user.
  3. Go to the Administration page.
  4. Just below the Administration option, in the horizontal grey bar, select the Debugging option.
  5. From the grey bar on the left side select the "Web Server Debug Page (Runtime)" option.
  6. At the bottom of the Debug Controller List page select the "All Off" button.
Option B: Disable debug via service restart.

Disabling debug via Option A disables further logging but won't rotate the logs if they have become large. To disable the debug and rotate the logs at the same time, restart the restart the tomcat web server service.