How to enable debug logging for Pluggable Protocols Architecture (PPA)

Article:HOWTO9669  |  Created: 2009-01-20  |  Updated: 2011-11-10  |  Article URL http://www.symantec.com/docs/HOWTO9669
Article Type
How To



Question
How to enable debug trace logging for Pluggable Protocols Architecture (PPA)

Answer

To enable trace level debug logging for PPA, follow these steps:

  1. Open Windows Registry Editor via:  Start > Run > type:  regedit and click OK
      
  2. Access the following key:  HKEY_LOCAL_MACHINE\SOFTWARE\Altiris\PluggableProtocols
      
  3. Right-click PluggableProtocols and choose to create a new Key named:  Debug
      
  4. Right-click Debug and choose to add a DWORD value named:  Level  with a value of:  0

    This value alone will allow the debug output to be viewed by a 3rd party debugging tool (e.g.  Microsoft's DebugView, available with the SysInternals suite). If the debug output needs to be written to a file, add these additional values under the Debug key:

String named:  Dest with a value of:  file([absolute path and file name])  (e.g.  file(C:\temp\ppa.log) )

String named:  Format with a value of:  %time%($MM/$dd/$yy $hh:$mm:$ss) [%thread_id%]
  

  1. If on the Symantec Management Platform (SMP) server, restart the Altiris Object Host Service service. If on a Site Server, restart the Symantec Management Agent service
  
For additional AMT logging, include the following in step 4 above:
 
  1. Right-click PluggableProtocols and choose to create a new Key named:  AMT
      
  2. Right-click AMT and choose to add a DWORD value named:  TraceLevel  with a value of:  31

  
Note:  PPA debug provides intensive trace output data. Debug Viewer, or logs, will grow large rapidly. It is recommended to disable debug output immediately following diagnostive testing. To disable PPA debug output, delete the registry values under both the ..\Debug and ..\AMT keys.

  



Legacy ID



45169


Article URL http://www.symantec.com/docs/HOWTO9669


Terms of use for this information are found in Legal Notices