Troubleshooting the dashboards

This topic covers the following issues that you may encounter when using the dashboard and provides more information to help solve the problem.

I cannot access the dashboard.

There are several possible reasons that you cannot access the dashboard. The following list provides some actions that might resolve the problem. If the problem persists, report it. 

• Verify that the Tomcat server is running.
  If it is not running, start the Tomcat server (see Configuring your environment to use BMC Atrium Orchestrator dashboards for instructions).
• Verify that the healthdashboard.war file is located in the tomcat/webapps directory. 
• Verify that the dashboard URL is accurate (see Accessing the dashboards). The default port is 18080. If you modified the port number, ensure that the port number is correct.
• Verify that cookies are enabled in the browser.

What time zone is shown in the dashboard?

The default time zone shown in the dashboard is the time zone of the host server.

What is the session timeout value?

The dashboard times out after 30 minutes of inactivity. You must log back into the dashboard.

My data isn't refreshing.

Click the refresh icon . If the data does not update, check with the Grid administrator to ensure that BMC Atrium Orchestrator is running and that there are no problems on that side.

BMC Atrium Orchestrator is not running, but the dashboard is showing data.

If you logged into the dashboard before BMC Atrium Orchestrator stopped running, the last recorded data appears in the dashboard.

If you click the refresh icon  only the authentication server information appears in the dashboard. If you log out of the dashboard, you will not be able to log back into the dashboard while BMC Atrium Orchestrator is not running.

I do not see the fully qualified host name in the server information on the Home page.

The dashboard does not report the fully qualified host names. As long as the first part of the name matches, there should not be a problem.

I do not see the version in the server or peer information on the Home or Peers page.

Verify that the server is running and that it is running BMC Atrium Orchestrator version 7.8 or later. Earlier versions are not supported.

Adapter information is missing on the Home page.

Click the refresh icon  to ensure that the dashboard displays the latest data. If the adapter information is still missing, check with the Grid administrator to determine if there are any problems on the BMC Atrium Orchestrator side.

Job information is missing on the Home page.

If you believe that there are jobs running and you do not see them in the dashboard, first click the refresh icon  to ensure that the dashboard displays the latest data. If the job information is still missing, ask the Grid administrator to confirm that the jobs are running and, if they are running, to determine if there is a problem on the BMC Atrium Orchestrator side.

The dashboard does not reflect the changes that I made in the gridmap.properties file.

Restart the Tomcat server and log back into the dashboard. Changes to the gripmap.properties file take effect after you restart the Tomcat server (see Configuring your environment to use BMC Atrium Orchestrator dashboards for instructions).

Users do not see Value reports in my dashboard and there are reports available

Ensure that users have Grid Management permission (see Assigning grid permissions for more information).

I am trying to view Value reports for a daily time period, but no data is shown

Check that there is data in the database tables (see Grid performance table information). There should be data in the tables. If there is no data, check the following:

• Check that metrics collection is turned on (see Managing grid performance records).
• Review your database configuration (see Configuring the metrics and audit records database) to be sure that it is configured correctly.

Ensure that your metrics collection settings work with your Value report settings. For example, if users will view Value reports using daily report periods, the grid metric Collection option should be set to minutes or hours. See Managing grid performance records for information about metrics collection settings and see Value Dashboard for details about viewing Value reports.

The list of available processes on the Create Report screen does not show all the available processes.

You may see an error in the dashboard.log file that is similar to the following.

bmc.ao.datamanagent.ValueReportBean : Could not create a DBCP pool
org.apache.commons.dbcp.SQLNestedException: Cannot load JDBC driver class 'com.mysql.jdbc.Driver' 

Complete the following steps:

1. Verify that you have installed the JDBC driver in the AO_HOME/lib/add-ons directory for the dashboards. See Configuring the metrics and audit records database for instructions.
2. Restart the dashboard server (see Starting and stopping product components and services).
3. Execute each missing process through a schedule so that it creates a entry in the database and then click the refresh icon  in the Create Report screen to update the process list. Adding a process schedule for information.