General commands
================

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

**汎用コマンド**
のスコープは、多くのPostgreSQLサーバーをバックアップできるBarmanサーバー全体です。代わりに、
**サーバーコマンド** は、指定されたサーバーでのみ動作します。
**バックアップコマンド**
は、特定のサーバーから取得したバックアップに対して動作します。

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

cron
----

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

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

.. code:: bash

   barman cron

..  NOTE::
   このコマンドは、 cronスクリプトで実行する必要があります。 `barman cron` を1分ごとに実行するようにスケジュールすることをお勧めします。 rpmまたはdebianパッケージを使用してBarmanをインストールした場合、1分ごとに実行されるcronエントリが作成されます。

``barman cron``
は、サーバーベースでWALアーカイブ操作を同時に実行し、これにより、次のサーバーに保持ポリシーも適用されます。

-  ``retention_policy`` は空でなく有効ではありません。

-  ``retention_policy_mode`` を\ ``auto`` に設定します。

``cron`` コマンドは、 ``receive-wal``
コマンドを透過的に実行することにより、要求したサーバーでWALストリーミングが開始されるようにします。

``cron`` コマンドによって開始された操作を停止するには、
cronエントリをコメントアウトして実行します。

.. code:: bash

   barman receive-wal --stop SERVER_NAME

``barman list-servers``
をチェックして、すべてのサーバーを取得していることを確認することができます。

..  NOTE::
   `barman cron` は、バックグラウンドでのメンテナンスタスクのみを実行し、スケジュールされたバックアップの実行は行いません。必要な定期的にスケジュールされたバックアップジョブは、たとえば `barman backup all` を実行する別のcronエントリで、別途スケジュールする必要があります。

diagnose
--------

``diagnose``
コマンドは、診断とサポートの目的で役立つJSONレポートを作成します。このレポートには、構成されているすべてのサーバーの情報が含まれています。

..  NOTE::
   Barman `3.10.0` 以降、オプションでコマンドに`--show-config-source` 引数を指定できます。その場合、 BarmanおよびBarmanサーバーの構成オプションごとに、出力には構成値だけでなく、有効な値を提供する構成ファイルも含まれます。

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

list-servers
------------

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

.. code:: bash

   barman list-servers

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

.. code:: bash

   barman list-servers --minimal