Debug Logging. Guide

(1)

|

_{Debug Logging}

(2)

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.

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

(3)

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.

(5)

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:

(6)

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:

(7)

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.

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

Debug Logging. Guide

|

Debug Logging

Contents

AppSense Debug Logging

AppSense Application Manager

Agent Debug Logging

Rules Analyzer

Logging at Computer Start Up

AppSense Environment Manager

AppSense Performance Manager

Agent Debug Logging

Logging at Computer Start Up

AppSense Client Communications Agent

Agent Debug Logging

_{Debug Logging}