---
name: "pmdads389"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmdads389"
---

# pmdads389(1)

389 Directory Server PMDA

## NAME

**pmdads389** - 389 Directory Server PMDA

## DESCRIPTION

**pmdads389** is a Performance Metrics Domain Agent (PMDA) which extracts live performance data from a running 389 Directory Server instance.

See the Red Hat Directory Server Administration Guide for description for each metric.

## INSTALLATION

**pmdads389** reads an optional configuration file

-

  - •

    *`$PCP_PMDAS_DIR`/ds389/ds389.conf*

This file can contain overridden values (Perl code) for the settings listed at the start of *pmdads389.pl*, namely:

-

  - •

    LDAP server

  - •

    bind DN

  - •

    bind password

  - •

    default search scope

  - •

    default search base

  - •

    default search filter

  - •

    query interval

  - •

    List of sources

  - •

    List of attributes to display for each source

Please use the provided ds389.conf.example as a starting point. Once this is setup, you can access the names and values for the 389 DS performance metrics by doing the following as root:

```
# cd $PCP_PMDAS_DIR/ds389
# ./Install
```

To uninstall, do the following as root:

```
# cd $PCP_PMDAS_DIR/ds389
# ./Remove
```

**pmdads389** is launched by [**pmcd**(1)](/pmcd/1.md) and should never be executed directly. The Install and Remove scripts notify [**pmcd**(1)](/pmcd/1.md) when the agent is installed or removed.

## FILES

- *`$PCP_PMDAS_DIR`/ds389/ds389.conf.example*

  example configuration file for the **pmdads389** agent

- *`$PCP_PMDAS_DIR`/ds389/ds389.conf*

  configuration file for the **pmdads389** agent

- *`$PCP_PMDAS_DIR`/ds389/Install*

  installation script for the **pmdads389** agent

- *`$PCP_PMDAS_DIR`/ds389/Remove*

  undo installation script for the **pmdads389** agent

- *`$PCP_LOG_DIR`/pmcd/ds389.log*

  default log file for error messages from **pmdads389**

## PCP ENVIRONMENT

Environment variables with the prefix **PCP\_** are used to parameterize the file and directory names used by PCP. On each installation, the file */etc/pcp.conf* contains the local values for these variables. The **$PCP\_CONF** variable may be used to specify an alternative configuration file, as described in [**pcp.conf**(5)](/pcp.conf/5.md).

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**ldapsearch**(1)](/ldapsearch/1.md), [**pmcd**(1)](/pmcd/1.md) and [**ns-slapd**(8)](/ns-slapd/8.md).