Installing OMEGAMON Data Requester in an existing Grafana environment

Edit online

You can install OMEGAMON Data Requester in an existing Grafana environment to analyze and visualize the data gathered from OMEGAMON monitoring agents.

Before you begin

Complete the tasks provided in the Prerequisites section. See Prerequisites for installing OMEGAMON Data Requester.
You must ensure that the user on the platform where Grafana is installed has read access to the OMEGAMON Data Requester files and directories.

Procedure

Stop the Grafana server.
Locate the default configuration file of the Grafana instance.

The default location of the configuration file in Linux is as follows:
/etc/grafana/grafana.ini

Tip: You can copy the configuration file and rename it to custom.ini to customize your Grafana configuration.
Identify the plugins parameter in the [path] section of the configuration file. If the plugins parameter entry is commented out, remove the comment to allow Grafana to scan and search for installed plugins automatically.

Note: Grafana is configured to automatically scan for installed plugins in the default directory, located at data/plugins.
If you want to store OMEGAMON Data Requester in a different location, specify the path where you want to extract the content of OMEGAMON Data Requester in the plugins parameter.
Set the value of allow_loading_unsigned_plugins to omegamon-app,omegamon-datasource in the [plugins] section of the configuration file.
Extract the content of OMEGAMON Data Requester to the folder you specified for the plugins parameter.

For instance, if the value of the plugins parameter is set to data/plugins, you must extract the content of OMEGAMON Data Requester into the data/plugins folder.
To import the starter dashboards provided with OMEGAMON Data Requester, add the following parameters to your existing Grafana installation command and run it:
```
--volume "<path_to_provisioning_dashboards_config_file>:/etc/grafana/provisioning/dashboards/dashboards.yaml" \
--volume "<path_to_provisioning_dashboards>:/etc/dashboards"
```
Where:
- path_to_provisioning_dashboards_config_file is the path of the omegamon-dashboards-config.yaml file.
- path_to_provisioning_dashboards is the path of the OMEGAMON starter dashboards.
Note: The command provided is for Grafana running in a Docker container.
Restart Grafana to load OMEGAMON Data Requester.
Verify the installation of OMEGAMON Data Requester by logging in to the Grafana user interface.

Results

You have installed OMEGAMON Data Requester.

What to do next

You can add a data source to verify that OMEGAMON Data Requester has loaded correctly and to retrieve data from Tivoli Enterprise Monitoring Server. See Adding data sources.