From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9]) by lore.proxmox.com (Postfix) with ESMTPS id CEA5B1FF13B for ; Wed, 22 Apr 2026 15:40:45 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id B843620B12; Wed, 22 Apr 2026 15:40:45 +0200 (CEST) From: Hannes Laimer To: pbs-devel@lists.proxmox.com Subject: [PATCH proxmox-backup v8 08/13] docs: add section on moving namespaces and groups Date: Wed, 22 Apr 2026 15:39:46 +0200 Message-ID: <20260422133951.192862-9-h.laimer@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260422133951.192862-1-h.laimer@proxmox.com> References: <20260422133951.192862-1-h.laimer@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1776865123448 X-SPAM-LEVEL: Spam detection results: 0 AWL 0.081 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy 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 Message-ID-Hash: Q7MRZ75LF34XZNJ2CLFRD2H22ZULWNSK X-Message-ID-Hash: Q7MRZ75LF34XZNJ2CLFRD2H22ZULWNSK X-MailFrom: h.laimer@proxmox.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.10 Precedence: list List-Id: Proxmox Backup Server development discussion List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Document the move-group and move-namespace operations including merge behavior, max-depth and delete-source parameters. Add an online help anchor so the UI move dialogs can link directly to this section. Signed-off-by: Hannes Laimer --- docs/storage.rst | 60 ++++++++++++++++++++++++++++++++++++++++++- www/OnlineHelpInfo.js | 4 +++ 2 files changed, 63 insertions(+), 1 deletion(-) diff --git a/docs/storage.rst b/docs/storage.rst index 672091f8..1f6eabe8 100644 --- a/docs/storage.rst +++ b/docs/storage.rst @@ -527,7 +527,65 @@ For backup groups, the existing privilege rules still apply. You either need a privileged enough permission or to be the owner of the backup group; nothing changed here. -.. todo:: continue +.. _storage_move_namespaces_groups: + +Moving Namespaces and Groups +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Backup groups can be moved between namespaces within the same datastore. +This is useful for reorganizing backup hierarchies without having to +re-run backups. + +A single group can be moved with ``move-group``. To relocate an entire +namespace subtree (including all child namespaces and their groups), use +``move-namespace``. + +.. code-block:: console + + # proxmox-backup-manager datastore move-group --ns --target-ns --backup-type --backup-id + # proxmox-backup-manager datastore move-namespace --ns --target-ns + +If the target namespace already exists, groups are moved into it. When a +group with the same type and ID already exists in the target and +``merge-groups`` is enabled, the snapshots are merged into the existing +group provided: + +- both groups have the same owner +- the oldest source snapshot is newer than the newest target snapshot + +Groups that cannot be merged or locked are skipped and reported in the +task log. They remain at the source and can be retried individually with +``move-group``. + +.. note:: + + With defaults, ``move-namespace`` merges into existing target groups + (``merge-groups=true``) and removes source namespaces once they are empty + (``delete-source=true``). Pass ``--merge-groups false`` or + ``--delete-source false`` to opt out. + +Optional parameters for ``move-namespace``: + +``merge-groups`` + Allow merging snapshots into groups that already exist in the target + namespace with the same type and ID. Defaults to true. + +``max-depth`` + Limits how many levels of child namespaces below the source are + included. When not set, the entire subtree is moved. + +``delete-source`` + Controls whether the source namespace directories are removed after + all groups have been moved out. Defaults to true. Set to false to + keep the (now empty) source namespace structure. + +Required privileges: + +- ``move-group``: ``DATASTORE_PRUNE`` on the source namespace and + ``DATASTORE_BACKUP`` on the target namespace, plus ownership of the + backup group; or ``DATASTORE_MODIFY`` on both. +- ``move-namespace``: ``DATASTORE_MODIFY`` on the parent of both the + source and the target namespace. Options diff --git a/www/OnlineHelpInfo.js b/www/OnlineHelpInfo.js index 89650cfb..e118b0ad 100644 --- a/www/OnlineHelpInfo.js +++ b/www/OnlineHelpInfo.js @@ -299,6 +299,10 @@ const proxmoxOnlineHelpInfo = { "link": "/docs/storage.html#storage-namespaces", "title": "Backup Namespaces" }, + "storage-move-namespaces-groups": { + "link": "/docs/storage.html#storage-move-namespaces-groups", + "title": "Moving Namespaces and Groups" + }, "datastore-tuning-options": { "link": "/docs/storage.html#datastore-tuning-options", "title": "Tuning" -- 2.47.3