From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 4B32171BCB for ; Fri, 13 May 2022 15:40:12 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 417942580 for ; Fri, 13 May 2022 15:39:42 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id 73C50255F for ; Fri, 13 May 2022 15:39:40 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 4915F434F8 for ; Fri, 13 May 2022 15:39:40 +0200 (CEST) From: Dominik Csapak To: pbs-devel@lists.proxmox.com Date: Fri, 13 May 2022 15:39:38 +0200 Message-Id: <20220513133939.3845808-3-d.csapak@proxmox.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220513133939.3845808-1-d.csapak@proxmox.com> References: <20220513133939.3845808-1-d.csapak@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.119 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record T_SCC_BODY_TEXT_LINE -0.01 - Subject: [pbs-devel] [PATCH proxmox-backup 3/4] docs: tape/restore: mention single snapshot restore X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 May 2022 13:40:12 -0000 what it is, how to use it and the caveats Signed-off-by: Dominik Csapak --- docs/tape-backup.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst index fa0172a0..0eb32412 100644 --- a/docs/tape-backup.rst +++ b/docs/tape-backup.rst @@ -831,6 +831,29 @@ data disk (datastore): # proxmox-tape restore 9da37a55-aac7-4deb-91c6-482b3b675f30 mystore +Single Snapshot Restore +^^^^^^^^^^^^^^^^^^^^^^^ + +Sometimes it is not necessary to restore a whole media-set, but only some +specific snapshots from the tape. This can be achieved with the ``snapshots`` +parameter: + + +.. code-block:: console + + // proxmox-tape restore [] + + # proxmox-tape restore 9da37a55-aac7-4deb-91c6-482b3b675f30 mystore sourcestore:host/hostname/2022-01-01T00:01:00Z + +This first restores the snapshot to a temporary location, then restores the relevant +chunk archives, and finally restores the snapshot data to the target datastore. + +The ``snapshot`` parameter can be given multiple times, so one can restore +multiple snapshots with one restore action. + +.. NOTE:: When using the single snapshot restore, the tape must be traversed + more than once, which, if you restore many snapshots at once, can take longer + than restoring the whole datastore. Update Inventory ~~~~~~~~~~~~~~~~ -- 2.30.2