PMDAGPFS(1)

πŸ“¦
version 7.2.2 Β· 2 versions
, in arch rolling, centos-stream 10, centos-stream 9, debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’… PMDAGPFS β€” bestie edition

okay so this is the manual page for pmdagpfs, a Performance Metrics Domain Agent (PMDA) β€” and no, we are not skipping the intro, sit down, hydrate, it's giving main character energy.


✨ NAME ✨

pmdagpfs β€” the gpfs filesystem statistics performance metrics domain agent (PMDA). that's it, that's the whole name, and honestly? iconic. πŸŽ€


🌸 DESCRIPTION 🌸

so like, pmdagpfs is a Performance Metrics Domain Agent (PMDA) β€” and what does a PMDA do, you ask? it exports metric values, bestie. that's the whole job. πŸ’–

this specific one pulls those metric values out of the /usr/lpp/mmfs/bin/mmpmon program, so you get the tea β˜• on your mounted gpfs filesystems. literally just filesystem statistics, served fresh, no cap.


πŸ¦‹ INSTALLATION πŸ¦‹

wanna install the gpfs PMDA? okay so you gotta do it as root (yes, root, the actual boss πŸ‘‘) using the Install script:

# cd $PCP_PMDAS_DIR/gpfs
# ./Install

and when you're done with it and wanna uninstall? as root, again:

# cd $PCP_PMDAS_DIR/gpfs
# ./Remove

now listen, this part is important, don't skip it:

pmdagpfs is launched by pmcd(1) and should never be executed directly. like, ever. don't do it. not even once. πŸ™ˆ

the Install and Remove scripts are the ones doing the communicating β€” they notify pmcd(1) when the agent gets installed or removed. they're the group chat mods of this whole operation, fr fr. 🫢


πŸ“ FILES πŸ“

  • $PCP_PMDAS_DIR/gpfs/Install β€” the installation script for the pmdagpfs agent ✨
  • $PCP_PMDAS_DIR/gpfs/Remove β€” the undo installation script for the pmdagpfs agent (the "jk, take it back" button) πŸ’…
  • $PCP_LOG_DIR/pmcd/gpfs.log β€” the default log file where pmdagpfs drops its error messages. this is where it vents, lowkey. 😭

🌈 PCP ENVIRONMENT 🌈

okay so here's the vibe: environment variables with the prefix PCP_ are what parameterize the file and directory names that PCP uses. basically they're the settings menu, iykyk.

every time you install, the file /etc/pcp.conf holds the local values for all these variables. πŸ“

and if you wanna get spicy with it β€” the $PCP_CONF variable can be used to point at an alternative configuration file instead. fancy. as described in pcp.conf(5), which is your required reading, bestie. no skipping. ⭐


πŸ’œ SEE ALSO πŸ’œ

go read those next, you're doing amazing sweetie 🧚


and that's the whole page, periodt. πŸ’–βœ¨

this was brought to you by Performance Co-Pilot, rocking the PCP version tag, dated in that classic manual page way β€” mwah, slay, no notes. πŸŽ€πŸ”₯

πŸ“¦ where this page comes from