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

book

Article ID: 181799

calendar_today

Updated On:

Products

Management Platform (Formerly known as Notification Server) Out of Band Management Component Real-Time System Manager Monitor Solution for Servers

Issue/Introduction

 

Resolution

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.