PMDADS389LOG(1)

💖 pmdads389log — bestie's guide to the 389 Directory Server Log PMDA 💖

okay so real talk, you found the man page for pmdads389log, which lives in section 1 of the General Commands Manual, and honestly? it's giving "quietly essential infrastructure" and i'm obsessed. let's get into it 🫶

---

✨ NAME ✨

pmdads389log — the 389 Directory Server Log PMDA, no cap 💅

---

🌸 DESCRIPTION 🌸

so pmdads389log is a Performance Metrics Domain Agent (a PMDA, iykyk) and what it does is literally extract statistics from the 389 Directory Server access log, and it does that using the logconv.pl(1) utility. that's the whole vibe. it reads the log, it pulls the numbers, it hands them over. queen behavior 👑

---

🎀 INSTALLATION 🎀

first things first: pmdads389log reads a configuration file, and that file is:

• $PCP_PMDAS_DIR/ds389log/ds389log.conf

this file can contain overridden values (and heads up, they're Perl code, not vibes) for the settings listed at the start of pmdads389log.pl, namely:

• logconv.pl parameters
• minimal query interval
• 389 DS access log to use
• 389 DS log directory to use (this one kicks in if no file is specified)
• non-root user having read access to the access log file

once all of that is set up, you can access the names and values for the 389 DS performance metrics by doing the following as root:

# cd $PCP_PMDAS_DIR/ds389log
# ./Install

and when you wanna uninstall, same energy, also as root:

# cd $PCP_PMDAS_DIR/ds389log
# ./Remove

⚠️ ok important one bestie: pmdads389log is launched by pmcd(1) and should never be executed directly. like, do not. the Install and Remove scripts are the ones that notify pmcd(1) when the agent is installed or removed, so let them do their job. periodt 💀

---

🦋 FILES 🦋

• $PCP_PMDAS_DIR/ds389log/ds389log.conf — configuration file for the pmdads389log agent
• $PCP_PMDAS_DIR/ds389log/Install — installation script for the pmdads389log agent
• $PCP_PMDAS_DIR/ds389log/Remove — undo installation script for the pmdads389log agent
• $PCP_LOG_DIR/pmcd/ds389log.log — default log file for error messages from pmdads389log
• /var/log/dirsrv/slapd-.../access — the 389 Directory Server access log parsed by logconv.pl

---

🌈 PCP ENVIRONMENT 🌈

so the environment variables with the prefix PCP_ are what parameterize the file and directory names used by PCP. on each installation, the file /etc/pcp.conf contains the local values for these variables. and if you wanna get fancy, the $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5). very demure, very mindful ✨

---

👑 SEE ALSO 👑

PCPIntro(1), logconv.pl(1), pmcd(1) and pmdads389(1). go read them, they're all part of the same little family 🫶

---

and that's the whole page, bestie!! this one comes to you from Performance Co-Pilot, version PCP — that's the source and the version right there, no date on this one, it's mysterious like that 🧚 stay slaying, and remember: never run the agent directly. mwah 💖✨