Manually installing the performance monitoring tool

The performance monitoring tool is automatically installed by the installation toolkit. You can also install the performance monitoring tool manually.

For more information about the performance monitoring tool, see Configuring the performance monitoring tool.
For information about packages required before installation, see Software requirements.
For information about the installation toolkit, see Understanding the installation toolkit options.

A single collector can easily support up to 150 sensor nodes. The collector can be any node on the system. All sensors report to this node. Select any node in the system to be the collector node. For information on configuring the sensors and collectors, see Configuring the performance monitoring tool. You can manually install the tool by doing the following steps:

Download the installation images and install the performance monitoring packages.
For information on the default directories in which these packages are extracted, see Location of extracted packages.

Performance monitoring packages
```
gpfs.gss.pmsensors-version_release.os.target_arch.file_format
gpfs.gss.pmcollector-version_release.os.target_arch.file_format
```
Then, use your operating system’s native package management mechanism to install the packages.
For example:
- To install performance monitoring sensors on a Red Hat® Enterprise Linux® 7.x x86_64 node, use the following command:
```
rpm -ivh gpfs.gss.pmsensors-x.x.x-x.el7.x86_64.rpm
```
- To install performance monitoring sensors on a Red Hat Enterprise Linux 8.x x86_64 node, use the following command:
```
rpm -ivh gpfs.gss.pmsensors-x.x.x-x.el8.x86_64.rpm
```
- To install performance monitoring sensors on a SLES 15 x86_64 node, use the following command:
```
rpm -ivh gpfs.gss.pmsensors-x.x.x-x.sles12.x86_64.rpm
```
- To install performance monitoring sensors on an Ubuntu amd64 node, use the following command:
```
dpkg -i gpfs.gss.pmsensors_x.x.x-x.U*amd64.deb
```
- To install a performance monitoring collector on a Red Hat Enterprise Linux 7.x PPC64LE node, use the following command:
```
rpm -ivh gpfs.gss.pmcollector-x.x.x-x.el7.ppc64le.rpm
```

To configure performance monitoring after the packages are installed on all the selected nodes, use the following commands:

mmperfmon config generate --collectors collectorNode1[,collectorNode2,...]
mmchnode --perfmon –N sensorNode1[,sensorNode2...]

To enable performance monitoring on a protocol node for NFS or SMB, complete the following steps:
- For NFS:
  1. Install the pm-ganesha package as follows:
    - RHEL or SLES: rpm -ivh gpfs.pm-ganesha_version-release.os.target_arch.rpm
    - Ubuntu: dpkg -i gpfs.pm-ganesha_version-release.deb
  2. Ensure that the /opt/IBM/zimon/defaults/ZIMonSensors_nfs.cfg sensor is created as shown:
```
sensors={
        name = "NFSIO"
        period = 10
        type = "Generic"
        restrict = "cesNodes"
}
```
  3. Run the following command to add the sensor:
```
mmperfmon config add --sensors /opt/IBM/zimon/defaults/ZIMonSensors_nfs.cfg
```
  4. Run the following code to ensure that the newly added sensor is made visible to the system:
```
mmhealth node show nfs --refresh -N cesNodes
```
- For SMB:
  1. Run the following command to add the sensor:
```
mmperfmon config add --sensors /opt/IBM/zimon/defaults/ZIMonSensors_smb.cfg
```
    Note: No additional sensor package is needed for the SMB sensors.
  2. Run the following code to ensure that the newly added sensor is made visible to the system:
```
mmhealth node show smb --refresh -N cesNodes
```
If the protocol sensors are enabled on a GPFS-only node, you see an error message stating that the sensors are unavailable. However, the other sensors continue to run.
Start the sensors on each node using the systemctl start pmsensors.service command.
On the collector nodes, start the collector, using the systemctl start pmcollector.service command.
To ensure that sensors and collectors are restarted after the node reboots, you can enable them using the following commands:

Sensors

To enable sensors, use the systemctl enable pmsensors.service command.

To disable sensors, use the systemctl disable pmsensors.service command.

Collector

To enable the collector, use the systemctl enable pmcollector.service command.

To disable the collector, use the systemctl disable pmcollector.service command.

The collector node starts gathering all the requested metrics.

Important: Once the packages are installed, pmsensor and pmcollector services are activated automatically.

By default, the installation toolkit enables sensors on each protocol node (CES node) but not on the other GPFS nodes (non-CES nodes).

Metrics can be retrieved from any node in the system by using the mmperfmon query command. For more information, see mmperfmon command.

For more information about the performance monitoring tool, see Configuring the performance monitoring tool.