Enabling debug logging for Pluggable Protocols Architecture (PPA)

Products

• IT Management Suite
• Out of Band Management Component
• Real-Time System Manager
• Monitor Solution for Servers

Issue/Introduction

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

Environment

8.x

Resolution

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%]
  

5. 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.