General commands#
Barmanには多くのコマンドがあり、説明のために、スコープごとにそれらを整理できます。
汎用コマンド のスコープは、多くのPostgreSQLサーバーをバックアップできるBarmanサーバー全体です。代わりに、 サーバーコマンド は、指定されたサーバーでのみ動作します。 バックアップコマンド は、特定のサーバーから取得したバックアップに対して動作します。
次のリストには、一般的なコマンドが含まれています。
cron#
barman には、長時間実行デーモンまたはサービスファイルは含まれません
systemctl start 、service start などには何もありません。
代わりに、 barman cron サブコマンドは、 barman
のバックグラウンドでの定常状態のバックアップ操作を実行するために提供されています。
cron
コマンドを使用して、WALファイルとバックアップの両方でメンテナンス操作を実行できます。
barman cron
注釈
このコマンドは、 cronスクリプトで実行する必要があります。 barman cron を1分ごとに実行するようにスケジュールすることをお勧めします。 rpmまたはdebianパッケージを使用してBarmanをインストールした場合、1分ごとに実行されるcronエントリが作成されます。
barman cron
は、サーバーベースでWALアーカイブ操作を同時に実行し、これにより、次のサーバーに保持ポリシーも適用されます。
retention_policyは空でなく有効ではありません。retention_policy_modeをautoに設定します。
cron コマンドは、 receive-wal
コマンドを透過的に実行することにより、要求したサーバーでWALストリーミングが開始されるようにします。
cron コマンドによって開始された操作を停止するには、
cronエントリをコメントアウトして実行します。
barman receive-wal --stop SERVER_NAME
barman list-servers
をチェックして、すべてのサーバーを取得していることを確認することができます。
注釈
barman cron は、バックグラウンドでのメンテナンスタスクのみを実行し、スケジュールされたバックアップの実行は行いません。必要な定期的にスケジュールされたバックアップジョブは、たとえば barman backup all を実行する別のcronエントリで、別途スケジュールする必要があります。
diagnose#
diagnose
コマンドは、診断とサポートの目的で役立つJSONレポートを作成します。このレポートには、構成されているすべてのサーバーの情報が含まれています。
注釈
Barman 3.10.0 以降、オプションでコマンドに`--show-config-source` 引数を指定できます。その場合、 BarmanおよびBarmanサーバーの構成オプションごとに、出力には構成値だけでなく、有効な値を提供する構成ファイルも含まれます。
重要
診断がJSONで書かれ、その形式が機械可読であると考えられる場合でも、その構造はインターフェイスの一部とみなされません。フォーマットは、異なるBarmanバージョン間で変更される場合があります。
list-servers#
次の使用を使用して、バックアップシステム用に構成されたアクティブサーバーのリストを表示できます。
barman list-servers
--minimal オプションを使用して、機械可読出力を取得できます。
barman list-servers --minimal