pg_lsclusters¶
Listet alle PostgreSQL-Cluster auf dem Server mit Version, Port, Zustand und Datenverzeichnis. Nur unter Debian und Ubuntu.

Syntax¶
pg_lsclusters [-h] [--json]
Optionen¶
| Option | Beschreibung |
|---|---|
-h |
Keine Überschriftszeile |
--json |
Ausgabe als JSON |
Verwandte Werkzeuge aus demselben Paket: pg_ctlcluster 17 main start|stop|restart|reload, pg_createcluster, pg_dropcluster und pg_upgradecluster für Versionssprünge. Die systemd-Unit eines Clusters heißt postgresql@17-main.
Beispiele¶
Alle Cluster auf dem Server:
pg_lsclusters
Ver Cluster Port Status Owner Data directory Log file
17 main 5432 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17-main.log
Nach einem Distributions-Upgrade von Debian 12:
pg_lsclusters
Ver Cluster Port Status Owner Data directory Log file
15 main 5432 online postgres /var/lib/postgresql/15/main /var/log/postgresql/postgresql-15-main.log
17 main 5433 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17-main.log
Die Daten liegen noch in Version 15 auf Port 5432. Der leere 17er-Cluster steht pg_upgradecluster im Weg: Entferne ihn vorher mit sudo pg_dropcluster 17 main --stop.
Einen Cluster stoppen und prüfen:
sudo pg_ctlcluster 17 main stop
pg_lsclusters -h
17 main 5432 down postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17-main.log
Wann brauche ich das?¶
- Um zu sehen, welche PostgreSQL-Versionen auf einem Server laufen und auf welchem Port
- Vor und nach einem Versionssprung, z. B. von 16 auf 17
- Wenn
psqlkeine Verbindung bekommt: Läuft der Cluster überhaupt?
Versionssprung unter Debian
Nach einem Distributions-Upgrade läuft der alte Cluster weiter. sudo pg_upgradecluster 16 main
kopiert ihn auf die neue Version; prüf die Anwendung und lösch den alten danach mit
sudo pg_dropcluster 16 main.
Zwei Cluster, zwei Ports
Wurde die neue Version installiert, während die alte noch läuft, bekommt der neue Cluster Port 5433. Anwendungen sprechen weiter mit dem alten auf 5432, bis du die Ports tauschst.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Vorhanden | ja (postgresql-common) |
ja (postgresql-common) |
nein: systemctl status postgresql |
nein: systemctl status postgresql |
Verwandte Befehle¶
pg_isready · psql · systemctl · apt