Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 11 additions & 9 deletions psmdb-features/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
name: psmdb-features
description: "What Percona Server for MongoDB (PSMDB) adds beyond MongoDB Community Edition, and how to configure it. Use this skill when the user asks about PSMDB hot backup, data-at-rest encryption, audit logging, LDAP/Kerberos/OIDC authentication, the in-memory storage engine, log redaction, or 'how do I get MongoDB Enterprise feature X for free'. PSMDB is a drop-in replacement for MongoDB Community that ships most MongoDB Enterprise features as open source. KEY POINT - several features are version-gated (KMIP and Kerberos since 6.0.2-1, OIDC since 7.0, OpenBao KMS in 8.0) and the Transparent Huge Pages requirement REVERSES at 8.0; agents that assume uniform behavior across 6.0/7.0/8.0 will emit wrong config. PSMDB does NOT include SNMP monitoring."
description: "What Percona Server for MongoDB (PSMDB) adds beyond MongoDB Community Edition, and how to configure it. Use this skill when the user asks about PSMDB hot backup, data-at-rest encryption, audit logging, LDAP/Kerberos/OIDC authentication, the in-memory storage engine, log redaction, or 'how do I get MongoDB Enterprise feature X for free'. PSMDB is a drop-in replacement for MongoDB Community that ships most MongoDB Enterprise features as open source. KEY POINT - several features are version-gated (OIDC since 7.0, OpenBao KMS since 7.0.24-13 / 8.0.16-5; 6.0 is EOL) and the Transparent Huge Pages requirement REVERSES at 8.0; agents that assume uniform behavior across 7.0/8.0/8.3 will emit wrong config. PSMDB does NOT include SNMP monitoring."
---

# Percona Server for MongoDB (PSMDB) Features

*Last updated: 2026-06-02*
*Last updated: 2026-11-10*

PSMDB is a source-available, drop-in replacement for MongoDB Community Edition that adds, for free, most of what MongoDB charges for in Enterprise. Same wire protocol, same drivers. The value is the extra surface: hot backup, data-at-rest encryption, auditing, external auth, the in-memory engine, and log redaction.

> **Versions:** PSMDB **6.0**, **7.0**, **8.0** (all maintained). 8.0 tracks MongoDB Community 8.0.x. Several features are version-gated - see each section.
> **Versions:** PSMDB **7.0**, **8.0**, **8.3** maintained. **8.3 is GA** since 8.3.13-4 (2026-10-27); upgrade to 8.3 only from 8.0. **6.0 is EOL** (most recent release 6.0.29-23, 2026-06-24) - recommend upgrading, don't plan new 6.0 deployments. Several features are version-gated - see each section.

## What PSMDB adds beyond MongoDB Community

Expand All @@ -35,8 +35,8 @@ PSMDB is a source-available, drop-in replacement for MongoDB Community Edition t
| "Enable encryption on the existing database" | Data-at-rest encryption can only be enabled on an **empty** database at first `mongod` start. You cannot toggle it (or change cipher mode) on a server that already has data - it requires wiping `dbPath` and re-syncing/restoring. |
| Treating hot backup as a cluster-consistent backup | `createBackup` is **per-node and physical** - it snapshots one `mongod`'s data dir with no cross-replica-set or cross-shard coordination. For consistent replica-set / sharded backups use **Percona Backup for MongoDB (PBM)** - see the `pbm-recipes` skill. |
| Configuring OIDC on PSMDB 6.0 | OIDC/OAuth 2.0 is **7.0+**. The 6.0 authentication docs have no OIDC section. |
| Configuring KMIP or Kerberos on a base 6.0 install | Both were added in **6.0.2-1**, not at 6.0.0. |
| Pointing at OpenBao as a KMS on 6.0 | OpenBao is documented as a key server in **8.0**; 6.0 lists Vault, KMIP, and keyfile only. |
| Configuring KMIP or Kerberos on 6.0 | **6.0 is EOL** - upgrade to 7.0+ first. (On 6.0 both needed 6.0.2-1+.) |
| "OpenBao needs 8.0" / OpenBao on 6.0 | OpenBao KMS arrived in **7.0.24-13** and **8.0.16-5**. Not in 6.0 (EOL). |
| Assuming PSMDB's LDAP is identical to MongoDB Enterprise native LDAP | PSMDB's documented LDAP authentication uses the **`saslauthd` SASL proxy** model and is labeled "(legacy)". LDAP **authorization** (direct bind) is a separate feature. Don't conflate them or assume Enterprise's exact config transfers. |

## Recipe: hot backup (single node, physical)
Expand All @@ -60,7 +60,7 @@ security:
encryptionKeyFile: /etc/mongodb/keyfile
```

Generate the key: `openssl rand -base64 32` (32-char base64), perms `600`. For external key management use the Vault, KMIP, or OpenBao blocks instead of `encryptionKeyFile`:
Generate the key: `openssl rand -base64 32` (32 random bytes = 44 base64 characters), perms `600`. For external key management use the Vault, KMIP, or OpenBao blocks instead of `encryptionKeyFile`:

```yaml
# HashiCorp Vault (KV Secrets Engine v2 with versioning)
Expand All @@ -74,7 +74,7 @@ security:
serverCAFile: /etc/mongodb/vault.crt
```

KMIP since 6.0.2-1; OpenBao in 8.0.
OpenBao since 7.0.24-13 / 8.0.16-5.

## Recipe: audit logging

Expand Down Expand Up @@ -108,7 +108,7 @@ Log redaction does not redact debug messages or `system.profile` entries - it co

## Call `percona-dk` for fresh facts

PSMDB features are version-gated and config syntax differs across 6.0/7.0/8.0. For any "is X supported on version Y", exact config key, or release-note question, **call `search_percona_docs` with `version` set before answering, not as a fallback.**
PSMDB features are version-gated and config syntax differs across 7.0/8.0/8.3. For any "is X supported on version Y", exact config key, or release-note question, **call `search_percona_docs` with `version` set before answering, not as a fallback.**

```
search_percona_docs(query="PSMDB <your question verbatim>",
Expand All @@ -128,7 +128,8 @@ search_percona_docs(query="PSMDB <your question verbatim>",
- **THP polarity flips at 8.0** - enable for 8.0+, disable for 7.0 and earlier.
- **Encryption is set once, on an empty dbPath.** Not togglable on a populated server.
- **Hot backup is per-node, not cluster-consistent.** Use PBM for replica sets and shards.
- **Version gates:** KMIP + Kerberos = 6.0.2-1+; OIDC = 7.0+; OpenBao KMS = 8.0.
- **Version gates:** OIDC = 7.0+; OpenBao KMS = 7.0.24-13+ / 8.0.16-5+. 6.0 is EOL - upgrade.
- **Tarballs no longer ship Database Tools** from 7.0.45-24 / 8.0.34-15 / 8.3.13-4 (RPM/DEB unaffected). Pro builds were sunset in 6.0.27-21, 7.0.26-14 and 8.0.16-5; former Pro features are in public builds.
- **No SNMP.** PSMDB is not full Enterprise parity.

## Sources
Expand All @@ -138,3 +139,4 @@ search_percona_docs(query="PSMDB <your question verbatim>",
- [Data-at-rest encryption](https://docs.percona.com/percona-server-for-mongodb/8.0/data-at-rest-encryption.html)
- [Audit logging](https://docs.percona.com/percona-server-for-mongodb/8.0/audit-logging.html)
- [Authentication](https://docs.percona.com/percona-server-for-mongodb/8.0/authentication.html) · [In-memory engine](https://docs.percona.com/percona-server-for-mongodb/8.0/inmemory.html)
- Release notes: [8.3.13-4 (8.3 GA)](https://docs.percona.com/percona-server-for-mongodb/8.3/release_notes/8.3.13-4.html) · [8.0.16-5 (OpenBao, Pro sunset)](https://docs.percona.com/percona-server-for-mongodb/8.0/release_notes/8.0.16-5.html) · [7.0.45-24 (tarball tools)](https://docs.percona.com/percona-server-for-mongodb/7.0/release_notes/7.0.45-24.html) · [7.0.26-14 (Pro sunset)](https://docs.percona.com/percona-server-for-mongodb/7.0/release_notes/7.0.26-14.html) · [6.0.29-23](https://docs.percona.com/percona-server-for-mongodb/6.0/release_notes/6.0.29-23.html) · [7.0.24-13 (OpenBao)](https://docs.percona.com/percona-server-for-mongodb/7.0/release_notes/7.0.24-13.html) · [Upgrade 8.0 → 8.3](https://docs.percona.com/percona-server-for-mongodb/8.3/install/upgrade-from-80.html)
Loading