PMDABONDING(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

πŸ’… PMDABONDING β€” the bonding PMDA, bestie edition ✨

okay so this is pmdabonding(1), a page from the General Commands Manual section, and it's about a Performance Metrics Domain Agent. Yeah. A PMDA. We're doing this. 🫢


🌸 NAME 🌸

pmdabonding β€” the Linux bonded interface performance metrics domain agent (PMDA). That's it, that's the whole name section, and honestly? Iconic. πŸ‘‘


✨ DESCRIPTION ✨

So pmdabonding is a Performance Metrics Domain Agent (PMDA, keep up πŸ’–) and what it does is export metric values from bonded network interfaces in the Linux kernel. That's the whole vibe. Bonded interfaces get their numbers collected, and this agent is the one serving them up. No cap.


πŸŽ€ INSTALLATION πŸŽ€

Wanna install the bonding PMDA? Bestie, you need to be root for this. Use the Install script, like this:

# cd $PCP_PMDAS_DIR/bonding
# ./Install

And when you're done with it and want it gone, uninstall time, also as root:

# cd $PCP_PMDAS_DIR/bonding
# ./Remove

Now here's the thing that trips people up β€” pmdabonding is launched by pmcd(1) and should never be executed directly. Like, never ever. Don't do it. πŸ™ˆ The Install and Remove scripts are the ones that go tell pmcd(1) hey, the agent got installed, or hey, the agent got removed. They handle the gossip so you don't have to.


πŸ“ FILES πŸ“

  • $PCP_PMDAS_DIR/bonding/Install β€” the installation script for the pmdabonding agent. Your bestie for setting things up. πŸ’…
  • $PCP_PMDAS_DIR/bonding/Remove β€” the undo installation script for the pmdabonding agent. The "actually never mind" button. πŸ¦‹
  • $PCP_LOG_DIR/pmcd/bonding.log β€” the default log file for error messages from pmdabonding. When things get messy, the receipts live here. 😭

🌈 PCP ENVIRONMENT 🌈

Environment variables with the prefix PCP_ are what parameterize the file and directory names used by PCP. Very main character behaviour of them.

Every time you install, the file /etc/pcp.conf contains the local values for these variables. ✨

And plot twist β€” the $PCP_CONF variable can be used to specify an alternative configuration file, as described in pcp.conf(5). So if you wanna be different, you absolutely can. πŸ’œ


πŸ‘‘ SEE ALSO πŸ‘‘

PCPIntro(1), pmcd(1) and ifenslave(8).

Go read them. They're giving lore. πŸ“š


mwah πŸ’‹ that's the whole page, and it comes to you from Performance Co-Pilot, version PCP, dated PMDABONDING(1) β€” stay bonded, stay slayed, periodt. πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from