Installation of performance monitoring tool using the installation toolkit

By default, the performance monitoring tool gets installed when IBM Spectrum Scale™ is installed on the system using the ./spectrumscale install command.

For more information on the performance monitoring tool, see Performance monitoring tool overview.

Start of changeDuring the installation, deployment, and upgrade phases, the installation toolkit performs following performance monitoring related configuration changes.
Installation
  • Sets nodes to performance monitoring nodes (mmchnode --perfmon -N Node1,Node2,Node3)
  • Installs pmsensor on any nodes that do not have the sensor.
  • Installs pmcollector on 2 nodes. Preference is the GUI node first, followed by NSD nodes.
  • Starts all sensors or collectors and activates all the default file system or node sensors.
  • Resets GPFSDIskCap and GPFSFilesetQuota sensors to default values: 86400 and 3600 respectively and restricts them to the 1st collector node.
Deployment
  • Sets nodes to performance monitoring nodes (mmchnode --perfmon -N Node1,Node2,Node3)
  • Installs pmsensor on any nodes that do not have the sensor.
  • Installs pmcollector on 2 nodes. Preference is the GUI node first, followed by NSD nodes.
  • Starts all sensors or collectors and activates all the default file system or node sensors.
  • Resets GPFSDIskCap and GPFSFilesetQuota sensors to default values: 86400 and 3600 respectively and restricts them to the 1st collector node.
  • Adds protocol sensors, corresponding to the activated protocols, to the active performance monitoring configuration and restricts them to protocol nodes. These sensors are NFSIO, SMBStats, SMBGlobalStats, CTDBStats, CTDBDBStats, SwiftAccount, SwiftContainer, SwiftObject, and SwiftProxy.
Upgrade
  • Upgrades pmsensor and pmcollector.
  • Resets GPFSDIskCap and GPFSFilesetQuota sensors to default values: 86400 and 3600 respectively and restricts them to the 1st collector node.
End of change
Note: Start of changeThe installation toolkit does not set any NFSIO parameter related setting.End of change
During the installation toolkit prechecks if it is found that the collector nodes require reconfiguring then the ./spectrumscale config perfmon -r on command needs to be run to enable the installation toolkit to perform this reconfiguration.
Note: A reconfiguration results in the removal of an existing collector and it might move the collector to different nodes and reset sensor data. Custom sensors and data might be erased. To disable reconfiguration, run the ./spectrumscale config perfmon -r off command.

If reconfiguration is disabled then the installation toolkit performs all installation tasks except for those related to performance monitoring and the management GUI, if GUI servers are specified.

Start of changeAfter the installation or the deployment completes and sensors are added, the latest state of events of type TIPS might not get immediately refreshed. As a result, the output of the mmhealth node show ces command might contain messages such as the following for the CES component:
nfs_sensors_not_configured(NFSIO)
smb_sensors_not_configured(SMBGlobalStats, SMBStats)
To resolve this issue, run the mmhealth node show --refresh command.End of change

For information on how to install the performance monitoring tool manually, see Manually installing the performance monitoring tool.

For information on performance monitoring related configuration in a cluster containing ESS, see ESS awareness with the installation toolkit.

For information on configuring the performance monitoring tool, see Configuring the performance monitoring tool.