
| Kategorien: | credativ® Inside |
|---|
Die Streaming Replication gehört zu den zuverlässigsten Methoden, um PostgreSQL® für den produktiven Einsatz hochverfügbar zu machen. Sie überträgt Write-Ahead-Log-Daten (WAL) in Echtzeit vom Primary-Server auf einen oder mehrere Replica-Server und sorgt so dafür, dass im Fehlerfall ein aktueller Standby bereitsteht. Diese Anleitung führt Sie Schritt für Schritt durch die vollständige Einrichtung einer PostgreSQL Streaming Replication, vom ersten Handgriff auf dem Primary bis zur Statusprüfung auf dem Replica.
Die beschriebene Konfiguration eignet sich für PostgreSQL® 14 und neuere Versionen. Kleinere Unterschiede in Pfaden oder Parameternamen zwischen Versionen sind möglich, das grundlegende Vorgehen bleibt jedoch identisch.
Bevor Sie mit der eigentlichen Konfiguration beginnen, stellen Sie sicher, dass Ihre Umgebung die folgenden Anforderungen erfüllt. Eine saubere Ausgangssituation erspart Ihnen später aufwendige Fehlersuche.
Prüfen Sie außerdem, ob Firewallregeln den PostgreSQL®-Standardport 5432 zwischen den beiden Servern freigeben. Ist das nicht der Fall, passen Sie die Regeln entsprechend an, bevor Sie weitermachen.
Auf dem Primary-Server nehmen Sie zwei zentrale Konfigurationsdateien in den Blick: postgresql.conf und pg_hba.conf. Erstere steuert das Verhalten des Servers, letztere regelt den Zugriff.
Öffnen Sie postgresql.conf (üblicherweise unter /etc/postgresql/<version>/main/ oder /var/lib/pgsql/<version>/data/) und setzen Sie die folgenden Parameter:
wal_level = replica, damit PostgreSQL® alle für die Replikation notwendigen WAL-Informationen schreibt.max_wal_senders = 3 (oder mehr, wenn Sie mehrere Replicas planen), um gleichzeitige Replikationsverbindungen zu erlauben.wal_keep_size = 64 (in MB), damit der Primary genügend WAL-Segmente vorhält, falls der Replica kurzzeitig nicht erreichbar ist.listen_addresses = '*' gesetzt ist, damit der Server Verbindungen von außen annimmt.Legen Sie in PostgreSQL® einen dedizierten Replikationsbenutzer an, der ausschließlich für die Streaming-Verbindung verwendet wird:
postgres-Benutzer an und öffnen Sie psql.CREATE ROLE replicator WITH REPLICATION LOGIN PASSWORD 'sicheres_passwort'; aus.pg_hba.conf eine neue Zeile ein, die dem Replica-Server Zugriff gewährt: host replication replicator replica_ip/32 scram-sha-256systemctl restart postgresqlNach dem Neustart sollte der Primary auf dem konfigurierten Port lauschen und Replikationsverbindungen akzeptieren. Überprüfen Sie das mit ss -tlnp | grep 5432.
Mit einer funktionierenden Primary-Konfiguration können Sie jetzt den Replica-Server initialisieren. Das Werkzeug pg_basebackup erstellt eine konsistente Kopie des gesamten Datenbank-Clusters und legt gleichzeitig die nötigen Konfigurationsdateien an.
systemctl stop postgresqlrm -rf /var/lib/postgresql/<version>/main/*pg_basebackup als postgres-Benutzer aus:pg_basebackup -h primary_ip -U replicator -D /var/lib/postgresql/<version>/main/ -P -Xs -R
Der Parameter -R ist entscheidend: Er erstellt automatisch eine standby.signal-Datei und trägt die Verbindungsparameter in postgresql.auto.conf ein. Nach Abschluss des Befehls ist das Datenverzeichnis des Replicas eine vollständige Kopie des Primärservers, bereit für den Standby-Betrieb. Der Fortschritt wird während des Vorgangs angezeigt, bei großen Datenmengen kann dies einige Minuten dauern.
Starten Sie nun PostgreSQL® auf dem Replica-Server und vergewissern Sie sich, dass die Streaming-Verbindung zum Primary aufgebaut wird.
systemctl start postgresqlSELECT client_addr, state, sent_lsn, write_lsn, flush_lsn, replay_lsn FROM pg_stat_replication;
Erscheint hier eine Zeile mit dem Status streaming, ist die PostgreSQL Streaming Replication erfolgreich eingerichtet. Auf dem Replica können Sie den Standby-Status zusätzlich mit SELECT pg_is_in_recovery(); bestätigen, was t (true) zurückgeben sollte. Damit ist Ihr PostgreSQL Primary-Replica-Setup einsatzbereit.
Auch bei sorgfältiger Vorbereitung können beim Einrichten der Replikation Schwierigkeiten auftreten. Die folgenden Punkte decken die häufigsten Stolpersteine ab und zeigen, wie Sie diese beheben.
Wenn pg_basebackup oder der Replica keine Verbindung zum Primary aufbauen kann, prüfen Sie folgende Punkte:
pg_hba.conf korrekt und wurde PostgreSQL® danach neu geladen (SELECT pg_reload_conf();)?pg_hba.conf mit der tatsächlichen Adresse überein?Ein zu großer Replikationsrückstand (Replication Lag) deutet oft auf Netzwerkprobleme oder eine zu niedrig angesetzte wal_keep_size hin. Erhöhen Sie den Wert schrittweise und beobachten Sie pg_stat_replication auf dem Primary. Fällt der Replica so weit zurück, dass benötigte WAL-Segmente nicht mehr vorhanden sind, müssen Sie pg_basebackup erneut ausführen. Für Umgebungen, in denen längere Ausfallzeiten des Replicas möglich sind, empfiehlt sich der Einsatz von Replication Slots, die WAL-Segmente so lange aufbewahren, bis der Replica sie verarbeitet hat.
Fehlt die Datei standby.signal im Datenverzeichnis des Replicas, startet PostgreSQL® als eigenständiger Primary und nicht als Standby. Prüfen Sie, ob die Datei vorhanden ist. Falls nicht, legen Sie sie manuell an (touch standby.signal) und starten Sie den Dienst erneut. Stellen Sie außerdem sicher, dass primary_conninfo in postgresql.auto.conf die korrekten Verbindungsparameter enthält.
Die Einrichtung einer Streaming Replication ist ein guter erster Schritt, aber eine produktionsreife PostgreSQL-Hochverfügbarkeit umfasst mehr: Monitoring, automatisches Failover, Backup-Strategien und laufende Optimierung. Genau hier setzt das PostgreSQL® Kompetenz-Center von credativ® an.
Wir begleiten Sie über den gesamten PostgreSQL®-Lebenszyklus und bieten konkrete Unterstützung in folgenden Bereichen:
Möchten Sie Ihre PostgreSQL®-Umgebung auf eine solide, hochverfügbare Basis stellen? Kontaktieren Sie uns und wir besprechen gemeinsam, welche Lösung am besten zu Ihrer Infrastruktur passt.
Transparenzhinweis: PostgreSQL® ist eine Marke der PostgreSQL Community Association of Canada. 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.
| Kategorien: | credativ® Inside |
|---|
über den Autor
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.
Sie müssen den Inhalt von reCAPTCHA laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie sehen gerade einen Platzhalterinhalt von Brevo. Um auf den eigentlichen Inhalt zuzugreifen, klicken Sie auf die Schaltfläche unten. Bitte beachten Sie, dass dabei Daten an Drittanbieter weitergegeben werden.
Mehr InformationenSie müssen den Inhalt von reCAPTCHA laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie müssen den Inhalt von Turnstile laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie müssen den Inhalt von reCAPTCHA laden, um das Formular abzuschicken. Bitte beachten Sie, dass dabei Daten mit Drittanbietern ausgetauscht werden.
Mehr InformationenSie sehen gerade einen Platzhalterinhalt von Turnstile. Um auf den eigentlichen Inhalt zuzugreifen, klicken Sie auf die Schaltfläche unten. Bitte beachten Sie, dass dabei Daten an Drittanbieter weitergegeben werden.
Mehr Informationen