barman backup#

概要#

backup
    [ --bwlimit KBPS ]
    [ { -h | --help } ]
    [ --incremental BACKUP_ID ]
    [ --immediate-checkpoint ]
    [ { -j | --jobs } PARALLEL_WORKERS ]
    [ --jobs-start-batch-period PERIOD ]
    [ --jobs-start-batch-size SIZE ]
    [ --keepalive-interval SECONDS ]
    [ --manifest ]
    [ --name NAME ]
    [ --no-immediate-checkpoint ]
    [ --no-manifest ]
    [ --no-retry ]
    [ --retry-sleep SECONDS ]
    [ --retry-times NUMBER ]
    [ --reuse-backup { off | copy | link } ]
    [ { --wait | -w } ]
    [ --wait-timeout SECONDS ]
    SERVER_NAME [ SERVER_NAME ... ]

説明#

PostreSQLサーバーのバックアップを実行します。 Barmanは、グローバル構成ファイルとサーバー構成ファイルで指定されたパラメーターを使用します。 Barmanノードで構成されているすべてのサーバーからバックアップを実行するには、サーバー名の代わりに all ショートカットを指定します。複数のサーバー名を順番に指定して、特定のサーバーのバックアップを実行することもできます。

パラメーター#

SERVER_NAME

barmanノードのサーバーの名前。

--bwlimit

最大転送速度をキロバイト/秒で指定します。値0は制限がないことを示します。この設定は、 bandwidth_limit 構成オプションをオーバーライドします。

-h / --help

ヘルプメッセージを表示して終了します。コマンドの使用法に関する情報を提供します。

--incremental

ブロックレベルのインクリメンタル バックアップを実行します。 BACKUP_ID または以前のバックアップへのショートカットを提供する必要があります。これは、インクリメンタルバックアップの親バックアップとして機能します。

注釈

バックアップと親バックアップには backup_method=postgres が必要です。

--immediate-checkpoint

初期チェックポイントをできるだけ早く実行させ、構成ファイルの immediate_checkpoint パラメーターに設定された値をオーバーライドします。

-j / --jobs

バックアップ中にファイルのコピーに使用するパラレルワーカーの数を指定します。この設定は、構成ファイルで指定されている場合、 parallel_jobs パラメーターをオーバーライドします。

--jobs-start-batch-period

ジョブの単一のバッチを開始する時間を秒単位で指定します。この値は、構成ファイルで設定されている場合、 parallel_jobs_start_batch_period パラメーターをオーバーライドします。デフォルトは 1 秒です。

--jobs-start-batch-size

単一のバッチで開始するパラレルワーカーの最大数を指定します。この値は、構成ファイルで定義されている場合、 parallel_jobs_start_batch_size パラメーターをオーバーライドします。デフォルトは 10 ワーカーです。

--keepalive-interval

サーバーにハートビートクエリを送信して、Rsyncバックアップ中にlibpq接続をアクティブに保つ間隔を秒単位で指定します。デフォルトは 60 秒です。 0 の値はハートビートを無効にします。

--manifest

バックアップの完了時に、バックアップマニフェストファイルの作成を強制します。構成ファイルから autogenerate_manifest パラメーターをオーバーライドします。 rsyncバックアップ戦略にのみ適用されます。

--name

barmanコマンドでバックアップIDの代わりに使用できるこのバックアップのフレンドリ名を指定します。

--no-immediate-checkpoint

構成ファイルの immediate_checkpoint パラメーターに設定された値をオーバーライドして、チェックポイントが実行されるまでバックアップを強制的に待機します。

--no-manifest

バックアップの完了時に、バックアップマニフェストファイルの自動作成を無効にします。この設定は、構成ファイルの autogenerate_manifest パラメーターをオーバーライドし、rsyncバックアップストラテジーにのみ適用されます。

--no-retry

エラーが発生した場合の再試行はありません。 --retry-times 0 の設定と同じです。

--retry-sleep

コピーが失敗した後、再試行するまでに待機する秒数を指定します。この設定は、バックアップとリカバリー操作の両方に適用され、構成ファイルで定義されている場合 basebackup_retry_sleep パラメーターをオーバーライドします。

--retry-times

エラーが発生した場合に、ベースバックアップコピーを再試行する回数を指定します。これは、バックアップとリカバリー操作の両方に適用され、構成ファイルで設定されている場合 basebackup_retry_times パラメーターをオーバーライドします。

--reuse-backup

構成ファイルで構成された reuse_backup オプションの動作をオーバーライドします。可能な値は次のとおりです。

  • off 最後の使用可能なバックアップを再利用しません。

  • copy サーバーの最後に利用可能なバックアップを再利用し、変更されていないファイルのコピーを作成しますバックアップ時間を削減します。

  • link デフォルト サーバーの最後に利用可能なバックアップを再利用し、変更されていないファイルへのハードリンクを作成しますバックアップ時間と領域の両方を節約します。

注釈

これは、最後に使用可能なバックアップが backup_method=rsync で実行された場合にのみ効果があります。

--wait / -w

ベースバックアップに必要なすべてのWALファイルがアーカイブされるまで待ちます。

--wait-timeout

タイムアウトになる前に、必要なWALファイルがアーカイブされるのを待機する時間を秒単位で指定します。