GPFS: Administration and Programming Reference - IRA Home

mmpmon Command
Name
mmpmon – Manages performance monitoring and displays performance information.
Synopsis
mmpmon [-i CommandFile] [-d IntegerDelayValue] [-p] [-r IntegerRepeatValue] [-s] [-t
IntegerTimeoutValue]
Description
Before attempting to use mmpmon, IBM suggests that you review this command entry, then read the
entire chapter, Monitoring GPFS I/O performance with the mmpmon command in General Parallel File
System: Advanced Administration Guide.
Use the mmpmon command to manage GPFS performance monitoring functions and display performance
monitoring data. The mmpmon command reads requests from an input file or standard input (stdin), and
writes responses to standard output (stdout). Error messages go to standard error (stderr). Prompts, if not
suppressed, go to stderr.
When running mmpmon in such a way that it continually reads input from a pipe (the driving script or
application never intends to send an end-of-file to mmpmon), set the -r option value to 1 (or use the
default value of 1) to prevent mmpmon from caching the input records. This avoids unnecessary memory
consumption.
Results
The performance monitoring request is sent to the GPFS daemon running on the same node that is
running the mmpmon command.
All results from the request are written to stdout.
There are two output formats:
v Human readable, intended for direct viewing.
In this format, the results are keywords that describe the value presented, followed by the value. For
example:
disks: 2
v Machine readable, an easily parsed format intended for further analysis by scripts or applications.
In this format, the results are strings with values presented as keyword/value pairs. The keywords are
delimited by underscores (_) and blanks to make them easier to locate.
For details on how to interpret the mmpmon command results, see Monitoring GPFS I/O performance
with the mmpmon command in General Parallel File System: Advanced Administration Guide.
Parameters
-i CommandFile
The input file contains mmpmon command requests, one per line. Use of the -i flag
implies use of the -s flag. For interactive use, just omit the -i flag. In this case, the input is
then read from stdin, allowing mmpmon to take keyboard input or output piped from a
user script or application program.
Leading blanks in the input file are ignored. A line beginning with a pound sign (#) is
treated as a comment. Leading blanks in a line whose first non-blank character is a pound
sign (#) are ignored.
228 GPFS: Administration and Programming Reference