PMDASMART(1)

💖 PMDASMART 💖

okay so bestie, welcome to the pmdasmart manual page — that's the S.M.A.R.T Data PMDA, and she's literally a whole vibe. 🩺✨

---

✨ SYNOPSIS ✨

$PCP_PMDAS_DIR/smart/pmdasmart [-D debug]

like. that's the whole summoning ritual. 🕯️

---

🌸 DESCRIPTION 🌸

So pmdasmart is a Performance Metrics Domain Agent (PMDA, iykyk) and what she does is export metric values for Device Mapper on the local system. no cap. 🫶

She gets all her data by going through the smartctl(8) utility, which means — and this is the important part, bestie — that program has to be installed or she simply cannot function. it's giving "no smartctl, no service". 😭

If you wanna go deeper on smartctl and smartmontools, the lore lives at https://smartmontools.org. go read it, it's iconic. 📚💅

---

🎀 INSTALLATION 🎀

Wanna install the SMART PMDA? slay. do it as root, using the Install script:

# cd $PCP_PMDAS_DIR/smart
# ./Install

and when you're done with her (noooo 😭), uninstall as root like this:

# cd $PCP_PMDAS_DIR/smart
# ./Remove

okay important thing, don't skip this: pmdasmart is launched by pmcd(1) and should never be executed directly. she's not a solo artist, she's in a group project. 👑

Also the Install and Remove scripts handle the whole "hey pmcd, she's here now / she's gone now" notification thing for you, so you don't have to. considerate queens. 💖

---

🦋 FILES 🦋

• $PCP_PMDAS_DIR/smart/help — the default help text file for the smart metrics, aka her little glossary 📖
• $PCP_PMDAS_DIR/smart/Install — the installation script for the pmdasmart agent ✨
• $PCP_PMDAS_DIR/smart/Remove — the undo installation script for the pmdasmart agent, the "nvm bestie" button 🙈
• $PCP_LOG_DIR/pmcd/smart.log — the default log file where pmdasmart drops her error messages 💀

---

🌈 PCP ENVIRONMENT 🌈

okay so env vars with the prefix PCP_ are the ones that parameterize all the file and directory names that PCP uses. every time you install, the file /etc/pcp.conf is holding the local values for those variables. 📌

and if you want a different config file entirely? you can use the $PCP_CONF variable to point at an alternative one — it's all described over in pcp.conf(5). main character energy from a config file, honestly. 👑

---

💅 DEBUGGING OPTIONS 💅

• -D, --debug — turns on extra diagnostics on stderr so you can triage problems. lowkey warning though: the info is sometimes cryptic and it's primarily meant to guide developers, not end-users. so like, don't panic if it reads like a riddle. 🙈 debug is a comma separated list of debugging options, and if you wanna know what all of them mean, hit up pmdbg(1) with the -l option to get the full list. 💖

---

⭐ SEE ALSO ⭐

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

go read them, bestie, they're all connected fr fr 🫶🌸

---

no cap: this page is part of Performance Co-Pilot (PCP), and this specific manual is PMDASMART(1) — stay hydrated, log your metrics, and remember she only runs under pmcd 💖✨🧚