14 November 2026

Wie funktioniert automatisches Failover bei PostgreSQL?

Stahlbrücke verbindet zwei Server-Racks im Rechenzentrum, eines gedimmt, das andere mit blauem LED-Licht – Symbol für automatisches Failover.
KI-generiertes Bild

Datenbankausfälle können für Unternehmen kritisch sein, besonders wenn PostgreSQL® das Herzstück produktiver Anwendungen bildet. Automatisches Failover bei PostgreSQL sorgt dafür, dass bei einem Ausfall des primären Datenbankservers ein Standby-Server die Arbeit nahtlos übernimmt, ohne dass manueller Eingriff erforderlich ist. Das Ergebnis: minimierte Ausfallzeiten und eine deutlich höhere Verfügbarkeit Ihrer Datenbankinfrastruktur.

In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie PostgreSQL-Hochverfügbarkeit mit automatischem Failover einrichten, testen und im Betrieb absichern. Die Schritte bauen aufeinander auf und führen Sie von den Grundvoraussetzungen bis zu einem produktionsreifen Setup.

Voraussetzungen für automatisches Failover bei PostgreSQL

Bevor Sie mit der eigentlichen Konfiguration beginnen, sollten Sie sicherstellen, dass Ihre Umgebung die notwendigen Grundbedingungen erfüllt. Ein stabiles Failover-Setup steht und fällt mit einer sorgfältig vorbereiteten Infrastruktur.

  • Mindestens zwei Server (ein primärer und ein Standby), die sich gegenseitig über das Netzwerk erreichen können
  • PostgreSQL® in derselben Version auf allen beteiligten Servern installiert
  • Synchronisierte Systemuhren auf allen Knoten (empfohlen: NTP-Dienst aktiv)
  • SSH-Zugang zwischen den Knoten ohne Passwortabfrage (SSH-Key-basierte Authentifizierung)
  • Ausreichende Netzwerkbandbreite und niedrige Latenz zwischen den Servern
  • Ein dedizierter PostgreSQL-Datenbankbenutzer mit Replikationsrechten
  • Ein virtueller IP-Adressdienst oder Load-Balancer für das Client-Routing (z. B. Keepalived oder HAProxy)

Prüfen Sie außerdem, ob Ihre Firewall-Regeln den PostgreSQL-Port (Standard: 5432) sowie den Kommunikationsport des späteren Failover-Managers zwischen den Knoten freigeben. Sind diese Voraussetzungen erfüllt, können Sie mit der Einrichtung der Replikation beginnen.

Streaming-Replikation als Grundlage konfigurieren

Konfigurieren Sie zuerst die Streaming-Replikation, da sie die technische Basis für jedes automatische Failover bei PostgreSQL bildet. Dabei überträgt der primäre Server kontinuierlich Write-Ahead-Log-Daten (WAL) an den Standby-Server, der so stets auf dem aktuellen Stand bleibt.

Primären Server vorbereiten

  1. Öffnen Sie die Datei postgresql.conf auf dem primären Server und setzen Sie folgende Parameter: wal_level = replica, max_wal_senders = 5 und wal_keep_size = 64 (Wert je nach Datenmenge anpassen).
  2. Legen Sie in der Datei pg_hba.conf einen Eintrag an, der dem Standby-Server die Replikationsverbindung erlaubt: host replication replikationsuser standby-ip/32 md5
  3. Starten Sie den PostgreSQL-Dienst neu, damit die Änderungen wirksam werden: systemctl restart postgresql
  4. Erstellen Sie einen dedizierten Replikationsbenutzer: CREATE ROLE replikationsuser WITH REPLICATION LOGIN PASSWORD 'sicheres_passwort';

Standby-Server einrichten

  1. Stoppen Sie den PostgreSQL-Dienst auf dem Standby-Server und leeren Sie das Datenverzeichnis.
  2. Erstellen Sie mit pg_basebackup eine Basiskopie des primären Servers: pg_basebackup -h primär-ip -U replikationsuser -D /var/lib/postgresql/data -P -Xs -R
  3. Der Parameter -R erstellt automatisch die Datei standby.signal sowie die notwendigen Verbindungsparameter in postgresql.auto.conf.
  4. Starten Sie PostgreSQL auf dem Standby-Server: systemctl start postgresql

Zur Überprüfung führen Sie auf dem primären Server folgende Abfrage aus: SELECT * FROM pg_stat_replication; Erscheint hier ein Eintrag mit dem Standby-Server und dem Status streaming, ist die Replikation aktiv und funktioniert korrekt.

Einen Failover-Manager installieren und einrichten

Installieren Sie nun einen Failover-Manager, der den Gesundheitszustand der Knoten überwacht und im Fehlerfall automatisch einen Standby zum neuen Primary befördert. Für PostgreSQL haben sich insbesondere Patroni und repmgr in der Praxis bewährt. Das folgende Beispiel orientiert sich an Patroni, da es eine weit verbreitete und gut dokumentierte Lösung darstellt.

Patroni und etcd installieren

  1. Installieren Sie etcd als Distributed Configuration Store auf allen Knoten oder auf separaten etcd-Knoten: apt install etcd (Debian/Ubuntu) oder das entsprechende Paket Ihrer Distribution.
  2. Installieren Sie Patroni auf allen Datenbankknoten: pip install patroni[etcd]
  3. Erstellen Sie auf jedem Knoten eine Patroni-Konfigurationsdatei (z. B. /etc/patroni/patroni.yml) mit den Angaben zum Cluster-Namen, den etcd-Endpunkten sowie den PostgreSQL-Verbindungsparametern.

Patroni-Konfigurationsdatei befüllen

Definieren Sie in der YAML-Datei mindestens die folgenden Schlüsselabschnitte:

  • scope: Name des Clusters (z. B. pg-cluster)
  • etcd: Hosts der etcd-Endpunkte
  • postgresql: Datenbankverzeichnis, Verbindungsparameter und Authentifizierungsdaten
  • bootstrap: Initialkonfiguration für den ersten Start des Clusters

Starten Sie Patroni auf allen Knoten mit systemctl start patroni und überprüfen Sie den Cluster-Status mit patronictl -c /etc/patroni/patroni.yml list. Sie sollten einen Knoten als Leader und die übrigen als Replica sehen. Damit ist die PostgreSQL-Failover-Konfiguration grundlegend abgeschlossen. Weiterführende Informationen zu Hochverfügbarkeits-Setups finden Sie in unserem PostgreSQL Kompetenz-Center.

Automatisches Failover testen und validieren

Testen Sie das Failover-Verhalten unter kontrollierten Bedingungen, bevor Sie das Setup produktiv einsetzen. Nur ein getestetes System gibt Ihnen die Sicherheit, dass es im Ernstfall zuverlässig reagiert.

  1. Öffnen Sie auf einem separaten Terminal eine kontinuierliche Datenbankverbindung oder eine Monitoring-Abfrage, um die Verfügbarkeit zu beobachten: watch -n 1 "psql -h virtuelle-ip -U postgres -c 'SELECT now();'"
  2. Stoppen Sie den primären Datenbankknoten hart: systemctl stop patroni oder simulieren Sie einen Netzwerkausfall mit iptables.
  3. Beobachten Sie, wie Patroni innerhalb der konfigurierten TTL (Time-to-Live, Standard ca. 30 Sekunden) den Ausfall erkennt und einen Standby zum neuen Leader befördert.
  4. Überprüfen Sie den neuen Cluster-Status: patronictl -c /etc/patroni/patroni.yml list
  5. Bringen Sie den ausgefallenen Knoten wieder online und stellen Sie sicher, dass er automatisch als Replica dem neuen Leader folgt.

Nach einem erfolgreichen Test sollten Sie die Failover-Zeit protokollieren und mit Ihren Verfügbarkeitsanforderungen abgleichen. Wenn die Umschaltung länger dauert als erwartet, passen Sie die Parameter ttl, loop_wait und retry_timeout in der Patroni-Konfiguration an. Für Umgebungen mit sehr strengen RTO-Anforderungen empfiehlt sich der Einsatz von synchroner Replikation, die Sie über den Parameter synchronous_mode: true in Patroni aktivieren können.

Häufige Failover-Probleme beheben

Beheben Sie auftretende Probleme systematisch, indem Sie zunächst die Logs der beteiligten Komponenten prüfen. Die häufigsten Ursachen für ein nicht funktionierendes automatisches Failover lassen sich auf einige wiederkehrende Muster zurückführen.

Patroni startet nicht oder erkennt keinen Leader

  • etcd nicht erreichbar: Überprüfen Sie, ob alle etcd-Knoten laufen und der Port 2379 zwischen den Hosts geöffnet ist.
  • Falsche Konfigurationsdatei: Validieren Sie die YAML-Syntax mit python3 -c "import yaml; yaml.safe_load(open('/etc/patroni/patroni.yml'))"
  • Systemzeit-Abweichung: Stellen Sie sicher, dass NTP auf allen Knoten aktiv ist und die Uhren synchron laufen.

Failover findet nicht automatisch statt

  • Prüfen Sie, ob der ttl-Wert in der Patroni-Konfiguration zu hoch gesetzt ist. Ein typischer Wert liegt zwischen 30 und 60 Sekunden.
  • Vergewissern Sie sich, dass der Patroni-Dienst auf allen Knoten als systemd-Unit aktiv und auf automatischen Neustart konfiguriert ist.
  • Kontrollieren Sie, ob ein Split-Brain-Schutzmechanismus (DCS-Quorum) aktiv ist und ob die Mehrheit der etcd-Knoten erreichbar ist.

Clients verbinden sich nach dem Failover nicht neu

  • Stellen Sie sicher, dass die virtuelle IP-Adresse oder der Load-Balancer korrekt auf den neuen Primary umgestellt wird. HAProxy kann über die Patroni-REST-API (/primary und /replica Endpunkte) den aktuellen Leader ermitteln.
  • Überprüfen Sie die Connection-Pool-Einstellungen Ihrer Anwendung: Ein zu langer connect_timeout kann dazu führen, dass Clients hängen bleiben, anstatt sich neu zu verbinden.
  • Erwägen Sie den Einsatz von PgBouncer als Connection-Pooler, der Verbindungen transparent puffern und nach einem Failover neu aufbauen kann.

Dokumentieren Sie jeden Testlauf und jedes reale Failover-Ereignis sorgfältig. Diese Protokolle helfen Ihnen, Muster zu erkennen und die Konfiguration kontinuierlich zu verbessern. Regelmäßige Failover-Tests, mindestens vierteljährlich, stellen sicher, dass Ihr Setup auch nach System-Updates und Konfigurationsänderungen zuverlässig funktioniert. Informationen zu weiterführenden Support-Optionen für PostgreSQL finden Sie in unserem Serviceportfolio.

Wie credativ® bei PostgreSQL-Hochverfügbarkeit unterstützt

Die Einrichtung eines produktionsreifen automatischen Failovers für PostgreSQL® erfordert tiefes technisches Know-how, sorgfältige Planung und regelmäßige Validierung. Genau hier setzen wir an: credativ® begleitet Sie mit unserem PostgreSQL® Kompetenz-Center durch den gesamten Prozess, von der initialen Architekturplanung bis zum laufenden Betrieb.

Konkret unterstützen wir Sie mit folgenden Leistungen:

  • Hochverfügbarkeitsarchitektur: Wir analysieren Ihre Anforderungen und empfehlen die passende HA-Lösung, ob Patroni, repmgr oder eine andere bewährte Technologie.
  • Cluster- und Replikationskonfiguration: Unsere Spezialisten richten Streaming-Replikation, Failover-Manager und virtuelle IPs fachgerecht ein und dokumentieren das Setup vollständig.
  • Monitoring-Umgebungen: Wir implementieren maßgeschneiderte Monitoring-Lösungen, die Ihnen jederzeit Transparenz über den Zustand Ihres Clusters geben.
  • Failover-Tests und Validierung: Wir führen kontrollierte Failover-Tests durch und stellen sicher, dass Ihre RTO- und RPO-Ziele eingehalten werden.
  • 24/7 Support: Unser Open Source Support Center steht Ihnen rund um die Uhr mit direktem Zugang zu PostgreSQL-Spezialisten zur Verfügung, ohne Callcenter, ohne Umwege.
  • Schulungen und Workshops: Wir befähigen Ihr Team, das Setup eigenständig zu verstehen, zu überwachen und im Bedarfsfall einzugreifen.

Möchten Sie Ihre PostgreSQL-Umgebung auf ein zuverlässiges Hochverfügbarkeits-Setup umstellen oder Ihr bestehendes Setup überprüfen lassen? Kontaktieren Sie uns und sprechen Sie direkt mit unseren Experten.

Transparenzhinweis: PostgreSQL® ist eine Marke der PostgreSQL Community Association of California. credativ® ist Competence Center für PostgreSQL®. Die Nennung dient ausschließlich der sachlichen Beschreibung von Dienstleistungen von credativ®. Es besteht keine darüber hinausgehende geschäftliche Verbindung zu den genannten Markeninhabern.

Ähnliche Artikel

Kategorien: credativ® Inside

über den Autor

Peter Dreuw

Head of Sales & Marketing

zur Person

Peter Dreuw arbeitet seit 2016 für die credativ GmbH und ist seit 2017 Teamleiter. Seit 2021 ist er Teil des Management-Teams als VP Services der Instaclustr. Mit der Übernahme durch die NetApp wurde seine neue Rolle "Senior Manager Open Source Professional Services". Im Rahmen der Ausgründung wurde er Mitglied der Geschäftsleitung als Prokurist. Sein Aufgabenfeld ist die Leitung des Vertriebs und des Marketings. Er ist Linux-Nutzer der ersten Stunden und betreibt Linux-Systeme seit Kernel 0.97. Trotz umfangreicher Erfahrung im operativen Bereich ist er leidenschaftlicher Softwareentwickler und kennt sich auch mit hardwarenahen Systemen gut aus.

Beiträge ansehen


Beitrag teilen: