Overview

Troubleshooting an application is most successful when you know how to find clues. This book provides troubleshooting references for the Main Console component of HiCommand(R) Tuning Manager, as it relates to server applications.

About Data Collection Problems and Causes

Data collection problems may be attributed to the following causes:

Agent communication failures
Collection Manager failure
Database failure
The agent exhibits slow response times, which results in lag in reporting data to later polling periods
Network problems
The host that Tuning Manager or the agent is installed on is unusable on this network
Hardware malfunctions
The clock on the host where the agent has been installed is slower than the clock on Tuning Manager.
An agent connection/disconnection policy: If the agent does not report data for a long time, the agent connection policy might be the problem. For example, if Automatic Disconnection and Manual Connection are set up, Tuning Manager will stop communicating with the agent and will not reconnect.

Troubleshooting Steps

When you encounter unexpected problems while operating Tuning Manager, adopt the following diagnostic steps:

Examine log files. Start by examining logs for the Tuning Manager application or the Tuning Manager agents. Often the log file reveals underlying causes for the problem.

For information about Log Files for agents, see the HiCommand Tuning Manager Agent Administration Guide.

Use the manual to check the error message contents recorded in the log. See the HiCommand Tuning Manager Messages Reference.
Examine operating system logs to determine whether an application-level or operating system-level event has been recorded: Under Windows(R), consult the Event Viewer.
Check on the state of processes for Tuning Manager and its components:
– Windows: Examine the Services Panel.
– Solaris(TM): Run ps.
Check the disk capacity to make sure there is sufficient free space. If the free space is insufficient, increase it by deleting the files that you created after the installation of Tuning Manager.