Debug Logging Guide
The information contained in this document ("the Material") is believed to be accurate at the time of printing, but no representation or warranty is given (express or implied) as to its accuracy, completeness or correctness. AppSense Limited, its associated companies and the publisher accept no liability whatsoever for any direct, indirect or consequential loss or damage arising in any way from any use of or reliance placed on this Material for any purpose. 2000-2006 AppSense Limited. All Rights Reserved. Copyright in the whole and every part of this manual belongs to AppSense Limited ( the Owner ) and may not be used, sold, transferred, copied or reproduced in whole or in part in any manner or form or in or on any media to any person other than in accordance with the terms of the Owner's Agreement or otherwise without the prior written consent of the Owner. Trademarks AppSense is a trademark of AppSense Ltd. Microsoft, MS-DOS, Windows, Windows NT, Windows 2000, Windows XP, Windows Installer, Visual Basic and ActiveX are trademarks or registered trademarks of Microsoft Corporation. Other brand or product names are trademarks or registered trademarks of their respective holders. Patents AppSense Performance Manager includes patented technology. All rights reserved. Publication: 1 AppSense Debug Logging Page 2 of 8
Contents AppSense Debug Logging...4 AppSense Application Manager...4 Agent Debug Logging...4 Rules Analyzer...4 Logging at Computer Start Up...5 AppSense Environment Manager...5 AppSense Performance Manager...7 Agent Debug Logging...7 Logging at Computer Start Up...7 AppSense Client Communications Agent...8 Agent Debug Logging...8 AppSense Debug Logging Page 3 of 8
AppSense Debug Logging This document describes how to produce a debug log in each of the following AppSense agents. Each procedure requires administrator rights. AppSense Application Manager AppSense Environment Manager AppSense Performance Manager AppSense Client Communications Agent AppSense Application Manager Agent Debug Logging 1. Access the Services Control Panel by typing services.msc into the Start > Run dialog box. 2. Highlight the AppSense Application Manager Agent service, and choose Properties from the Action menu. 3. Click Stop to stop the agent. 4. Enter the following text into the Start parameters edit box: -log c:\amagentlog.log 5. Click Start to start the agent. 6. Re-do the actions which caused the issue 7. Stop the agent again, clear the Start parameters edit box, and restart the service. Rules Analyzer 1. Open the AppSense Application Manager Console, and expand the Rules Analyzer node. 2. Right click the Computers node and choose Add Computer(s). 3. Select the relevant computer, or enter the computer name manually. Click Add. Click OK when done to return. 4. Right click the node representing the computer added, and choose Start Logging. 5. Re-do the actions which caused the issue. 6. Right click the computer node again, and choose Stop logging. 7. Give the created log file a name, and click OK. 8. Expand the Retrieved Log Files node. 9. Right click the node representing the log created, and choose Export. AppSense Debug Logging Page 4 of 8
Logging at Computer Start Up 1. Access the Registry editor by typing regedit.exe into the Start > Run dialog box. 2. Navigate to the following key: HKEY_LOCAL_MACHINE\Software\AppSense Technologies\AppSense 3. Add a new STRING value DebugFile, and give it the value C:\AMAgentLog.log. 4. Add a new DWORD value DebugLevel, and give it the value 10. 5. Restart the computer to recreate the issue. 6. Access the Services Control Panel by typing services.msc into the Start > Run dialog box. 7. Highlight the AppSense Application Manager Agent service, and choose Stop from the Action menu. 8. Delete the registry keys added earlier. 9. Restart the service. AppSense Environment Manager 1. A debug logging tool has been made available for capturing Environment Manager log files: 2. To enable logging select the Logging ON option: AppSense Debug Logging Page 5 of 8
3. Enter a valid folder path to where the debug log files will be generated: 4. Set the debug level to 10 (the highest level): 5. You can choose to generate logs files for the Agent, the AgentAssistant, Lockdown or Device Manager: 6. If you choose to log Lockdown actions, you must specify the applications you wish to monitor and log: 7. If you choose to log Device Manager actions, you must specify the applications you wish to monitor and log: AppSense Debug Logging Page 6 of 8
8. It is also possible to reduce the size of the logs by turning off component subsystems, so that only the relevant areas are monitored: 9. To disable logging select the Logging OFF button: AppSense Performance Manager Agent Debug Logging 1. Access the Services Control Panel by typing services.msc into the Start > Run dialog box. 2. Highlight the relevant Performance Manager service, and choose Properties from the Action menu. 3. Click Stop to stop the agent. 4. Enter the following text into the Start parameters edit box: -log c:\pmagentlog.log 5. Click Start to start the service. 6. Re-do the actions which caused the issue 7. Stop the agent again, clear the Start parameters edit box, and restart the service. Logging at Computer Start Up 1. Access the Registry editor by typing regedit.exe into the Start > Run dialog box. 2. Navigate to one of the following keys, depending on which feature is demonstrating the issue: HKEY_LOCAL_MACHINE\Software\AppSense Technologies\Performance Manager 2005\PMCore HKEY_LOCAL_MACHINE\Software\AppSense Technologies\Performance Manager 2005\Bandwidth HKEY_LOCAL_MACHINE\Software\AppSense Technologies\Performance Manager 2005\Optimizer 3. Add a new STRING value DebugFile, and give it the value C:\PMAgentLog.log. 4. Add a new DWORD value DebugLevel, and give it the value 10. 5. Restart the computer to recreate the issue. 6. Access the Services Control Panel by typing services.msc into the Start > Run dialog box. 7. Highlight the relevant Performance Manager service, and choose Stop from the Action menu. 8. Delete the registry keys added earlier. 9. Restart the service. AppSense Debug Logging Page 7 of 8
AppSense Client Communications Agent Agent Debug Logging 1. Access the Registry editor by typing regedit.exe into the Start > Run dialog box. 2. Navigate to the following key: HKEY_LOCAL_MACHINE\Software\AppSense Technologies\Communications Agent 3. Add a new STRING value DebugFile, and give it the value C:\CCAgentLog.log. 4. Add a new DWORD value DebugLevel, and give it the value 10. 5. Access the Services Control Panel by typing services.msc into the Start > Run dialog box. 6. Highlight the AppSense Client Communications Agent service, and choose Restart from the Action menu. 7. Re-do the actions which caused the issue. 8. Delete the registry keys added earlier. 9. Restart the service. AppSense Debug Logging Page 8 of 8