Setup the IBM Spectrum Scale Performance Monitoring Bridge for classic IBM Spectrum Scale devices

Step 1. Ensure that IBM Spectrum Scale meets prerequisite conditions

The IBM Spectrum Scale system must run 5.1.5.1 or above. For older releases please check the SUPPORT_ MATRIX containing an overview about all grafana-bridge versions and related backend code levels.

The bridge works in permanent communication with the pmcollector. Therefore it is recommended to install and run this tool directly on a pmcollector node.

In a multi-collector environment, there is no need to run the bridge on each pmcollector node separately, provided that they are configured in federated mode. Federation basically allows collectors to connect and collaborate with their peer collectors. If the peers have been specified, any query for measurement data must be directed to any of the collectors listed in the peer definition. The chosen collector will collect and assemble a response based on all relevant data from all collectors. For more information, please read Performance Monitoring tool overview.

On the collector node CherryPy Python package needs to be installed. For getting CherryPy packages on your machine follow this instructions.

Step 2. Set up IBM Spectrum Scale Performance Monitoring Bridge

Download the latest version in your favourite directory on the collector node.

Alternatively you can clone the source code including not published changes (not recommended for productive environments):

# git clone https://github.com/IBM/ibm-spectrum-scale-bridge-for-grafana.git

Start the bridge application by issuing:

# cd source/

# python3 zimonGrafanaIntf.py --apiKeyValue

You will be prompted by a command line interface to provide the 'password'. Enter the scale_grafana API key value(32 hexadecimal digits sequence). You can also pass the key value directly (not recommended) by the zimonGrafanaIntf.py script invocation following the '--apiKeyValue' input parameter name. Alternatively, store the key value in the config.ini file. For more options configuring and invoking the API key for an IBM Spectrum Scale Performance Monitoring Bridge please read the WiKi article.

If the bridge did establish the connection to the specified pmcollector and the initialization of the metadata was performed successfully, you should get the message "server started" at the end of line. Otherwise check the zserver.log stored in the zimonGrafanaIntf directory. Additionally, check the pmcollector service running properly by issuing:

# systemctl status pmcollector