vzdump(1)

vzdump - VMとコンテナのバックアップユーティリティ

vzdump ヘルプ

vzdump {<vmid>} [OPTIONS].

バックアップを作成します。

Proxmox VEは、各ストレージおよび各ゲストシステムタイプの機能を使用し、完全に統合されたソリューションを提供します。これにより、システム管理者はバックアップの一貫性とゲストシステムのダウンタイムをモードオプションで微調整することができます。

Proxmox VEのバックアップは、常にVM/CT設定とすべてのデータを含むフルバックアップです。 バックアップはGUIまたはvzdumpコマンドラインツールから開始できます。

バックアップを実行する前に、バックアップストレージを定義する必要があります。ストレージを追加する方法については、ストレージのドキュメントを参照してください。Proxmox Backup Serverストレージの場合、バックアップは重複排除されたチャンクとメタデータとして保存され、ファイルレベルのストレージの場合、バックアップは通常のファイルとして保存されます。Proxmox Backup Serverは高度な機能を備えているため、専用ホストで使用することをお勧めします。NFSサーバを使用するのも良い方法です。どちらの場合も、バックアップをテープドライブに保存し、オフサイトアーカイブにすることができます。

バックアップジョブは、選択可能なノードとゲストシステムに対して、特定の日時に自動的に実行されるようにスケジュールできます。詳細はバックアップジョブセクションを参照してください。

一貫性（オプションモード）を提供するには、ゲストのタイプによっていくつかの方法があります。

QemuServer用Proxmox VEライブバックアップの技術概要は、こちらをご覧ください。

vzdump の新しいバージョンでは、ゲストの種類とバックアップ時間がファイル名にエンコードされます。

これにより、同じディレクトリに複数のバックアップを保存することができます。さまざまな保持オプションを使用して、保持するバックアップの数を制限できます。

lzo
[Lempel-Ziv-Oberhumer a lossless data compression algorithmhttps://en.wikipedia.org/wiki/Lempel-Ziv-Oberhumer]
,gzip
[gzip - based on DEFLATE algorithmhttps://en.wikipedia.org/wiki/Gzip]
orzstd
[Zstandard a lossless data compression algorithmhttps://en.wikipedia.org/wiki/Zstandard]
.

現在、Zstandard (zstd)はこれら3つのアルゴリズムの中で最速です。 マルチスレッドはlzoとgzipに対するzstdのもう一つの利点です。Lzo と gzip はより広く使われており、しばしばデフォルトでインストールされます。

pigz
[pigz - parallel implementation of gziphttps://zlib.net/pigz/]
をインストールすることで、gzip の代替となり、マルチスレッドによるパフォーマンスが向上します。pigz と zstd では、スレッド数/コア数を調整できます。以下の設定オプションを参照してください。

バックアップファイル名の拡張子から、どの圧縮アルゴリズムでバックアップが作成されたかを判断できます。

バックアップファイル名が上記のファイル拡張子のいずれかで終わっていない場合、vzdumpによって圧縮されていません。

Proxmox Backup Serverストレージでは、オプションでバックアップのクライアント側暗号化を設定できます。

手動でバックアップをトリガーする以外に、すべての仮想ゲストまたは選択した仮想ゲストをストレージにバックアップする定期的なジョブを設定することもできます。ジョブは UI のDatacenter→Backupで管理するか、/cluster/backupAPI エンドポイント経由で管理できます。どちらも、/etc/pve/jobs.cfg にジョブエントリを生成し、pveschedulerデーモンによって解析および実行されます。

ジョブは全てのクラスタノードまたは特定のノードに対して設定され、指定されたスケジュールに従って実行されます。スケジュールのフォーマットはsystemd のカレンダーイベントによく似ています。UI のScheduleフィールドは自由に編集することができ、ドロップダウンリストには開始点として使える例がいくつかあります。

ストレージやノードの設定より優先されるジョブ固有の保持オプションや、バックアップと一緒に保存される追加情報のメモのテンプレートを設定できます。

スケジュールされたバックアップは、スケジュールされた時間中にホストがオフラインであったり、pveschedulerが無効であったりした場合に実行を逃すため、遅れを取り戻すための動作を設定することが可能です。Repeat missedオプション（UIのAdvancedタブ、configのrepeat-missed）を有効にすると、見逃したジョブをできるだけ早く実行するようスケジューラに指示できます。

バックアップのパフォーマンスを調整するための設定がいくつかあります（そのうちのいくつかはUIのAdvancedタブで公開されています）。最も注目すべきは、IO帯域幅を制限するためのbwlimitです。さらに、ionice（BFQスケジューラ使用時）、パフォーマンス設定の一部として、max-workers（VMバックアップにのみ影響）、pbs-entries-max（コンテナバックアップにのみ影響）があります。詳細は設定オプションを参照してください。

prune-backupsオプションを使用すると、柔軟な方法で保持するバックアップを指定できます。

以下の保持オプションがあります：

保持オプションは上記の順序で処理されます。各オプションは、その期間内のバックアップのみを対象とします。次のオプションでは、すでにカバーされているバックアップは処理されません。古いバックアップのみを考慮します。

使用したい保持オプションを、カンマ区切りのリストで指定します：

prune-backupsを直接vzdumpに渡すこともできますが、ストレージレベルで設定した方が賢明な場合が多く、ウェブインターフェイスから行うことができます。

バックアップを保護マークして削除できないようにすることができます。Proxmox VE の UI、CLI、または API を使用して保護されたバックアップを削除しようとすると、失敗します。ただし、これはProxmox VEによって強制されるものであり、ファイルシステムによって強制されるものではないため、バックアップファイル自体を手動で削除することは、基礎となるバックアップストレージへの書き込みアクセス権を持っている人であれば誰でも可能です。

ファイルシステムベースのストレージの場合、保護はセンチネルファイル<backup-name>.protectedを介して実装されます。Proxmox Backup Serverの場合は、サーバ側で処理されます(Proxmox Backup Serverバージョン2.1から使用可能)。

ストレージオプションのmax-protected-backupsを使用して、ゲストごとにストレージで許可される保護バックアップの数を制御します。無制限には-1 を使用します。デフォルトは、Datastore.Allocate権限を持つユーザは無制限、その他のユーザは5です。

UIのEdit NotesボタンまたはストレージコンテンツAPIを使用して、バックアップにノートを追加できます。

バックアップジョブや手動バックアップのノートを動的に生成するためのテンプレートを指定することもできます。テンプレート文字列には、2つの中括弧で囲まれた変数を含めることができ、バックアップの実行時に対応する値に置き換えられます。

現在サポートされているのは

APIやCLIで指定する場合は、1行で指定し、改行とバックスラッシュはそれぞれリテラル ∕∕∕∕としてエスケープする必要があります。

バックアップアーカイブは、Proxmox VEのWeb GUIまたは以下のCLIツールからリストアできます：

詳細は各マニュアルページをご覧ください。

グローバル設定は/etc/vzdump.confに保存されます。このファイルでは、コロンで区切られた単純なキー/値形式を使用します。各行の書式は次のとおりです：

ファイル内の空白行は無視され、#文字で始まる行はコメントとして扱われ、これも無視されます。このファイルの値はデフォルトとして使用され、コマンドラインで上書きすることができます。

現在、以下のオプションをサポートしています：

オプション--script でフックスクリプトを指定できます。このスクリプトはバックアップ処理の様々な段階で呼び出され、パラメータが適宜設定されます。ドキュメンテーションディレクトリに例があります（vzdump-hook-script.pl）。

vzdumpはデフォルトで以下のファイルをスキップします（--stdexcludes 0オプションで無効にできます）。

手動で（追加の）除外パスを指定することもできます：

は、/tmp/ディレクトリと、/var/foo、/var/foobarといった名前のファイルやディレクトリを除外します。

で始まらないパスは、コンテナのルートにアンカーされません。たとえば

は、/bar、/var/bar、/var/foo/bar などのファイルやディレクトリを除外しますが、/bar2 は除外しません。

設定ファイルもバックアップアーカイブ内（./etc/vzdump/内）に保存され、正しくリストアされます。

単にゲスト777をダンプします - スナップショットはなく、デフォルトのダンプディレクトリ(通常は/var/lib/vz/dump/)にゲストのプライベート領域と設定ファイルをアーカイブするだけです。

rsyncとサスペンド/レジュームを使ってスナップショットを作成します（ダウンタイムは最小限）。

すべてのゲストシステムをバックアップし、rootとadminに通知メールを送信します。mailtoが設定され、notification-modeがデフォルトでautoに設定されているため、通知メールは通知システムの代わりにシステムのsendmailコマンドで送信されます。

スナップショットモード（ダウンタイムなし）とデフォルト以外のダンプディレクトリを使用します。

複数のゲストのバックアップ（選択的）

101と102を除く全ゲストをバックアップ

コンテナを新しいCT 600にリストア

VM 601へのQemuServer VMのリストア

パイプを使用して、既存のコンテナ101を、4GBのルートファイルシステムを持つ新しいコンテナ300にクローンします。

著作権 © 2007-2022 Proxmox Server Solutions GmbH

このプログラムはフリー・ソフトウェアです。あなたは、Free Software Foundationによって発行されたGNU Affero General Public Licenseのバージョン3、またはそれ以降のバージョンのいずれかに従って、このプログラムを再配布したり、変更したりすることができます。

このプログラムは有用であることを期待して配布されていますが、商品性や特定の目的への適合性についての暗黙の保証もなく、いかなる保証もありません。詳細はGNU Affero General Public Licenseをご覧ください。

あなたはこのプログラムとともにGNU Affero General Public Licenseのコピーを受け取っているはずです。 そうでない場合は、https://www.gnu.org/licenses/をご覧ください。