Startbefehl (start)
start.Wurden pgBackRest-Prozesse zuvor mit dem Befehl stop gestoppt, kann ihre Ausführung mit dem Befehl start wieder zugelassen werden. Dabei werden keine pgBackRest-Prozesse unmittelbar gestartet; sie dürfen lediglich wieder ausgeführt werden. Weitere Informationen und Beispiele finden Sie unter Starten und Stoppen
.
Allgemeine Optionen
Option zur Ausführung als root (--allow-root)
Die Ausführung des Befehls als Benutzer root erlauben.
Standardmäßig darf nur der Befehl restore als Benutzer root ausgeführt werden, da er die Dateieigentümer sorgfältig verwaltet. Bei anderen Befehlen besteht das Risiko, dass Dateien entstehen, die root gehören, etwa im Repository. Diese sind für den PostgreSQL-Benutzer nicht zugänglich, sodass spätere Befehle fehlschlagen.
Diese Option aktivieren, um einen Befehl dennoch als root auszuführen. Es ist jedoch deutlich besser, pgBackRest als den Benutzer auszuführen, dem das Repository und der PostgreSQL-Cluster gehören.
Option für die Konfigurationsdatei (--config)
pgBackRest-Konfigurationsdatei.
Mit dieser Option eine andere als die standardmäßige Konfigurationsdatei angeben.
Option für den Pfad zusätzlicher Konfigurationsdateien (--config-include-path)
Pfad zu zusätzlichen pgBackRest-Konfigurationsdateien.
Konfigurationsdateien mit der Endung .conf am angegebenen Speicherort werden mit der pgBackRest-Konfigurationsdatei zu einer einzigen Konfigurationsdatei zusammengefügt.
Option für den Konfigurationspfad (--config-path)
Basispfad der pgBackRest-Konfigurationsdateien.
Diese Einstellung überschreibt den standardmäßigen Basispfad der Optionen --config und --config-include-path, sofern diese nicht ausdrücklich in der Befehlszeile gesetzt werden.
Wird beispielsweise nur --config-path=/conf/pgbackrest angegeben, erhält --config den Standardwert /conf/pgbackrest/pgbackrest.conf und --config-include-path den Standardwert /conf/pgbackrest/conf.d.
Option für den Sperrdateipfad (--lock-path)
Pfad zum Speichern der Sperrdateien.
In diesem Pfad erstellt pgBackRest Sperrdateien, um die gleichzeitige Ausführung miteinander in Konflikt stehender Operationen zu verhindern.
Option für eine neutrale umask (--neutral-umask)
Eine neutrale umask verwenden.
Setzt die umask auf 0000, damit die Zugriffsrechte im Repository sinnvoll gesetzt werden. Standardmäßig erhalten Verzeichnisse den Modus 0750 und Dateien den Modus 0640.
Um stattdessen die umask des ausführenden Benutzers zu verwenden, neutral-umask=n in der Konfigurationsdatei oder --no-neutral-umask in der Befehlszeile angeben.
Option für die Prozesspriorität (--priority)
Prozesspriorität festlegen.
Legt fest, welche Priorität (also welcher nice-Wert) dem Prozess vom Kernel-Scheduler zugewiesen wird. Positive Werte verringern die Priorität, negative Werte erhöhen sie. In den meisten Fällen dürfen Prozesse ihre Priorität nicht erhöhen.
Option für die Stanza (--stanza)
Definiert die Stanza.
Eine Stanza ist die Konfiguration eines PostgreSQL-Datenbankclusters. Sie legt unter anderem dessen Speicherort, das Backup-Verfahren und die Archivierungsoptionen fest. Die meisten Datenbankserver haben nur einen PostgreSQL-Datenbankcluster und daher nur eine Stanza. Backup-Server haben dagegen für jeden zu sichernden Datenbankcluster eine Stanza.
Es liegt nahe, die Stanza nach dem Primärcluster zu benennen. Ein besserer Name beschreibt jedoch die im Cluster enthaltenen Datenbanken. Da der Stanza-Name für den Primärserver und alle Replikate verwendet wird, sollte er die tatsächliche Funktion des Clusters beschreiben, etwa app oder dw, statt den lokalen Clusternamen wie main oder prod zu übernehmen.
Protokollierungsoptionen
Option für die Protokollierungsstufe der Konsole (--log-level-console)
Protokollierungsstufe für die Konsole.
Die folgenden Protokollierungsstufen werden unterstützt:
off- Keine Protokollierung (nicht empfohlen)error- Nur Fehler protokollierenwarn- Warnungen und Fehler protokolliereninfo- Informationen, Warnungen und Fehler protokollierendetail- Details, Informationen, Warnungen und Fehler protokollierendebug- Debug-Meldungen, Details, Informationen, Warnungen und Fehler protokollierentrace- Trace-Meldungen (sehr ausführliche Debug-Ausgaben), Debug-Meldungen, Informationen, Warnungen und Fehler protokollieren
Option für die Protokollierungsstufe der Datei (--log-level-file)
Protokollierungsstufe für die Dateiausgabe.
Die folgenden Protokollierungsstufen werden unterstützt:
off- Keine Protokollierung (nicht empfohlen)error- Nur Fehler protokollierenwarn- Warnungen und Fehler protokolliereninfo- Informationen, Warnungen und Fehler protokollierendetail- Details, Informationen, Warnungen und Fehler protokollierendebug- Debug-Meldungen, Details, Informationen, Warnungen und Fehler protokollierentrace- Trace-Meldungen (sehr ausführliche Debug-Ausgaben), Debug-Meldungen, Informationen, Warnungen und Fehler protokollieren
Option für die Protokollierungsstufe der Standardfehlerausgabe (--log-level-stderr)
Protokollierungsstufe für stderr.
Legt fest, welche Protokollierungsstufen an stderr statt an stdout ausgegeben werden (festgelegt durch log-level-console). Zeitstempel und Prozess werden nicht an stderr ausgegeben.
Die folgenden Protokollierungsstufen werden unterstützt:
off- Keine Protokollierung (nicht empfohlen)error- Nur Fehler protokollierenwarn- Warnungen und Fehler protokolliereninfo- Informationen, Warnungen und Fehler protokollierendetail- Details, Informationen, Warnungen und Fehler protokollierendebug- Debug-Meldungen, Details, Informationen, Warnungen und Fehler protokollierentrace- Trace-Meldungen (sehr ausführliche Debug-Ausgaben), Debug-Meldungen, Informationen, Warnungen und Fehler protokollieren
Option für den Protokollpfad (--log-path)
Pfad, an dem Protokolldateien gespeichert werden.
In diesem Pfad speichert pgBackRest seine Protokolldateien. Bei log-level-file=off ist kein Protokollpfad erforderlich.
Option für Zeitstempel im Protokoll (--log-timestamp)
Zeitstempel in der Protokollierung aktivieren.
Aktiviert Zeitstempel in der Konsolen- und Dateiprotokollierung. Diese Option wird in besonderen Situationen deaktiviert, etwa beim Erzeugen der Dokumentation.