Configuring your environment to use BMC Atrium Orchestrator dashboards

To use the dashboards, you must complete the following tasks:

Configure metrics collection and the metrics database

To use the Value Dashboard and have access to historical data in the Health Dashboard, ensure that the following requirements are met:

For complete information on setting up metrics collection in BMC Atrium Orchestrator, see Managing metrics and audit records

Before using the dashboard, ensure that there is data in the database tables. See Grid performance table information.

Start the dashboard server

During the installation, a Tomcat server was installed for use with the dashboards. Start the dashboard server now (see Starting and stopping product components and services for instructions).

Configure the dashboard property files

Configure the following property files for use with the dashboards:

  • gridmap.properties — The dashboards use the grid name and host server specified in this file to make the dashboard connection. This file is required for dashboard use.
  • gridhosts.properties — The dashboards use the grid configuration to validate the specified setup and alert you if there are mismatches between the specified setup and the actual setup. This file is optional.
  • hdb.properties — This file contains dashboard and report default values that can be modified. For instructions, see Changing dashboard and report default settings.

If you had the earlier version of the Health Dashboard and you made a backup of these files that were already configured, you can replace the new files with your backup copies.

In these instructions, AO_HOME represents the dashboard installation location.

To configure the dashboard property files

  1. Navigate to the AO_HOME/tomcat/webapps/baodashboard/WEB-INF/classes directory.
  2. Edit the gridmap.properties file and provide the following information:
    <logicalName.gridName>=<hostName>

    Important

     Ensure that you use the logical name in the format as shown here:

     <logicalName.gridName>=<hostName>

    • <logicalName.gridName> represents the logical host name and the name of the grid.
    • <hostname> represents the fully qualified server host name.

      For example:
      TestGrid1.MyGrid=apple.bmc.com

      If you have a high-availability configuration distribution peer (HA-CDP), include that peer in gridmap.properties, so that it is available in the Grid Selection menu (at login) when your configuration distribution peer (CDP) is down. The HA-CDP only will be listed in the Grid Selection menu if you entered it in gridmap.properties. For example:
      TestGridHacdp.MyGrid=grape.bmc.com

      You can include an unlimited number of grids. 
  3. Save your changes to the file. 
  4. Edit the gridhosts.properties file and provide the following information:
    <logicalName.gridName.peerName>=<hostName>

    Important

     Ensure that you use the logical name in the format as shown here:

     <logicalName.gridName>=<hostName>

    • <logicalName.gridName.peerName> represents the logical host name, the name of the grid, and the name of the peer.
    • <hostName> represents the fully qualified server host name.

      For example:
      TestGrid1.MyGrid.CDP=orange.bmc.com
      TestGridHacdp.MyGrid.HACDP=grape.bmc.com


      Provide all of the peers in your grid.

      This information is used by the dashboard as benchmarks and for alerts. The dashboards will detect peers that do not match the provided information if they are running. Peers that are not listed in this file and not running are not included in the dashboards.

      Do not change peer host names after the installation. If they are changed after the installation, the peer will appear as not running in the dashboards.

  5. Save your changes to the file.

Restart the dashboard server

See Starting and stopping product components and services for instructions.

Ensure that users have the correct permissions to access the dashboards

Only administrators can access the Health Dashboard. Only administrators can create Value reports and add them to the Value Dashboard page.

To view Value reports, users must have Grid Management permission (see Assigning grid permissions for more information).

Where to go from here

Access the dashboards (Accessing the dashboards).

If you are an administrator, you can create Value reports and configure the Value Dashboard Home page (see Setting up the Value Dashboard and reports for required settings and how to create reports).


Was this page helpful? Yes No Submitting... Thank you

Comments