From: Dominik Csapak <d.csapak@proxmox.com>
To: pbs-devel@lists.proxmox.com
Subject: [pbs-devel] [PATCH proxmox-backup 4/4] docs: tape: add information about namespaces
Date: Fri, 13 May 2022 15:39:39 +0200 [thread overview]
Message-ID: <20220513133939.3845808-4-d.csapak@proxmox.com> (raw)
In-Reply-To: <20220513133939.3845808-1-d.csapak@proxmox.com>
which are backed up, how to use the new parameters and how to map
them during restore
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
docs/tape-backup.rst | 44 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 44 insertions(+)
diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst
index 0eb32412..8888dacb 100644
--- a/docs/tape-backup.rst
+++ b/docs/tape-backup.rst
@@ -681,6 +681,16 @@ To remove a job, please use:
# proxmox-tape backup-job remove job2
+By default, all (recursive) namespaces of the datastore are included in a tape
+backup. You can specify a single namespace wth ``ns`` and a depth with
+``max-depth``. For example:
+
+.. code-block:: console
+
+ # proxmox-tape backup-job update job2 --ns mynamespace --max-depth 3
+
+If no `max-depth` is given, it will include all recursive namespaces.
+
.. image:: images/screenshots/pbs-gui-tape-backup-jobs-add.png
:align: right
:alt: Tape Backup: Add a backup job
@@ -797,6 +807,16 @@ The following options are available:
media set into import-export slots. The operator can then pick up
those tapes and move them to a media vault.
+--ns The namespace to backup.
+
+ If you only want to backup a specific namespace. If omitted, the root
+ namespaces is assumed.
+
+--max-depth The depth to recurse namespaces.
+
+ ``0`` means no recursion at all (only the given namespace). If omitted,
+ all namespaces are recursed (below the the given one).
+
Restore from Tape
~~~~~~~~~~~~~~~~~
@@ -855,6 +875,30 @@ multiple snapshots with one restore action.
more than once, which, if you restore many snapshots at once, can take longer
than restoring the whole datastore.
+Namespaces
+^^^^^^^^^^
+
+It is also possible to select and map specific namespaces from a media-set
+during a restore. This is possible with the ``namespaces`` parameter.
+The format of the parameter is
+
+.. code-block:: console
+
+ store=<source-datastore>[,source=<source-ns>][,target=<target-ns>][,max-depth=<depth>]
+
+If ``source`` or ``target`` is not given, the root namespace is assumed.
+When no ``max-depth`` is given, the source namespace will be fully recursed.
+
+An example restore command:
+
+.. code-block:: console
+
+ # proxmox-tape restore 9da37a55-aac7-4deb-91c6-482b3b675f30 mystore --namespaces store=sourcedatastore,source=ns1,target=ns2,max-depth=2
+
+The parameter can be given multiple times. It can also be combined with the
+``snapshots`` parameter to only restore those snapshots and map them to different
+namespaces.
+
Update Inventory
~~~~~~~~~~~~~~~~
--
2.30.2
next prev parent reply other threads:[~2022-05-13 13:40 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-05-13 13:39 [pbs-devel] [PATCH proxmox-backup 1/4] cli: proxmox-tape: fix ns/depth parameter Dominik Csapak
2022-05-13 13:39 ` [pbs-devel] [PATCH proxmox-backup 2/4] docs: tape: remove note about global content namespace Dominik Csapak
2022-05-13 13:39 ` [pbs-devel] [PATCH proxmox-backup 3/4] docs: tape/restore: mention single snapshot restore Dominik Csapak
2022-05-13 13:39 ` Dominik Csapak [this message]
2022-05-13 13:59 ` [pbs-devel] applied-series: [PATCH proxmox-backup 1/4] cli: proxmox-tape: fix ns/depth parameter Thomas Lamprecht
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220513133939.3845808-4-d.csapak@proxmox.com \
--to=d.csapak@proxmox.com \
--cc=pbs-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox