General commands

Barmanには多くのコマンドがあり、説明のために、スコープ別に整理できます。

一般的なコマンド の範囲はBarmanサーバー全体であり、多くのPostgreSQLサーバーをバックアップできます。代わりに、 サーバーコマンド は、指定されたサーバーでのみ動作します。 バックアップコマンド は、特定のサーバーから取得されたバックアップで動作します。

次のリストには、一般的なコマンドが含まれています。

cron

barman には、長時間実行されるデーモンまたはサービスファイルが含まれていません(systemctl start 、service start などには何もありません)。代わりに、 barman のバックグラウンド「定常状態」バックアップ操作を実行するbarman cron サブコマンドが提供されています。

cron コマンドを使用して、WALファイルとバックアップの両方でメンテナンス操作を実行できます。

barman cron

注釈

このコマンドは、cronスクリプトで実行する必要があります。 barman cron を毎分実行するようにスケジュールすることをお勧めします。 rpmまたはdebianパッケージを使用してBarmanをインストールした場合、毎分実行される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レポートを作成します。このレポートには、構成されているすべてのサーバーの情報が含まれています。

重要

診断がJSONで記述され、その形式が機械可読であると考えられている場合でも、その構造はインターフェースの一部とは見なされません。フォーマットは、異なるBarmanバージョン間で変更できます。

list-servers

次のコマンドを使用して、バックアップシステム用に構成されたアクティブサーバーのリストを表示できます。

barman list-servers

--minimal オプションを使用すると、機械可読出力を取得できます。

barman list-servers --minimal